Configuration
Tout est dans config.lua. Les réglages destines au joueur (graphismes, viseur) sont choisis par chaque joueur en jeu et stockes côté client — les clés ci-dessous ne sont que les valeurs par défaut 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 clés qui pilotent le comportement client sont appliquées sur le client ; avec hz_lib, les surcharges admin sont poussées vers le client en direct.
Général
| Clé | Défaut | Description |
|---|
Config.Locale | 'en' | Langue de l'UI. en, fr, es sont livrés ; ajoutez-en dans locales/. |
Config.Framework | 'auto' | auto détecte es_extended → qbx_core → qb-core → ox_core → vRP → standalone. Ne forcez un nom que si deux cores tournent cote à côté. |
Config.LowPerformanceMode | false | Desactive les transitions/flous de l'UI pour les clients très bas de gamme. |
Config.ClientWait | 300000 | ms pendant lesquelles un client réutilise une recuperation d'infos serveur. Le nombre de joueurs est toujours lu à jour. |
Profil
| Clé | Défaut | Description |
|---|
Config.Mugshot.Enabled | true | Affiche le visage du joueur (pedheadshot GPU → base64) au lieu d'une initiale. Autonome, mis en cache, régénère seulement au changement de ped. |
Config.Mugshot.Transparent | false | true = visage détoure sur le dégrade circulaire ; false = fond studio recadre au cercle. |
Config.Mugshot.PollSeconds | 4 | À quelle fréquence vérifier 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 lancée par la fiche de personnage quand le serveur a du multichar. Laissez "" sans multichar → la carte ouvre l'onglet PROFIL à 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
| Clé | Défaut | Description |
|---|
Config.ServerName | "" | Texte à côté 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 être http(s)://). Vide = l'onglet SHOP est masque. |
Accent et thème
| Clé | Défaut | Description |
|---|
Config.Accent | "#FF6EC7" | Un seul accent, injecte comme variable CSS. Surcharge en direct par la cascade de thème hz_lib quand elle est présente. |
Config.NativeMenuAccent | (table) | Teinte le menu Paramètres natif de GTA V à votre accent. Voir Thème. |
Réglages joueur (défauts)
| Clé | Défaut | Description |
|---|
Config.Graphics.Enabled | true | false masque tout le panneau FPS. |
Config.Graphics.Timecycles | {} | Noms de timecycle proposes dans la liste déroulante. Vide volontairement — GTA n'a qu'un seul slot de timecycle et les scripts météo 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 rangées 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 utilisés à la place. |
Voir Réglages joueur pour savoir comment cela s'affiche en jeu.
Intégration HUD
Config.Hud masque votre HUD pendant que le menu (ou la carte/les paramètres natifs) est ouvert, puis le restaure. Il fonctionne avec n'importe quelle ressource HUD. Référence complète : Intégration HUD.
