Configuration

Toute la configuration de Navix se trouve dans shared/config.lua. Ce fichier reste éditable même sur les builds protégés par escrow (il est listé dans escrow_ignore, tout comme shared/utils.lua).

Options principales

Option	Défaut	Description
Config.Debug	false	Active les logs de débogage en console.
Config.PhoneName	'lb-phone'	Nom de la ressource téléphone.
Config.AppName	'Navix'	Nom affiché de l'application. Identifiant interne — ne pas changer après déploiement.
Config.AppDescription	'GPS Navigation & Traffic Alerts'	Description affichée dans l'App Store.
Config.Developer	'Lo Scripts'	Nom du développeur affiché dans le téléphone.
Config.Icon	URL flaticon	Icône de l'application (URL).
Config.ThemeColor	"FF33CCFF"	Couleur du thème de l'UI (bleu).
Config.MaxFavorites	20	Nombre maximal de favoris par joueur.
Config.MaxRecentSearches	10	Nombre de recherches récentes conservées.

Durées d'alertes

Config.AlertDurations définit la durée de vie de chaque type d'alerte (en secondes) :

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

Les 6 types sont déclarés dans Config.AlertTypes (traffic, accident, police, hazard, roadwork, closure). Chaque type possède son icône (Config.AlertIcons) et sa couleur (Config.AlertColors).

Cooldown et confirmations

Option	Défaut	Description
Config.AlertCooldown	300	Délai (s) entre deux alertes du même type pour un même joueur — soit 5 minutes.
Config.ConfirmationsForBoost	3	Nombre de confirmations nécessaires pour prolonger la durée.
Config.BoostDuration	600	Temps (s) ajouté à chaque palier de confirmations — soit +10 minutes.

NOTE

Le cooldown est appliqué par type d'alerte : il empêche le spam tout en autorisant un joueur à signaler plusieurs incidents de natures différentes.

Distance d'affichage

Option	Défaut	Description
Config.AlertViewDistance	5000	Rayon (m) dans lequel un joueur voit les alertes — soit 5 km.
Config.AlertConfirmDistance	200	Distance maximale (m) pour pouvoir confirmer une alerte.

Favoris

Option	Défaut	Description
Config.MaxFavorites	20	Lieux favoris maximum par joueur (icônes et couleurs personnalisables).
Config.MaxRecentSearches	10	Historique de recherches conservé.

Lieux rapides

Config.QuickLocations liste les lieux prédéfinis proposés dans la recherche. Chaque entrée possède un nom et des coordonnées :

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

Adaptez cette liste à votre map (MLO, lieux RP majeurs…) : ajoutez, retirez ou modifiez les entrées librement.

Couleur du thème

Config.ThemeColor = "FF33CCFF"   -- bleu, au format hexadécimal

La couleur s'applique à l'accentuation de l'interface.

Groupes staff

Config.StaffGroups liste les groupes autorisés à supprimer n'importe quelle alerte (les joueurs ordinaires ne peuvent retirer que les leurs) :

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

Langues

Navix est livré avec 25 fichiers de langue dans 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.

Les fichiers locales/*.json sont déclarés dans fxmanifest.lua et restent éditables : modifiez ou ajoutez des traductions selon vos besoins.

Conseils

TIP

• Ne modifiez pas Config.AppName après déploiement : il sert d'identifiant interne dans lb-phone.
• Ajustez les Config.AlertDurations et Config.AlertCooldown selon le rythme RP souhaité.
• Réduisez Config.AlertViewDistance sur les serveurs à forte densité pour alléger l'affichage des blips.
• Activez Config.Debug uniquement en développement : il affiche callbacks, requêtes et erreurs en console.