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

O que precisa
- oxmysql. O ZeroDev Sound cria as suas próprias tabelas no primeiro arranque. Não há SQL para importar.
- Uma framework: ESX Legacy, QBCore, Qbox ou nenhuma (standalone). É detetada no arranque.
- Um inventário para os itens de coluna, ou nenhum. ox_inventory, qb-inventory, qs-inventory e outros são detetados no arranque.
- Opcional: ox_target ou qb-target (caso contrário os jogadores recebem um aviso de tecla) e o Pulse Phone para o rádio do carro no ecrã de carro do telemóvel.
Como configurar o som automóvel
- Coloque a pasta
zerodev-soundna sua pastaresourcese mantenha esse nome de pasta. - Adicione
ensure zerodev-soundaoserver.cfg, depois do oxmysql, da sua 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 por si. - Reinicie o servidor inteiro. Se a consola disser que gravou itens, reinicie mais uma vez.
- Entre a conduzir na baia de som automóvel do Benny's e prima 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 na bagageira, Qualidade de som, Limpo e discreto) ou escolhem cada peça: subwoofers de 8" a 21", caixas, amplificadores, colunas de porta, tweeters, um condensador, uma segunda bateria, fitas 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 pagarem, e Instalar cobra só as peças que são novas no carro.

A montagem fica guardada na matrícula e volta com o carro de qualquer garagem, depósito ou respawn. Não é preciso alterar nada no seu script de garagem.
O que todos ouvem
- Todos os carros já têm um som de fábrica para a sua classe: quatro colunas, um sistema premium ou um de referência. As colunas instaladas substituem as de fábrica mais próximas, e os subs somam-se a elas.
- Fora do carro, passa sobretudo o grave. Portas e vidros abertos e a bagageira aberta deixam sair mais.
- A tampa da bagageira 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 predefinição) tem volume, nível do sub, fader e balanço.

Definições que os donos de servidor alteram
Todas as definições estão no jogo, em /soundadmin. Os mesmos valores em config/config.lua:
| O que quer | Definiçã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 que carros se pode montar | Config.Install.vehicles: 'owned' (predefinição) ou 'any' |
| Só os mecânicos instalam | Config.Install.anyone = false e os empregos em Config.Install.jobs |
| Peças de carro grátis | Config.Install.chargeParts = false |
| Horas de silêncio | Config.QuietHours = { enabled = true, from = 23, to = 7, maxVolume = 0.35 } |
Música
A música toca a partir de ficheiros de áudio que adiciona ao resource e da rádio do próprio GTA. Os jogadores não podem inserir ligações. Adicione apenas áudio que seja seu ou cujos direitos de utilização possua.
Perguntas frequentes
Os jogadores mantêm o som do carro depois de reiniciar ou de usar a garagem?
Sim. A instalação fica guardada na matrícula do carro e volta sempre que o carro volta.
Quem está fora do carro ouve os subwoofers?
Sim. Passa sobretudo o grave através da carroçaria; portas, vidros e bagageira 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 da sua framework (owned_vehicles na ESX, player_vehicles na QBCore e na Qbox), e as matrículas são comparadas em maiúsculas e sem espaços nas pontas.
Configure para a sua framework
ESX · QBCore · Qbox · Guia de instalação completo · API para programadores
Experimente no seu próprio servidor
O ZeroDev Sound custa $45 uma vez ou $20 por mês, com teste gratuito de 7 dias no seu próprio servidor. Ver o ZeroDev Sound