HZ Scripts

Instalación

Paso 1 — Descarga

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

  1. Inicia sesión en keymaster.fivem.net (o portal.cfx.re/assets)
  2. Ve a Granted Assets
  3. Descarga HZ-AudioMixer
Importante: utiliza la misma cuenta FiveM vinculada a tu licencia Tebex. El script está protegido por escrow y requiere una licencia válida.

Paso 2 — Dependencias

hz_lib (gratuito) es la única dependencia. Dibuja el panel del mezclador (kit UI de HZ) y lleva los colores y las fuentes de tu tema. Consulta hz_lib.
  • 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
  • Ningún otro recurso

Paso 3 — Instalación

  1. Extrae el archivo descargado
  2. Coloca la carpeta hz_audiomixer en tu directorio resources/, junto a hz_lib
  3. Añade las dos líneas a tu server.cfg, hz_lib primero:
ensure hz_lib
ensure hz_audiomixer
  1. Reinicia tu servidor

Paso 4 — Verificación

Pulsa F7 en el juego (o escribe /audiomixer): el panel del mezclador se abre a la derecha de la pantalla con 9 controles deslizantes en 4 grupos.

Para comprobar la escena de audio, pon Config.Debug = true. Después de aparecer, la consola F8 muestra entonces:

[HZ-AudioMixer] Scene active

Estructura de carpetas

hz_audiomixer/
├── fxmanifest.lua
├── client.lua             ← cifrado por Asset Escrow
├── config/
│   └── config.lua         ← modificable
├── shared/
│   └── locale.lua         ← cifrado por Asset Escrow
├── 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, añade los tuyos
├── audioconfig/
│   ├── _nt_core_mx.dat15.rel       ← datos de audio compilados
│   └── _nt_core_gm.dat151.rel
└── html/
    ├── index.html         ← modificable
    ├── style.css          ← modificable
    └── app.js             ← modificable

Archivos modificables (escrow_ignore) — config/, locales/ y html/ permanecen legibles para que puedas personalizarlos. client.lua (la lógica del motor de audio) y shared/locale.lua están cifrados.

Solución de problemas

La escena de audio no se inicia

Con Config.Debug = true, la línea [HZ-AudioMixer] Scene active nunca aparece en F8 y mover un control deslizante no cambia nada. Esto suele significar que los archivos dat15.rel / dat151.rel no se cargaron correctamente. Verifica:

  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 los archivos de audio — reinicia el servidor por completo (reinicio completo, no solo restart hz_audiomixer durante la primera instalación)

Falta un sonido

Los volúmenes se guardan por jugador, así que un canal dejado al 0% sigue en silencio en todas las sesiones:

  1. Pulsa F7 y comprueba que ese control deslizante no esté al 0% (un valor del 0% aparece resaltado)
  2. Para la radio, comprueba también Música: la radio forma parte de la categoría Música, así que Música al 0% también silencia la radio
  3. Pulsa R dos veces para devolver todos los canales a Config.DefaultVolume

F7 no abre el mezclador

  • Abre el menú de atajos de FiveM (Menú Pausa > Ajustes > Atajos > FiveM)
  • Busca "Abrir HZ Audio Mixer" ("Open HZ Audio Mixer" en inglés; la etiqueta sigue Config.Locale). Reasigna la tecla si F7 entra en conflicto con otro recurso

Paso siguiente