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 audio del chat de voz pasa por un sistema de submix separado y no se ve afectado por HZ-AudioMixer. Puede seguir hablando y escuchando a los demás jugadores exactamente como antes.¿Funciona en servidores standalone / vMenu / vanilla?
Sí. No se requiere framework. El script no necesita detectar nada porque no necesita nada — puro estándar FiveM.¿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í. El HTML/CSS enhtml/index.html esta intencionalmente fuera de Asset Escrow para que pueda redisenar el estilo completamente. Solo la lógica del motor de audio (client.lua) está cifrada.
¿Puedo agregar mis propios controles deslizantes en mi menú de pausa?
Sí. HZ-AudioMixer expone una API completa (getCategoriesData, setVolume, evento volumeChanged) para que pueda construir sus propios controles deslizantes en cualquier NUI personalizado. Vea Exports y Eventos para ejemplos de integración completos.
¿Puedo desactivar categorías especificas?
Sí. EstablezcaConfig.Categories.<categoria> = false y el control deslizante desaparecerá de la interfaz, y el parche de escena de audio correspondiente será ignorado. Vea Configuración.
¿Puedo agregar mis propias traducciones?
Sí. Coloque un archivolocales/<codigo>.lua en el recurso. Utilice cualquier locale existente como plantilla. 14 idiomas están incluidos por defecto.
¿Puedo cambiar la tecla de acceso rápido?
Si — tanto usted (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 → "Mixer Audio HZ").
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.
¿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?
Si — el control deslizanteradio controla la radio del vehículo de forma independiente del control deslizante music (que es la música ambiental/banda sonora del juego).
¿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?
Muy poco frecuente, pero si ocurre: la escena de audio tarda unos segundos en registrarse en la primera conexión. El script tiene un bucle de recuperación agresivo de 15 segundos que reaplica los valores en cada frame. Si el sonido no vuelve, pida al jugador que presione F7 y verifique que los controles deslizantes no estén en 0%.
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 utiliza el sistema de escena de audio RAGE a nivel del motor — no toca ningún recurso de sonido, llamada nativa o submix de audio. 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. Los archivos audioconfig/*.rel contienen nombres de categorías ofuscados (ej: _v_a3f en lugar de weapons) — sin el mapeo Lua cifrado, los archivos binarios son inutiles.
¿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 su cuenta CFX/Keymaster. Si su servidor compartido utiliza su cuenta, funcionara. Si utiliza la de otra persona, no.
Solución de problemas
WARN: Scene non active en F8
Los archivos dat15.rel / dat151.rel no se cargaron a tiempo. Verifique:
- La carpeta
audioconfig/existe en el recurso data_file 'AUDIO_DYNAMIXDATA'ydata_file 'AUDIO_GAMEDATA'están en elfxmanifest.lua- Reinicie 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
Abra Menú Pausa → Ajustes → Atajos → FiveM → Busque "Mixer Audio HZ" → Reasigne a una tecla libre.
El mezclador se abre pero mover los controles deslizantes no cambia nada
Verifique que mixerReady sea true — abra F8 con Config.Debug = true y busque [hz_audiomixer] Scene active. Si ve WARN: Scene non active, la escena de audio no se registro (vea más arriba).
Después de la conexión, todos los sonidos se silencian durante unos segundos
Es la fase de recuperación agresiva de 15 segundos al aparecer. El mezclador aplica sus valores guardados frame por frame para asegurarse de que surtan efecto. Si el silencio persiste más allá de 15 segundos, verifique que sus valores KVP guardados no estén todos en 0 (abra el mezclador con F7 y verifique).