HZ Scripts

Instalación

Paso 1 — Descarga

Tras su compra en hzscripts.com/shop, su cuenta FiveM Keymaster recibe el asset.

  1. Inicie sesión en keymaster.fivem.net (o portal.cfx.re/assets)
  2. Vaya a Granted Assets
  3. Descargue HZ-AudioMixer
Importante: utilice la misma cuenta FiveM vinculada a su licencia Tebex. El script esta protegido por escrow y requiere una licencia valida.

Paso 2 — Dependencias

Ninguna. HZ-AudioMixer es un recurso puramente standalone.
  • No se requiere framework — funciona en QBCore, QBox, ESX, Standalone, vMenu, vanilla
  • Sin SQL — los ajustes se guardan del lado del cliente vía FiveM KVP
  • No necesita hz_lib
  • Sin recursos complementarios

Paso 3 — Instalación

  1. Extraiga el archivo descargado
  2. Coloque la carpeta hz_audiomixer en su directorio resources/[standalone]/
  3. Agregue la línea en su server.cfg:
ensure hz_audiomixer
  1. Reinicie su servidor

Paso 4 — Verificación

Los jugadores deberían ver esta línea en su consola F8 después de aparecer:

[hz_audiomixer] Scene active

Luego presione F7 en el juego — la interfaz del mezclador debería abrirse con 9 controles deslizantes.

Estructura de carpetas

hz_audiomixer/
├── fxmanifest.lua
├── client.lua             ← cifrado por Asset Escrow
├── config/
│   └── config.lua         ← modificable
├── shared/
│   └── locale.lua         ← modificable
├── 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
│   └── ...                ← modificable, agregue los suyos
├── audioconfig/
│   ├── _nt_core_mx.dat15.rel       ← datos de audio compilados
│   └── _nt_core_gm.dat151.rel
└── html/
    └── index.html         ← modificable, personalice libremente

Archivos modificables (escrow_ignore) — config/, shared/, locales/, html/ permanecen legibles para que pueda personalizarlos. Solo client.lua (la lógica del motor de audio) está cifrado.

Solución de problemas

WARN: Scene non active en la consola F8

La escena de audio no se activo. Esto generalmente significa que los archivos dat15.rel / dat151.rel no se cargaron correctamente. Verifique:

  1. La carpeta audioconfig/ está presente en el recurso
  2. data_file 'AUDIO_DYNAMIXDATA' y data_file 'AUDIO_GAMEDATA' están en el fxmanifest.lua
  3. El recurso se inicia después de la carga de archivos de audio — reinicie el servidor completamente (reinicio completo, no solo restart hz-audiomixer durante la primera instalación)

Los jugadores no tienen sonido después de aparecer

Si todos los sonidos están silenciados en el primer spawn:

  1. Reinicie el recurso una vez para borrar el KVP si es necesario (el bucle agresivo de 15s al aparecer reaplicara los valores)
  2. Verifique que un jugador presione F7 para confirmar que los controles deslizantes no están todos en 0%

F7 no abre el mezclador

  • Abra el menú de atajos de FiveM (Menú Pausa > Ajustes > Atajos > FiveM)
  • Busque "Mixer Audio" — reasigne si F7 entra en conflicto con otro recurso

Paso siguiente