FAQ

Geral

O HZ-AudioMixer reproduz sons personalizados?

Nao. O HZ-AudioMixer nao reproduz, nao toca e nao modifica nenhum arquivo de som. Ele controla as categorias de audio nativas do GTA V que o jogo utiliza. Zero impacto no tamanho dos arquivos, zero conflito com outros recursos de audio (xSound, interact-sound, etc.).

Isso interfere com meu chat de voz (pma-voice / saltychat / mumble)?

Nao. O mixer só altera 9 categorias de som do GTA V, e o chat de voz não está em nenhuma delas. Voce pode continuar falando e ouvindo outros jogadores exatamente como antes, no volume definido pelo seu recurso de voz. O que o mixer faz pelo chat de voz: abaixar Clima, Armas ou Veículos deixa as vozes mais fáceis de ouvir.

Funciona em servidores standalone / vMenu / vanilla?

Sim. Nenhum framework necessario. O script nao precisa detectar nada porque nao precisa de nada. A única dependência dele é o hz_lib (grátis).

Preciso de um banco de dados?

Nao. As configuracoes dos jogadores sao salvas no lado do cliente via FiveM KVP (Key-Value Persistence). As preferencias de cada jogador ficam na propria maquina e persistem entre reinicializacoes do servidor e reconexoes.

E compativel com QBCore / QBox / ESX?

Sim. Todos os frameworks sao suportados — mas o script na verdade nao utiliza nenhuma funcionalidade de framework. Simplesmente funciona.

Interface & Personalizacao

Posso modificar o design da interface?

Sim. Os arquivos de html/ (index.html, style.css, app.js) estão intencionalmente fora do Asset Escrow. O painel é construído com o kit de UI do hz_lib: as cores e as fontes vêm do seu tema hz_lib (/hzpanel), o layout fica em style.css, os grupos e a ordem em app.js. Apenas a logica do motor de audio (client.lua) e o shared/locale.lua são criptografados. Veja Configuração. Sim. O HZ-AudioMixer expoe uma API completa (getCategoriesData, setVolume, evento volumeChanged) para que voce possa construir seus proprios controles em qualquer NUI personalizada. Veja Exports & Eventos para exemplos de integracao completos.

Posso desativar categorias especificas?

Sim. Defina Config.Categories.<categoria> = false e o controle desaparece da interface, e o patch de cena de audio correspondente e ignorado. Veja Configuracao.

Posso adicionar minhas proprias traducoes?

Sim. Coloque um arquivo locales/<codigo>.lua no recurso. Use qualquer locale existente como modelo. 14 idiomas estao incluidos por padrao.

Posso alterar a tecla de atalho?

Sim — por voce (padrao do servidor) e por cada jogador individualmente. O padrao do servidor esta em Config.OpenKey (padrao F7). Cada jogador pode modifica-lo no menu de pausa do FiveM (Configuracoes → Atalhos → FiveM → "Abrir HZ Audio Mixer", ou "Open HZ Audio Mixer" em inglês: o rótulo segue o idioma definido em Config.Locale).

Tecnico

Quais categorias de audio ele controla?

9 categorias do motor RAGE: weapons, vehicles, ambience, weather, speech, peds, scripted, music, radio. Sao categorias principais — ajustar vehicles afeta motores, buzinas, sirenes, helicopteros, etc. todos juntos. Veja a lista de categorias para saber o que cada uma contém.

Fora de qualquer canal: chat de voz, sons tocados por scripts NUI (xSound, interact-sound), batidas e outras colisões, música de missão, sons de interface e de menu, cutscenes, portas, fogo, água e animais.

E compativel com mods de audio personalizados (pacotes de sons de veiculos, mods de sons de armas)?

Sim. Desde que os sons personalizados passem pelas categorias de audio RAGE padrao (o que e sempre o caso para sons de gameplay), eles responderao ao mixer.

Isso afeta a musica do radio nos veiculos?

Sim. O controle radio controla o rádio do veículo e os rádios espalhados pelo mundo (prédios, boates). No jogo, radio fica dentro de music (a trilha sonora do jogo): os dois volumes se multiplicam, então Música em 0% também deixa o rádio mudo.

As configuracoes dos meus jogadores serao redefinidas quando eu reiniciar o servidor?

Nao. As configuracoes sao armazenadas no KVP do FiveM na maquina do cliente. Elas sobrevivem a reinicializacoes de recursos, reinicializacoes do servidor e desconexoes.

O que acontece na primeira conexao?

Cada categoria tem o padrao Config.DefaultVolume (100 = volume maximo). Os jogadores veem o mixer com todos os controles em 100% no primeiro uso.

O que fazer se um jogador nao tem som apos o spawn?

No spawn, o script inicia a sua cena de áudio e reaplica os volumes salvos a cada frame durante 15 segundos, depois a cada 500 ms. Se ainda faltar um som, peça ao jogador para pressionar F7 e verificar se aquele controle não está em 0% (e o de Música, no caso do rádio).

Desempenho

Consome muitos FPS?

Nao. UI fechada = 0.00ms. UI aberta = <0.05ms. Motor de audio em segundo plano = <0.02ms. Testado em servidores de 32 jogadores com mais de 200 recursos, zero impacto nos FPS.

Isso roda no servidor?

Nenhuma logica no lado do servidor. Tudo e executado no lado do cliente. As configuracoes de cada jogador sao proprias dele.

Conflita com outros scripts de audio?

Nao. O mixer só controla a sua própria cena de áudio nas categorias de áudio RAGE. Ele não mexe em nenhum outro recurso sonoro nem em submix de áudio, e coexiste com qualquer outro script de áudio.

Seguranca & Licenca

O script e protegido contra roubo?

Sim. A logica do motor de audio (client.lua) e criptografada via FiveM Asset Escrow.

Posso compartilhar com o servidor de um amigo?

Nao. Licenca para servidor unico. A revenda, redistribuicao ou compartilhamento do codigo-fonte e proibido. Violacoes do Asset Escrow sao rastreadas e reportadas.

Vai funcionar em um servidor compartilhado Tebex?

O script esta vinculado a sua conta CFX/Keymaster. Se o seu servidor compartilhado usa a sua conta, funciona. Se usa a de outra pessoa, nao.

Solucao de problemas

A cena de áudio não inicia

Defina Config.Debug = true: depois do spawn, o F8 deve mostrar [HZ-AudioMixer] Scene active. Se isso nunca acontecer, os arquivos dat15.rel / dat151.rel nao foram carregados a tempo. Verifique:

A pasta audioconfig/ existe no recurso
data_file 'AUDIO_DYNAMIXDATA' e data_file 'AUDIO_GAMEDATA' estao no fxmanifest.lua
Reinicie o servidor inteiro (nao apenas restart hz_audiomixer) — os arquivos de dados de audio necessitam de uma inicializacao limpa para se registrarem

F7 conflita com outro recurso

Abra Menu de Pausa → Configuracoes → Atalhos → FiveM → Procure "Abrir HZ Audio Mixer" ("Open HZ Audio Mixer" em inglês) → Reatribua para uma tecla livre.

O mixer abre mas mover os controles nao altera nada

A cena de áudio não iniciou: veja "A cena de áudio não inicia" acima.

Um som continua mudo

Os volumes salvos acompanham o jogador de uma sessão para a outra. Abra o mixer com F7 e verifique se o controle não está em 0%. Para o rádio, verifique também Música. Pressione R duas vezes para voltar todos os canais para Config.DefaultVolume.

FAQ