HZ Scripts

Configuration

Tous les reglages se trouvent dans config/config.lua. Le fichier est en dehors d'Asset Escrow — entierement modifiable.

Config = {}


Config.Locale       = 'fr'         -- 14 langues disponibles
Config.Debug        = false        -- Logs dans la console F8



Config.OpenKey      = 'F7'         -- Touche par defaut (modifiable dans le menu pause)
Config.OpenCommand  = 'audiomixer' -- Commande chat



Config.KVPPrefix    = 'hz_amix_'   -- Prefixe de stockage (ne pas modifier apres mise en prod)
Config.DefaultVolume = 100         -- 0-100, 100 = volume max (precision 1%)



Config.Categories = {
    weapons  = true,
    vehicles = true,
    ambience = true,
    weather  = true,
    speech   = true,
    peds     = true,
    scripted = true,
    music    = true,
    radio    = true,
}

Reference des parametres

Config.Locale

Langue de l'interface. Valeurs valides :

en fr de es it pt nl pl ru tr ja ko zh ar

Deposez un nouveau fichier dans locales/.lua pour ajouter des traductions personnalisees. Utilisez n'importe quelle locale existante comme modele.

Config.OpenKey

Touche par defaut pour ouvrir le mixeur. Les joueurs peuvent la modifier dans le menu pause de FiveM (Parametres → Raccourcis). Les valeurs valides suivent le format RegisterKeyMapping de FiveM — courantes : F1–F12, lettres, pave numerique, etc.

Config.OpenCommand

Alias de commande chat. Avec la valeur par defaut audiomixer, les joueurs peuvent taper /audiomixer pour ouvrir le mixeur.

Config.DefaultVolume

Volume applique a toutes les categories lors de la premiere connexion (quand aucune valeur sauvegardee n'existe). Plage 0–100 (precision 1%).

  • 100 = volume max — recommande
  • 0 = muet au premier lancement (deconseille sauf si vous voulez un silence par defaut)

Config.Categories

Mettez n'importe quelle entree a false pour masquer cette categorie de l'interface du mixeur. Le curseur n'apparaitra pas, et le patch de scene audio correspondant ne sera pas applique.

Exemple — masquer le curseur radio :

Config.Categories = {
    weapons  = true,
    vehicles = true,
    ambience = true,
    weather  = true,
    speech   = true,
    peds     = true,
    scripted = true,
    music    = true,
    radio    = false,    -- masque
}

Config.Debug

Active les messages de debug dans la console F8 du client :

[HZ-AudioMixer] Scene active — mixer operational

Utile pour le depannage. Laissez false en production.

Personnalisation de l'interface

Le HTML/CSS se trouve dans html/index.html, en dehors d'Asset Escrow. Vous pouvez entierement le restyler.

Theme couleur

Editez les variables CSS en haut du