Configuration
Tout est dans config.lua. Les reglages destines au joueur (graphismes, viseur) sont choisis par chaque joueur en jeu et stockes cote client — les cles ci-dessous ne sont que les valeurs par defaut au premier lancement et les options de niveau admin.
config.lua est un script partage — il se charge dans les deux VM Lua serveur et client. Les cles qui pilotent le comportement client sont appliquees sur le client ; avec HZ-Bridge, les surcharges admin sont poussees vers le client en direct.
General
| Cle | Defaut | Description |
|---|
Config.Locale | 'en' | Langue de l'UI. en, fr, es sont livres ; ajoutez-en dans locales/. |
Config.Framework | 'auto' | auto detecte es_extended → qbx_core → qb-core → ox_core → vRP → standalone. Ne forcez un nom que si deux cores tournent cote a cote. |
Config.LowPerformanceMode | false | Desactive les transitions/flous de l'UI pour les clients tres bas de gamme. |
Config.ClientWait | 300000 | ms pendant lesquelles un client reutilise une recuperation d'infos serveur. Le nombre de joueurs est toujours lu a jour. |
Profil
| Cle | Defaut | Description |
|---|
Config.Mugshot.Enabled | true | Affiche le visage du joueur (pedheadshot GPU → base64) au lieu d'une initiale. Autonome, mis en cache, regenere seulement au changement de ped. |
Config.Mugshot.Transparent | false | true = visage detoure sur le degrade circulaire ; false = fond studio recadre au cercle. |
Config.Mugshot.PollSeconds | 4 | A quelle frequence verifier un changement de tenue/modele. |
Config.DefaultNationality | 'USA' | Affiche quand le framework n'en porte aucune (ESX de base). Mettez "" pour garder --. |
Config.LogoutCommand | 'logout' | Commande lancee par la fiche de personnage quand le serveur a du multichar. Laissez "" sans multichar → la carte ouvre l'onglet PROFIL a la place (pas de bouton mort). |
Config.CharacterImage | 'images/character.webp' | Image sur la fiche de personnage de l'onglet GAME (sous web/public/). "" retombe sur le logo-texte VICE. |
Branding et boutique
| Cle | Defaut | Description |
|---|
Config.ServerName | "" | Texte a cote de l'icone Discord. Vide = "Rejoindre le Discord" localise. |
Config.DiscordURL | "…" | Invitation Discord ouverte par le bouton. |
Config.ShopURL | "" | L'onglet SHOP ouvre cette URL dans le navigateur du joueur (doit etre http(s)://). Vide = l'onglet SHOP est masque. |
Accent et theme
| Cle | Defaut | Description |
|---|
Config.Accent | "#FF6EC7" | Un seul accent, injecte comme variable CSS. Surcharge en direct par la cascade de theme HZ-Bridge quand elle est presente. |
Config.NativeMenuAccent | (table) | Teinte le menu Parametres natif de GTA V a votre accent. Voir Theme. |
Reglages joueur (defauts)
| Cle | Defaut | Description |
|---|
Config.Graphics.Enabled | true | false masque tout le panneau FPS. |
Config.Graphics.Timecycles | {} | Noms de timecycle proposes dans la liste deroulante. Vide volontairement — GTA n'a qu'un seul slot de timecycle et les scripts meteo se l'approprient. Ne le remplissez que sur un serveur ou rien d'autre ne le pilote. |
Config.CrosshairEnabled | true | false masque tout le panneau Viseur. |
Config.KeybindsEnabled | true | false masque le sous-panneau Raccourcis. |
Config.KeybindLayout | 'qwerty' | qwerty ou azerty — les rangees de lettres physiques sur le clavier. |
Config.Keybinds | (liste) | Liste de raccourcis standalone, "KEY\ | LABEL\ | icon\ | DESC". Si HZ-Loading tourne, ses raccourcis partages sont utilises a la place. |
Voir Reglages joueur pour savoir comment cela s'affiche en jeu.
Integration HUD
Config.Hud masque votre HUD pendant que le menu (ou la carte/les parametres natifs) est ouvert, puis le restaure. Il fonctionne avec n'importe quelle ressource HUD. Reference complete : Integration HUD.