Configuration

The main configuration is located in lb-racing/config/config.lua. Track creator props are configured separately in lb-racing/config/props.lua.

Restart lb-racing after changing the configuration.

General

Option	Description
`Config.Debug`	Enables additional debug output. Disable this on a production server unless you are troubleshooting.
`Config.Language`	The locale to use. Locale files are located in `locales/`.
`Config.CurrencyFormat`	Formats monetary values. `%s` is replaced with the amount.
`Config.DatabaseChecker`	Checks the database structure and can automatically apply missing tables or columns.
`Config.Convert`	Imports supported data from a detected racing script. Currently supports `rahe-racing`.
`Config.Framework`	Framework integration. Leave this as `"auto"` for automatic detection.
`Config.HelpTextStyle`	Help text provider: `"default"`, `"ox_lib"`, or `"gta"`.
`Config.NotificationSystem`	Notification provider: `"auto"`, `"ox_lib"`, `"gta"`, `"esx"`, or `"qb"`.
`Config.Units`	Unit system: `"imperial"`, `"metric"`, or `"auto"` to use the player’s GTA setting.

Custom help text, notifications, and unit detection can be implemented in client/custom/functions/functions.lua.

Standalone tablet

Config.Standalone controls the standalone racing tablet.


Config.Standalone.Enabled = "auto" -- true, false, or "auto"
Config.Standalone.RequireItem = "racing_tablet" -- false to disable the item requirement
Config.Standalone.Command = "racingtablet"
Config.Standalone.Bind = "F4"
Config.Standalone.AllowAvatar = true

When Enabled is set to "auto", the standalone tablet is enabled only when neither LB Phone nor LB Tablet is running. Model, Offset, and Rotation control the tablet prop and animation placement.

LB Phone and LB Tablet app

Config.App controls the app installed in LB Phone and LB Tablet.


Config.App.Default = true
Config.App.Name = "LB Racing"
Config.App.Description = "Participate in races and win money."
Config.App.RequireItem = false
Config.App.BlacklistedJobs = {}
Config.App.LBPhone = true
Config.App.LBTablet = true

Set Default to false if another resource should decide when the app is available. You can then use the AddApp and RemoveApp client exports.

HUD

The leaderboard and race statistics panels can be positioned independently with Config.HUD.Leaderboard and Config.HUD.Statistics.

Position accepts "top-left", "top-right", "bottom-left", "bottom-right", "center-left", or "center-right".
Offset moves the panel from the selected position, using percentage values.
Scale changes the UI scale from 0.25 to 1.5.

Race behavior

The most commonly changed race settings are:

Option	Description
`Config.MinParticipants`	Minimum number of participants required to start a race.
`Config.CreateCooldown`	Seconds a player must wait before creating another race. Administrators bypass this.
`Config.AutoJoinCreate`	Automatically signs the creator up for their race.
`Config.DeleteCanceledRaces`	Deletes newly canceled races from the database. This does not affect races canceled before enabling it.
`Config.CalculatePositionsInterval`	How often positions are recalculated, in milliseconds. Lower values update faster but do more work.
`Config.AutoStart`	Seconds before a race starts automatically.
`Config.Countdown`	Race countdown length in seconds.
`Config.ReadyRadius`	Maximum distance from the start at which a participant can ready up.
`Config.RaceBucket`	Places participants in a separate routing bucket while racing.

Config.DNF controls when racers are marked as did not finish after another racer finishes, after disconnecting, or after leaving their vehicle.

Config.NoCollision controls the global collision-free period at the beginning of every race. Duration accepts a number of seconds or true for the entire race.

Config.FlipCar and Config.TPCheckpoint provide optional hold-to-use controls for recovering a vehicle or returning to the previous checkpoint.

Race options and permissions

Permissions are configured in Config.Permissions. Most permission groups support the following fields:

Everyone: allow all players.
Admin: allow players recognized as administrators by the framework integration.
Creator: allow the track or race creator, where applicable.

Config.Permissions.CreateRace.RaceOptions controls which race settings players and administrators can change, as well as their defaults. These include payment method, prize distribution, repeating races, assigned vehicles, commission, ranked races, sign-up requirements, invitations, personal vehicles, collisions, first person, and traffic.

For framework-specific or custom permission logic, edit the appropriate permissions.lua file in the client and server custom framework folders.

Track creator


Config.Creator.Bucket = true
Config.Creator.Vehicle = `tenf2` -- false to disable the creator vehicle
 
Config.Creator.Weather.Freeze = true
Config.Creator.Weather.Type = "EXTRASUNNY"
Config.Creator.Weather.Hour = 12
Config.Creator.Weather.Minute = 0

Bucket isolates players while they create tracks. The weather settings provide consistent visibility in the creator. If your weather resource continues changing the weather or time, follow the weather sync integration guide.

Checkpoints, graphics, and blips

Config.RaceObjects controls checkpoint and barrier collision, visibility, and placement behavior.
Config.Graphics controls join markers, participant boxes, and checkpoint rendering.
Config.Blips.Participants controls racer blips.
Config.Blips.Checkpoints controls current, previous, and upcoming checkpoint blips.
Config.Props.Checkpoint and Config.Props.Barrier in config/props.lua define the props available in the track creator.

Vehicles

Config.BlacklistedVehicleModels prevents specific models from participating.
Config.VehicleTypes defines the available track vehicle types and the GTA vehicle type IDs accepted by each one.
Config.VehicleClasses defines the vehicle groups available when a race assigns vehicles.
Config.VehicleTiers defines the displayed performance tiers and their minimum scores.

The vehicle tier calculation can be customized in client/custom/vehicle.lua in GetVehicleTier.