HZ Scripts

Installation

Etape 1 — Telechargement

Apres votre achat sur hzscripts.com/shop, votre compte FiveM Keymaster recoit l'asset.

  1. Connectez-vous sur keymaster.fivem.net (ou portal.cfx.re/assets)
  2. Allez dans Granted Assets
  3. Telechargez HZ-AudioMixer
Important : utilisez le meme compte FiveM que celui lie a votre licence Tebex. Le script est protege par escrow et necessite une licence valide.

Etape 2 — Dependances

Aucune. HZ-AudioMixer est une ressource purement standalone.
  • Aucun framework requis — fonctionne sur QBCore, QBox, ESX, Standalone, vMenu, vanilla
  • Aucun SQL — les reglages sont sauvegardes cote client via FiveM KVP
  • Pas besoin de HZ-Bridge
  • Aucune ressource complementaire

Etape 3 — Installation

  1. Extrayez l'archive telechargee
  2. Placez le dossier HZ-AudioMixer dans votre repertoire resources/[standalone]/
  3. Ajoutez la ligne dans votre server.cfg :
ensure HZ-AudioMixer
  1. Redemarrez votre serveur

Etape 4 — Verification

Les joueurs devraient voir cette ligne dans leur console F8 apres 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.

Depannage

WARN: Scene non active dans la console F8

La scene audio ne s'est pas activee. Cela signifie generalement que les fichiers dat15.rel / dat151.rel n'ont pas ete charges correctement. Verifiez :

  1. Le dossier audioconfig/ est present dans la ressource
  2. data_file 'AUDIO_DYNAMIXDATA' et data_file 'AUDIO_GAMEDATA' sont dans le fxmanifest.lua
  3. La ressource demarre apres le chargement des fichiers audio — redemarrez le serveur completement (redemarrage complet, pas juste restart hz-audiomixer lors de la premiere installation)

Les joueurs n'ont pas de son apres le spawn

Si tous les sons sont coupes au premier spawn :

  1. Redemarrez la ressource une fois pour effacer le KVP si necessaire (la boucle agressive de 15s au spawn reapplique les valeurs)
  2. Verifiez qu'un joueur appuie sur F7 pour confirmer que les curseurs ne sont pas tous a 0%

F7 n'ouvre pas le mixeur

  • Ouvrez le menu des raccourcis FiveM (Menu Pause > Parametres > Raccourcis > FiveM)
  • Cherchez "Mixer Audio" — reassignez si F7 entre en conflit avec une autre ressource

Etape suivante