Documentația ZeroDev Sound
Script audio auto pentru FiveM: subwoofere și boxe de bas
ZeroDev Sound adaugă audio auto pe care jucătorii îl construiesc în propriile mașini: subwoofere în boxe, amplificatoare, boxe de ușă, un player auto și lumini LED, montate piesă cu piesă într-un atelier de instalare. Montajul rămâne cu mașina, iar cei din afară aud mai ales basul, ca pe o stradă adevărată. Acest ghid îl configurează pe un server FiveM.

Ce ai nevoie
- oxmysql. ZeroDev Sound își creează propriile tabele la prima pornire. Nu ai nimic de importat în SQL.
- Un framework: ESX Legacy, QBCore, Qbox sau niciunul (standalone). Este găsit la pornire.
- Un inventar pentru itemele de boxe, sau niciunul. ox_inventory, qb-inventory, qs-inventory și altele sunt găsite la pornire.
- Opțional: ox_target sau qb-target (altfel jucătorii primesc un mesaj cu tasta) și Pulse Phone pentru player-ul auto pe ecranul mașinii din telefon.
Cum configurezi audio auto
- Pune folderul
zerodev-soundîn folderul tăuresourcesși păstrează numele acestui folder. - Adaugă
ensure zerodev-soundînserver.cfg, după oxmysql, framework-ul tău și inventarul tău. - Pe ox_inventory, qs-inventory sau qb-inventory, adaugă
add_filesystem_permission zerodev-sound write ox_inventory(folosește numele resursei inventarului tău), ca scriptul să-și poată scrie singur itemele. - Repornește tot serverul. Dacă în consolă scrie că a scris iteme, repornește încă o dată.
- Intră ca șofer în atelierul de audio auto de la Benny's și apasă E. Instalatorul se deschide pe mașina ta.
Cum construiesc jucătorii
Jucătorii pornesc de la un set gata făcut (Bas zilnic, Competiție, Perete în portbagaj, Calitatea sunetului, Curat și ascuns) sau aleg fiecare piesă: subwoofere de la 8" la 21", boxe, amplificatoare, boxe de ușă, tweetere, un condensator, o a doua baterie, benzi LED și un player auto. Fiecare piesă este trasă la locul ei pe mașină și primește un finisaj. Testează sistemul redă montajul înainte de plată, iar Instalează taxează doar piesele noi pentru mașină.

Montajul este salvat pe numărul de înmatriculare și revine odată cu mașina din orice garaj, depozit al poliției sau respawn. Nu trebuie schimbat nimic în scriptul tău de garaj.
Ce aud toți
- Fiecare mașină are deja un sunet din fabrică pentru clasa ei: patru boxe, un sistem premium sau unul de referință. Boxele montate le înlocuiesc pe cele din fabrică cele mai apropiate, iar subwoofer-ele li se adaugă.
- În afara mașinii trece mai ales basul. Ușile deschise, ferestrele și un portbagaj deschis lasă mai mult sunet să iasă.
- Capacul portbagajului și panourile vibrează odată cu basul. Subwoofer-ele împinse mult peste ce permite amplificatorul lor se pot arde, iar un subwoofer ars rămâne ars până este înlocuit.
- Player-ul auto (K implicit) are volum, nivel de subwoofer, fader și balans.

Setări pe care le schimbă proprietarii de servere
Fiecare setare este în joc, în /soundadmin. Aceleași valori în config/config.lua:
| Ce vrei | Setare |
|---|---|
| Mută atelierul sau adaugă ateliere | Config.Install.bays (fiecare cu label, coords, radius, blip) |
| Construiește la mașină oriunde | Config.Install.anywhere = true |
| Ce mașini pot fi echipate | Config.Install.vehicles: 'owned' (implicit) sau 'any' |
| Doar mecanicii instalează | Config.Install.anyone = false și joburile din Config.Install.jobs |
| Piese auto gratuite | Config.Install.chargeParts = false |
| Ore de liniște | Config.QuietHours = { enabled = true, from = 23, to = 7, maxVolume = 0.35 } |
Muzică
Muzica se redă din fișiere audio pe care le adaugi în resursă și din radioul GTA. Jucătorii nu pot introduce linkuri. Adaugă doar audio pe care îl deții sau pentru care ai drepturi de utilizare.
Întrebări frecvente
Își păstrează jucătorii audio auto după un restart sau după garaj?
Da. Montajul este salvat pe numărul de înmatriculare al mașinii și revine ori de câte ori revine mașina.
Pot auzi subwoofer-ele și cei din afara mașinii?
Da. Prin caroserie trece mai ales basul; ușile deschise, ferestrele și portbagajul lasă mai multă muzică să iasă.
Funcționează cu scriptul meu de garaj?
Nu ai nimic de editat. Mașinile deținute sunt citite din tabela framework-ului tău (owned_vehicles pe ESX,
player_vehicles pe QBCore și Qbox), iar numerele de înmatriculare sunt comparate cu majuscule și fără spații la capete.
Configurare pentru framework-ul tău
ESX · QBCore · Qbox · Ghidul complet de instalare · API pentru dezvoltatori
Încearcă-l pe propriul server
ZeroDev Sound costă $45 o dată sau $20/lună, cu o perioadă de probă gratuită de 7 zile pe propriul server. Vezi ZeroDev Sound