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

Nenhuma. HZ-AudioMixer e um recurso puramente standalone.
  • Nenhum framework necessario — funciona com QBCore, QBox, ESX, Standalone, vMenu, vanilla
  • Sem SQL — as configuracoes sao salvas no lado do cliente via FiveM KVP
  • Nao precisa do hz_lib
  • Nenhum recurso complementar

Etapa 3 — Instalacao

  1. Extraia o arquivo baixado
  2. Coloque a pasta hz_audiomixer no seu diretorio resources/[standalone]/
  3. Adicione a linha no seu server.cfg:
ensure hz_audiomixer
  1. Reinicie seu servidor

Etapa 4 — Verificacao

Os jogadores devem ver esta linha no console F8 apos o spawn:

[hz_audiomixer] Scene active

Em seguida, pressione F7 no jogo — a interface do mixer deve abrir com 9 controles deslizantes.

Estrutura de pastas

hz_audiomixer/
├── fxmanifest.lua
├── client.lua             ← criptografado por Asset Escrow
├── config/
│   └── config.lua         ← modificavel
├── shared/
│   └── locale.lua         ← modificavel
├── 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, personalize livremente

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

Solucao de problemas

WARN: Scene non active no console F8

A cena de audio nao foi ativada. 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)

Os jogadores nao tem som apos o spawn

Se todos os sons estao cortados no primeiro spawn:

  1. Reinicie o recurso uma vez para limpar o KVP se necessario (o loop agressivo de 15s no spawn reaplica os valores)
  2. Verifique se um jogador pressiona F7 para confirmar que os controles nao estao todos em 0%

F7 nao abre o mixer

  • Abra o menu de atalhos do FiveM (Menu de Pausa > Configuracoes > Atalhos > FiveM)
  • Procure "Mixer Audio" — reatribua se F7 conflitar com outro recurso

Proxima etapa