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.

14 clés sont aussi dans /hzpanel. Config.Locale, Config.LowPerformanceMode, Config.Brand, Config.ServerName, Config.DiscordURL, Config.ShopURL, Config.Accent et les clés de Config.Hud sauf Custom se règlent aussi dans le panel hz_lib, rubrique Menu Pause. config.lua s'applique tant qu'aucune valeur n'est enregistrée dans le panneau. Une valeur enregistrée dans le panneau l'emporte sur config.lua et s'applique en direct, et son bouton de réinitialisation ramène la clé à config.lua (avec hz_lib 1.2.1 ou plus récent). Avant HZ-PauseMenu 1.2.1, les valeurs par défaut du panneau l'emportaient sur config.lua pour ces clés même sans rien d'enregistré : mettez donc à jour hz_pausemenu et hz_lib en 1.2.1. Avec hz_lib, Config.Locale doit valoir en, fr ou es, les trois langues que propose le panneau : toute autre valeur retombe sur en.

Général

Clé	Défaut	Description
`Config.Locale`	`'en'`	Langue de l'UI. `en`, `fr`, `es` sont livrés ; ajoutez-en dans `locales/`. Avec hz_lib, utilisez `en`, `fr` ou `es`.
`Config.Debug`	`false`	Affiche dans la console les erreurs de chargement des fichiers de langue.
`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`	`true`	`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.Brand`	`"No\\|Trace"`	Texte du logo en haut au centre. La partie avant `\\|` prend la couleur du thème. `""` le masque.
`Config.ServerName`	`""`	Texte à côté de l'icone Discord. Vide = "Rejoindre le Discord" localise.
`Config.DiscordURL`	`"https://discord.me/hzscript"`	Invitation Discord ouverte par le bouton. Remplacez-la par la vôtre.
`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"`	Teinte de secours du menu Paramètres natif de GTA V, utilisée seulement tant qu'aucun thème hz_lib n'est reçu. Le menu lui-même prend ses couleurs du thème hz_lib, et la teinte native aussi dès que le thème est chargé.
`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.