Documentação do ZeroDev Sound
Script de som automotivo para FiveM: subwoofers e caixas de som de grave
O ZeroDev Sound adiciona um som automotivo que os jogadores montam nos próprios carros: subwoofers em caixas, amplificadores, caixas de som de porta, um rádio e luzes de LED, instalados peça por peça em uma baia de instalação. A montagem fica com o carro, e quem está fora ouve principalmente o grave, como numa rua de verdade. Este guia configura isso em um servidor FiveM.

O que você precisa
- oxmysql. O ZeroDev Sound cria as suas próprias tabelas na primeira inicialização. Não há SQL para importar.
- Um framework: ESX Legacy, QBCore, Qbox ou nenhum (standalone). Ele é detectado na inicialização.
- Um inventário para os itens de caixa de som, ou nenhum. ox_inventory, qb-inventory, qs-inventory e outros são detectados na inicialização.
- Opcional: ox_target ou qb-target (senão os jogadores recebem um aviso de tecla) e o Pulse Phone para o rádio do carro na tela de carro do celular.
Como configurar o som automotivo
- Coloque a pasta
zerodev-soundna sua pastaresourcese mantenha esse nome de pasta. - Adicione
ensure zerodev-soundaoserver.cfg, depois do oxmysql, do seu framework e do seu inventário. - No ox_inventory, qs-inventory ou qb-inventory, adicione
add_filesystem_permission zerodev-sound write ox_inventory(use o nome de resource do seu inventário), para que o script possa gravar os itens dele para você. - Reinicie o servidor inteiro. Se o console disser que gravou itens, reinicie mais uma vez.
- Entre dirigindo na baia de som automotivo do Benny's e pressione E. O instalador abre no seu carro.
Como os jogadores montam
Os jogadores começam por um kit pronto (Batida diária, Competição, Parede no porta-malas, Qualidade de som, Limpo e discreto) ou escolhem cada peça: subwoofers de 8" a 21", caixas, amplificadores, caixas de som de porta, tweeters, um capacitor, uma segunda bateria, fitas de LED e um rádio. Cada peça é arrastada para o lugar no carro e recebe um acabamento. Testar sistema toca a montagem antes de pagar, e Instalar cobra só as peças que são novas no carro.

A montagem é salva na placa e volta com o carro de qualquer garagem, depósito ou respawn. Nada precisa mudar no seu script de garagem.
O que todos ouvem
- Todo carro já tem um som de fábrica para a sua classe: quatro caixas de som, um sistema premium ou um de referência. As caixas instaladas substituem as de fábrica mais próximas, e os subs se somam a elas.
- Fora do carro, passa principalmente o grave. Portas e vidros abertos e o porta-malas aberto deixam sair mais.
- A tampa do porta-malas e os painéis vibram com o grave. Subs forçados muito além do que o amplificador suporta podem queimar, e um sub queimado fica carbonizado até ser substituído.
- O rádio (K por padrão) tem volume, nível do sub, fader e balanço.

Configurações que os donos de servidor mudam
Toda configuração está no jogo, em /soundadmin. Os mesmos valores em config/config.lua:
| O que você quer | Configuração |
|---|---|
| Mover a baia ou adicionar baias | Config.Install.bays (cada uma com label, coords, radius, blip) |
| Montar no carro em qualquer lugar | Config.Install.anywhere = true |
| Em quais carros dá para montar | Config.Install.vehicles: 'owned' (padrão) ou 'any' |
| Só mecânicos instalam | Config.Install.anyone = false e os empregos em Config.Install.jobs |
| Peças de carro grátis | Config.Install.chargeParts = false |
| Horário de silêncio | Config.QuietHours = { enabled = true, from = 23, to = 7, maxVolume = 0.35 } |
Música
A música toca a partir de arquivos de áudio que você adiciona ao resource e do rádio do próprio GTA. Os jogadores não podem inserir links. Adicione apenas áudio que seja seu ou cujos direitos de uso você tenha.
Perguntas frequentes
Os jogadores mantêm o som do carro depois de reiniciar ou de usar a garagem?
Sim. A instalação é salva na placa do carro e volta sempre que o carro volta.
Quem está fora do carro ouve os subwoofers?
Sim. Passa principalmente o grave pela carroceria; portas, vidros e porta-malas abertos deixam sair mais música.
Funciona com o meu script de garagem?
Não há nada para editar. Os carros próprios são lidos da tabela do seu framework (owned_vehicles no ESX, player_vehicles no QBCore e no Qbox), e as placas são comparadas em maiúsculas e sem espaços nas pontas.
Configure para o seu framework
ESX · QBCore · Qbox · Guia de instalação completo · API para desenvolvedores
Teste no seu próprio servidor
O ZeroDev Sound custa $45 uma vez ou $20 por mês, com teste grátis de 7 dias no seu próprio servidor. Ver o ZeroDev Sound