Documentazione di ZeroDev Sound
Script audio per auto FiveM: subwoofer e casse per bassi
ZeroDev Sound aggiunge un audio per auto che i giocatori montano nelle proprie auto: subwoofer in cassa, amplificatori, casse nelle portiere, un'autoradio e luci LED, installati pezzo per pezzo in una baia di installazione. La configurazione resta con l'auto e chi è fuori sente soprattutto i bassi, come succederebbe in una strada vera. Questa guida lo configura su un server FiveM.

Cosa ti serve
- oxmysql. ZeroDev Sound crea le proprie tabelle al primo avvio. Non c'è nessun SQL da importare.
- Un framework: ESX Legacy, QBCore, Qbox, o nessuno (standalone). Viene rilevato all'avvio.
- Un inventario per gli oggetti speaker, o nessuno. ox_inventory, qb-inventory, qs-inventory e altri vengono rilevati all'avvio.
- Facoltativo: ox_target o qb-target (altrimenti i giocatori ricevono un invito a premere un tasto) e Pulse Phone per l'autoradio sullo schermo auto del telefono.
Come configurare l'audio per auto
- Metti la cartella
zerodev-soundnella tua cartellaresourcese mantieni quel nome. - Aggiungi
ensure zerodev-soundaserver.cfg, dopo oxmysql, il tuo framework e il tuo inventario. - Su ox_inventory, qs-inventory o qb-inventory, aggiungi
add_filesystem_permission zerodev-sound write ox_inventory(usa il nome della resource del tuo inventario), così lo script può scrivere i suoi oggetti per te. - Riavvia l'intero server. Se la console dice di aver scritto degli oggetti, riavvia ancora una volta.
- Entra come guidatore nella baia di audio per auto da Benny's e premi E. L'installer si apre sulla tua auto.
Come costruiscono i giocatori
I giocatori partono da un kit pronto (Basso quotidiano, Competizione, Muro nel bagagliaio, Qualità del suono, Pulito e nascosto) o scelgono ogni pezzo: subwoofer da 8" a 21", casse, amplificatori, casse per le portiere, tweeter, un condensatore, una seconda batteria, strisce LED e un'autoradio. Ogni pezzo si trascina al suo posto sull'auto e riceve una finitura. Prova impianto riproduce la configurazione prima del pagamento e Installa addebita solo i pezzi nuovi per l'auto.

La configurazione è salvata sulla targa e torna con l'auto da qualsiasi garage, depot o respawn. Non serve cambiare nulla nel tuo script garage.
Cosa sentono tutti
- Ogni auto ha già un suono di fabbrica per la sua classe: quattro casse, un impianto premium o uno di riferimento. Le casse montate sostituiscono quelle di fabbrica più vicine e i sub si aggiungono.
- Fuori dall'auto passano soprattutto i bassi. Portiere e finestrini aperti e un bagagliaio aperto ne lasciano uscire di più.
- Il coperchio del bagagliaio e i pannelli vibrano con i bassi. I sub spinti ben oltre ciò che il loro amplificatore consente possono bruciarsi e un sub bruciato resta carbonizzato finché non viene sostituito.
- L'autoradio (K per impostazione predefinita) ha volume, livello dei sub, fader e bilanciamento.

Impostazioni che cambiano i proprietari del server
Ogni impostazione è in gioco, in /soundadmin. Gli stessi valori in config/config.lua:
| Cosa vuoi | Impostazione |
|---|---|
| Sposta la baia o aggiungi baie | Config.Install.bays (ognuna con label, coords, radius, blip) |
| Monta ovunque sull'auto | Config.Install.anywhere = true |
| Su quali auto si può montare | Config.Install.vehicles: 'owned' (predefinito) o 'any' |
| Solo i meccanici installano | Config.Install.anyone = false e i lavori in Config.Install.jobs |
| Componenti per auto gratis | Config.Install.chargeParts = false |
| Ore di silenzio | Config.QuietHours = { enabled = true, from = 23, to = 7, maxVolume = 0.35 } |
Musica
La musica viene riprodotta da file audio che aggiungi alla resource e dalla radio di GTA. I giocatori non possono inserire link. Aggiungi solo audio che possiedi o di cui hai i diritti d'uso.
Domande frequenti
I giocatori mantengono l'audio dell'auto dopo un riavvio o il garage?
Sì. L'installazione è salvata sulla targa dell'auto e torna ogni volta che torna l'auto.
Chi è fuori dall'auto sente i subwoofer?
Sì. Passano soprattutto i bassi attraverso la carrozzeria; portiere, finestrini e bagagliaio aperti lasciano uscire più musica.
Funziona con il mio script garage?
Non c'è nulla da modificare. Le auto possedute sono lette dalla tabella del tuo framework (owned_vehicles su ESX, player_vehicles su QBCore e Qbox) e le targhe vengono confrontate in maiuscolo e senza spazi.
Configura per il tuo framework
ESX · QBCore · Qbox · Guida completa all'installazione · API per sviluppatori
Provalo sul tuo server
ZeroDev Sound costa $45 una tantum o $20 al mese, con 7 giorni di prova gratuita sul tuo server. Vedi ZeroDev Sound