HZ Scripts

Instalacao

Etapa 1 — Download

Apos sua compra em hzscripts.com/shop, sua conta FiveM Keymaster recebe o asset.

  1. Faca login em keymaster.fivem.net (ou portal.cfx.re/assets)
  2. Va em Granted Assets
  3. Baixe o HZ-AudioMixer
Importante: utilize a mesma conta FiveM vinculada a sua licenca Tebex. O script e protegido por escrow e requer uma licenca valida.

Etapa 2 — Dependencias

hz_lib (grátis) é a única dependência. Ele desenha o painel do mixer (kit de UI HZ) e traz as cores e as fontes do seu tema. Veja hz_lib.
  • Nenhum framework necessario — funciona com QBCore, QBox, ESX, Standalone, vMenu, vanilla
  • Sem SQL — as configuracoes sao salvas no lado do cliente via FiveM KVP
  • Nenhum outro recurso

Etapa 3 — Instalacao

  1. Extraia o arquivo baixado
  2. Coloque a pasta hz_audiomixer no seu diretório resources/, ao lado do hz_lib
  3. Adicione as duas linhas no seu server.cfg, o hz_lib primeiro:
ensure hz_lib
ensure hz_audiomixer
  1. Reinicie seu servidor

Etapa 4 — Verificacao

Pressione F7 no jogo (ou digite /audiomixer): o painel do mixer abre à direita da tela, com 9 controles deslizantes em 4 grupos.

Para verificar a cena de áudio, defina Config.Debug = true. Depois do spawn, o console F8 mostra:

[HZ-AudioMixer] Scene active

Estrutura de pastas

hz_audiomixer/
├── fxmanifest.lua
├── client.lua             ← criptografado por Asset Escrow
├── config/
│   └── config.lua         ← modificavel
├── shared/
│   └── locale.lua         ← criptografado 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
│   └── ...                ← modificavel, adicione os seus
├── audioconfig/
│   ├── _nt_core_mx.dat15.rel       ← dados de audio compilados
│   └── _nt_core_gm.dat151.rel
└── html/
    ├── index.html         ← modificavel
    ├── style.css          ← modificavel
    └── app.js             ← modificavel

Arquivos modificaveis (escrow_ignore) — config/, locales/ e html/ permanecem legiveis para que voce possa personaliza-los. O client.lua (a logica do motor de audio) e o shared/locale.lua são criptografados.

Solucao de problemas

A cena de áudio não inicia

Com Config.Debug = true, a linha [HZ-AudioMixer] Scene active nunca aparece no F8, e mover um controle não muda nada. Isso geralmente significa que os arquivos dat15.rel / dat151.rel nao foram carregados corretamente. Verifique:

  1. A pasta audioconfig/ esta presente no recurso
  2. data_file 'AUDIO_DYNAMIXDATA' e data_file 'AUDIO_GAMEDATA' estao no fxmanifest.lua
  3. O recurso inicia apos o carregamento dos arquivos de audio — reinicie o servidor completamente (reinicializacao completa, nao apenas restart hz_audiomixer na primeira instalacao)

Falta um som

Os volumes são salvos por jogador, então um canal deixado em 0% fica mudo em todas as sessões:

  1. Pressione F7 e verifique se o controle não está em 0% (um valor de 0% fica destacado)
  2. Para o rádio, verifique também Música: o rádio fica dentro da categoria Música, então Música em 0% também deixa o rádio mudo
  3. Pressione R duas vezes para voltar todos os canais para Config.DefaultVolume

F7 nao abre o mixer

  • Abra o menu de atalhos do FiveM (Menu de Pausa > Configuracoes > Atalhos > FiveM)
  • Procure "Abrir HZ Audio Mixer" ("Open HZ Audio Mixer" em inglês; o rótulo segue o Config.Locale). Reatribua se F7 conflitar com outro recurso

Proxima etapa