FAQ
General
¿HZ-AudioMixer reproduce sonidos personalizados?
No. HZ-AudioMixer no reproduce, no emite y no modifica ningún archivo de sonido. Controla las categorías de audio nativas de GTA V que el propio juego utiliza. Cero impacto en el tamaño de archivos, cero conflicto con otros recursos de audio (xSound, interact-sound, etc.).¿Interfiere con mi chat de voz (pma-voice / saltychat / mumble)?
No. El mezclador solo cambia 9 categorías de sonido de GTA V, y el chat de voz no está en ninguna de ellas. Puedes seguir hablando y escuchando a los demás jugadores exactamente como antes, al volumen definido por tu recurso de voz. Lo que el mezclador sí aporta al chat de voz: bajar Clima, Armas o Vehículos hace que las voces se oigan mejor.¿Funciona en servidores standalone / vMenu / vanilla?
Sí. No se requiere framework. El script no necesita detectar nada porque no necesita nada. Su única dependencia es hz_lib (gratuito).¿Necesito una base de datos?
No. Los ajustes de los jugadores se guardan del lado del cliente vía FiveM KVP (Key-Value Persistence). Las preferencias de cada jugador permanecen en su propia máquina y persisten a través de los reinicios del servidor y las reconexiones.¿Es compatible con QBCore / QBox / ESX?
Sí. Todos los frameworks están soportados — pero el script en realidad no utiliza ninguna funcionalidad del framework. Simplemente funciona.Interfaz y Personalización
¿Puedo modificar el diseño de la interfaz?
Sí. Los archivos dehtml/ (index.html, style.css, app.js) están intencionadamente fuera de Asset Escrow. El panel está construido con el kit UI de hz_lib: los colores y las fuentes vienen de tu tema hz_lib (/hzpanel), la disposición está en style.css, y los grupos y el orden en app.js. Solo la lógica del motor de audio (client.lua) y shared/locale.lua están cifrados. Consulta Configuración.
¿Puedo agregar mis propios controles deslizantes en mi menú de pausa?
Sí. HZ-AudioMixer expone una API completa (getCategoriesData, setVolume, evento volumeChanged) para que puedas construir tus propios controles deslizantes en cualquier NUI personalizado. Consulta Exports y Eventos para ver ejemplos de integración completos.
¿Puedo desactivar categorías especificas?
Sí. PonConfig.Categories.<categoria> = false y el control deslizante desaparecerá de la interfaz, y el parche de escena de audio correspondiente será ignorado. Consulta Configuración.
¿Puedo agregar mis propias traducciones?
Sí. Coloca un archivolocales/<codigo>.lua en el recurso. Usa cualquier locale existente como plantilla. 14 idiomas están incluidos por defecto.
¿Puedo cambiar la tecla de acceso rápido?
Sí — tanto tú (valor por defecto del servidor) como cada jugador individualmente. El valor por defecto del servidor está enConfig.OpenKey (por defecto F7). Cada jugador puede modificarlo en el menú de pausa FiveM (Ajustes → Atajos → FiveM → "Abrir HZ Audio Mixer", en el idioma definido por Config.Locale; "Open HZ Audio Mixer" en inglés).
Técnico
¿Qué categorías de audio controla?
9 categorías del motor RAGE: weapons, vehicles, ambience, weather, speech, peds, scripted, music, radio. Estas son categorías padre — ajustar vehicles afecta motores, bocinas, sirenas, helicópteros, etc. todos juntos. Consulta la lista de categorías para ver lo que contiene cada una.
No están en ningún canal: el chat de voz, los sonidos reproducidos por scripts NUI (xSound, interact-sound), los choques y otras colisiones, la música de las misiones, los sonidos de interfaz y de menús, las cinemáticas, las puertas, el fuego, el agua y los animales.
¿Es compatible con mods de audio personalizados (packs de sonidos de vehículos, mods de sonidos de armas)?
Sí. Siempre que los sonidos personalizados pasen por las categorías de audio RAGE estándar (lo cual siempre ocurre para los sonidos de gameplay), responderán al mezclador.¿Afecta la música de la radio en los vehículos?
Sí. El control deslizanteradio controla la radio de los vehículos y las radios colocadas en el mundo (edificios, clubes). En el juego, radio está dentro de music (la banda sonora del juego): los dos volúmenes se multiplican, así que Música al 0% también silencia la radio.
¿Los ajustes de mis jugadores se reiniciaran cuando reinicie el servidor?
No. Los ajustes se almacenan en el KVP de FiveM en la máquina del cliente. Sobreviven a los reinicios de recursos, reinicios del servidor y desconexiones.¿Qué sucede en la primera conexión?
Cada categoría se establece por defecto en Config.DefaultVolume (100 = volumen máximo). Los jugadores ven el mezclador con todos los controles deslizantes al 100% en el primer inicio.
¿Qué hacer si un jugador no tiene sonido después de aparecer?
Al aparecer, el script inicia su escena de audio, vuelve a aplicar los volúmenes guardados en cada frame durante 15 segundos y después cada 500 ms. Si sigue faltando un sonido, pide al jugador que pulse F7 y compruebe que ese control deslizante no esté al 0% (y Música, para la radio).
Rendimiento
¿Consume muchos FPS?
No. UI cerrada = 0.00ms. UI abierta = <0.05ms. Motor de audio en segundo plano = <0.02ms. Probado en servidores de 32 jugadores con 200+ recursos, cero impacto en los FPS.¿Se ejecuta en el servidor?
Sin lógica del lado del servidor. Todo se ejecuta del lado del cliente. Los ajustes de cada jugador son propios de cada uno.¿Entra en conflicto con otros scripts de audio?
No. El mezclador solo controla su propia escena de audio sobre las categorías de audio RAGE. No toca ningún otro recurso de sonido ni submix de audio, y coexiste con cualquier otro script de audio.Seguridad y Licencia
¿El script esta protegido contra el robo?
Sí. La lógica del motor de audio (client.lua) está cifrada vía FiveM Asset Escrow.
¿Puedo compartirlo con el servidor de un amigo?
No. Licencia mono-servidor. La reventa, redistribucion o comparticion del código fuente esta prohibida. Las violaciones de Asset Escrow son rastreadas y reportadas.¿Funcionara en un servidor compartido de Tebex?
El script está vinculado a tu cuenta CFX/Keymaster. Si tu servidor compartido utiliza tu cuenta, funcionará. Si utiliza la de otra persona, no.
Solución de problemas
La escena de audio no se inicia
Pon Config.Debug = true: después de aparecer, F8 debería mostrar [HZ-AudioMixer] Scene active. Si nunca aparece, los archivos dat15.rel / dat151.rel no se cargaron a tiempo. Verifica:
- La carpeta
audioconfig/existe en el recurso data_file 'AUDIO_DYNAMIXDATA'ydata_file 'AUDIO_GAMEDATA'están en elfxmanifest.lua- Reinicia el servidor completo (no solo
restart hz_audiomixer) — los archivos de datos de audio requieren un inicio limpio para registrarse
F7 entra en conflicto con otro recurso
Abre Menú Pausa → Ajustes → Atajos → FiveM → Busca "Abrir HZ Audio Mixer" ("Open HZ Audio Mixer" en inglés) → Reasigna a una tecla libre.
El mezclador se abre pero mover los controles deslizantes no cambia nada
La escena de audio no se inició: consulta "La escena de audio no se inicia" más arriba.
Un sonido sigue en silencio
Los volúmenes guardados siguen al jugador de una sesión a otra. Abre el mezclador con F7 y comprueba que el control deslizante no esté al 0%. Para la radio, comprueba también Música. Pulsa R dos veces para devolver todos los canales a Config.DefaultVolume.