Configuration

All of Navix's configuration lives in shared/config.lua. This file stays editable even on escrow-protected builds (it is listed in escrow_ignore, just like shared/utils.lua).

Main options

Option	Default	Description
Config.Debug	false	Enables debug logs in the console.
Config.PhoneName	'lb-phone'	Phone resource name.
Config.AppName	'Navix'	App display name. Internal identifier — do not change after deployment.
Config.AppDescription	'GPS Navigation & Traffic Alerts'	Description shown in the App Store.
Config.Developer	'Lo Scripts'	Developer name shown in the phone.
Config.Icon	flaticon URL	App icon (URL).
Config.ThemeColor	"FF33CCFF"	UI theme color (blue).
Config.MaxFavorites	20	Maximum favorites per player.
Config.MaxRecentSearches	10	Number of recent searches kept.

Alert durations

Config.AlertDurations sets the lifetime of each alert type (in seconds):

Config.AlertDurations = {
    traffic  = 1800,    -- 30 minutes
    accident = 3600,    -- 1 hour
    police   = 900,     -- 15 minutes
    hazard   = 1800,    -- 30 minutes
    roadwork = 86400,   -- 24 hours
    closure  = 86400,   -- 24 hours
}

The 6 types are declared in Config.AlertTypes (traffic, accident, police, hazard, roadwork, closure). Each type has its own icon (Config.AlertIcons) and color (Config.AlertColors).

Cooldown and confirmations

Option	Default	Description
Config.AlertCooldown	300	Delay (s) between two alerts of the same type for the same player — i.e. 5 minutes.
Config.ConfirmationsForBoost	3	Number of confirmations needed to extend the duration.
Config.BoostDuration	600	Time (s) added at each confirmation tier — i.e. +10 minutes.

NOTE

The cooldown is applied per alert type: it prevents spam while still letting a player report several incidents of different kinds.

View distance

Option	Default	Description
Config.AlertViewDistance	5000	Radius (m) within which a player sees alerts — i.e. 5 km.
Config.AlertConfirmDistance	200	Maximum distance (m) to be able to confirm an alert.

Favorites

Option	Default	Description
Config.MaxFavorites	20	Maximum favorite locations per player (customizable icons and colors).
Config.MaxRecentSearches	10	Search history kept.

Quick locations

Config.QuickLocations lists the predefined locations offered in search. Each entry has a name and coordinates:

Config.QuickLocations = {
    {name = "Central Hospital", coords = {x = 311.4,   y = -592.5,  z = 43.3}},
    {name = "LSPD Station",     coords = {x = 428.0,   y = -984.0,  z = 30.7}},
    {name = "LS Airport",       coords = {x = -1037.0, y = -2737.0, z = 20.2}},
    {name = "Legion Square",    coords = {x = 195.0,   y = -934.0,  z = 30.7}},
    {name = "Maze Bank Tower",  coords = {x = -75.0,   y = -818.0,  z = 326.2}},
    {name = "Vinewood Sign",    coords = {x = 711.0,   y = 1198.0,  z = 348.5}},
    {name = "Vespucci Beach",   coords = {x = -1600.0, y = -1018.0, z = 13.0}},
    {name = "Mount Chiliad",    coords = {x = 501.0,   y = 5604.0,  z = 797.9}},
}

TIP

Adapt this list to your map (MLOs, major RP spots…): add, remove or edit entries freely.

Theme color

Config.ThemeColor = "FF33CCFF"   -- blue, hexadecimal format

The color is applied to the interface accent.

Staff groups

Config.StaffGroups lists the groups allowed to delete any alert (regular players can only remove their own):

Config.StaffGroups = {'owner', 'admin', 'superadmin', 'god'}

Languages

Navix ships with 25 language files in locales/*.json:

ar, ba, cs, de, dk, en, es, fr, hu, it, ja, ko, nl, no, pl, pt-br, pt-pt, ro, ru, sl, sv, th, tr, ua, zh-cn.

The locales/*.json files are declared in fxmanifest.lua and stay editable: modify or add translations as needed.

Tips

TIP

• Do not change Config.AppName after deployment: it acts as the internal identifier in lb-phone.
• Adjust Config.AlertDurations and Config.AlertCooldown to match your desired RP pace.
• Lower Config.AlertViewDistance on high-population servers to lighten blip rendering.
• Enable Config.Debug only during development: it prints callbacks, queries and errors to the console.