HZ Scripts

Installation

Étape 1 — Téléchargement

Après votre achat sur hzscripts.com/shop, votre compte FiveM Keymaster reçoit l'asset.

  1. Connectez-vous sur keymaster.fivem.net (ou portal.cfx.re/assets)
  2. Allez dans Granted Assets
  3. Téléchargez HZ-AudioMixer
Important : utilisez le même compte FiveM que celui lié à votre licence Tebex. Le script est protégé par escrow et nécessite une licence valide.

Étape 2 — Dépendances

Aucune. HZ-AudioMixer est une ressource purement standalone.
  • Aucun framework requis — fonctionne sur QBCore, QBox, ESX, Standalone, vMenu, vanilla
  • Aucun SQL — les réglages sont sauvegardes côté client via FiveM KVP
  • Pas besoin de hz_lib
  • Aucune ressource complémentaire

Étape 3 — Installation

  1. Extrayez l'archive téléchargée
  2. Placez le dossier hz_audiomixer dans votre répertoire resources/[standalone]/
  3. Ajoutez la ligne dans votre server.cfg :
ensure hz_audiomixer
  1. Redémarrez votre serveur

Étape 4 — Vérification

Les joueurs devraient voir cette ligne dans leur console F8 après avoir spawn :

[hz_audiomixer] Scene active

Puis appuyez sur F7 en jeu — l'interface du mixeur devrait s'ouvrir avec 9 curseurs.

Structure des dossiers

hz_audiomixer/
├── fxmanifest.lua
├── client.lua             ← chiffre par Asset Escrow
├── config/
│   └── config.lua         ← modifiable
├── shared/
│   └── locale.lua         ← modifiable
├── locales/
│   ├── en.lua  fr.lua  de.lua  es.lua  it.lua  pt.lua  nl.lua
│   ├── pl.lua  ru.lua  tr.lua  ja.lua  ko.lua  zh.lua  ar.lua
│   └── ...                ← modifiable, ajoutez les votres
├── audioconfig/
│   ├── _nt_core_mx.dat15.rel       ← donnees audio compilees
│   └── _nt_core_gm.dat151.rel
└── html/
    └── index.html         ← modifiable, personnalisez librement

Fichiers modifiables (escrow_ignore) — config/, shared/, locales/, html/ restent lisibles pour que vous puissiez les personnaliser. Seul client.lua (la logique du moteur audio) est chiffre.

Dépannage

WARN: Scene non active dans la console F8

La scène audio ne s'est pas activée. Cela signifie généralement que les fichiers dat15.rel / dat151.rel n'ont pas été chargés correctement. Vérifiez :

  1. Le dossier audioconfig/ est présent dans la ressource
  2. data_file 'AUDIO_DYNAMIXDATA' et data_file 'AUDIO_GAMEDATA' sont dans le fxmanifest.lua
  3. La ressource démarre après le chargement des fichiers audio — redémarrez le serveur complètement (redémarrage complet, pas juste restart hz-audiomixer lors de la première installation)

Les joueurs n'ont pas de son après le spawn

Si tous les sons sont coupes au premier spawn :

  1. Redémarrez la ressource une fois pour effacer le KVP si nécessaire (la boucle agressive de 15s au spawn réapplique les valeurs)
  2. Vérifiez qu'un joueur appuie sur F7 pour confirmer que les curseurs ne sont pas tous à 0%

F7 n'ouvre pas le mixeur

  • Ouvrez le menu des raccourcis FiveM (Menu Pause > Paramètres > Raccourcis > FiveM)
  • Cherchez "Mixer Audio" — réassignez si F7 entre en conflit avec une autre ressource

Étape suivante