HZ Scripts

Configuration

Tous les réglages se trouvent dans config/config.lua. Le fichier est en dehors d'Asset Escrow — entièrement 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,
}

Référence des paramètres

Config.Locale

Langue de l'interface. Valeurs validés :

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

Déposez un nouveau fichier dans locales/<code>.lua pour ajouter des traductions personnalisées. Utilisez n'importe quelle locale existante comme modèle.

Config.OpenKey

Touche par défaut pour ouvrir le mixeur. Les joueurs peuvent la modifier dans le menu pause de FiveM (Paramètres → Raccourcis). Les valeurs valides suivent le format RegisterKeyMapping de FiveM — courantes : F1–F12, lettres, pavé numérique, etc.

Config.OpenCommand

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

Config.DefaultVolume

Volume applique à toutes les catégories lors de la première connexion (quand aucune valeur sauvegardee n'existe). Plage 0–100 (précision 1%).

  • 100 = volume max — recommande
  • 0 = muet au premier lancement (déconseille sauf si vous voulez un silence par défaut)

Config.Categories

Mettez n'importe quelle entrée à false pour masquer cette catégorie de l'interface du mixeur. Le curseur n'apparaîtra pas, et le patch de scène 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 dépannage. Laissez false en production.

Personnalisation de l'interface

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

Thème couleur

Éditez les variables CSS en haut du <style> :

:root {
  --cyan: #00d4ff;        /* accent principal */
  --cyan-dark: #00a8cc;
  --red: #ff2d55;         /* danger / muet */
  --green: #00ff88;        /* point de statut */
  --bg-2: rgba(10, 14, 22, 0.96);   /* fond du panneau */
  --text: #e8eef5;
}

Disposition & sections

Les catégories sont regroupées en 4 sections logiques (Action, Environnement, Personnes, Audio). Éditez le tableau GROUPS dans le JS inline :

var GROUPS = [
  { key: 'sectionAction', ids: ['weapons', 'vehicles'] },
  { key: 'sectionEnv',    ids: ['ambience', 'weather'] },
  { key: 'sectionPeople', ids: ['speech', 'peds'] },
  { key: 'sectionAudio',  ids: ['scripted', 'music', 'radio'] }
]

Ajoutez/supprimez/reordonnez librement — les noms de sections proviennent du fichier de locale sous les clés ui_section_*.

Ajouter une langue personnalisée

  1. Copiez locales/en.lua → locales/<votre_code>.lua
  2. Traduisez les valeurs (les clés doivent rester les mêmes)
  3. Définissez Config.Locale = '<votre_code>'
  4. Redémarrez la ressource
-- locales/myloc.lua
return {
    ['ui_title']        = 'Mon Mixeur',
    ['ui_section_action']        = 'Action',
    -- ... (voir en.lua pour la liste complete)
    ['cat_weapons']         = 'Armes',
    ['cat_weapons_desc']    = 'Armes a feu, explosions',
    -- ...
}

Étape suivante