Dokumentacja ZeroDev Sound
Skrypt car audio do FiveM: subwoofery i głośniki basowe
ZeroDev Sound dodaje car audio, które gracze budują we własnych autach: subwoofery w skrzyniach, wzmacniacze, głośniki drzwiowe, radio samochodowe i podświetlenie LED, ustawiane część po części w warsztacie montażu. Zestaw zostaje przy aucie, a osoby na zewnątrz słyszą głównie bas, tak jak na prawdziwej ulicy. Ten poradnik konfiguruje to na serwerze FiveM.

Czego potrzebujesz
- oxmysql. ZeroDev Sound tworzy własne tabele przy pierwszym starcie. Nie ma SQL do zaimportowania.
- Framework: ESX Legacy, QBCore, Qbox albo żaden (standalone). Jest wykrywany przy starcie.
- Ekwipunek na przedmioty głośników albo żaden. ox_inventory, qb-inventory, qs-inventory i inne są wykrywane przy starcie.
- Opcjonalnie: ox_target lub qb-target (w przeciwnym razie gracze dostają podpowiedź klawisza) oraz Pulse Phone dla radia samochodowego na ekranie auta w telefonie.
Jak skonfigurować car audio
- Umieść folder
zerodev-soundw folderzeresourcesi zachowaj nazwę tego folderu. - Dodaj
ensure zerodev-sounddoserver.cfg, po oxmysql, twoim frameworku i twoim ekwipunku. - W ox_inventory, qs-inventory lub qb-inventory dodaj
add_filesystem_permission zerodev-sound write ox_inventory(użyj nazwy resource twojego ekwipunku), aby skrypt mógł zapisać swoje przedmioty za ciebie. - Zrestartuj cały serwer. Jeśli konsola mówi, że zapisano przedmioty, zrestartuj jeszcze raz.
- Wjedź jako kierowca do warsztatu car audio u Benny's i naciśnij E. Instalator otworzy się na twoim aucie.
Jak budują gracze
Gracze zaczynają od gotowego zestawu (Daily thump, Competition, Trunk wall, Sound quality, Clean and hidden) albo wybierają każdą część: subwoofery od 8" do 21", skrzynie, wzmacniacze, głośniki drzwiowe, głośniki wysokotonowe, kondensator, drugi akumulator, paski LED i radio samochodowe. Każdą część przeciąga się na miejsce w aucie i wybiera wykończenie. Test system odtwarza zestaw, zanim zapłacą, a Install pobiera opłatę tylko za części nowe dla auta.

Zestaw jest zapisany przy tablicy rejestracyjnej i wraca z autem z dowolnego garażu, parkingu policyjnego lub respawnu. Nic nie trzeba zmieniać w twoim skrypcie garażu.
Co słyszą wszyscy
- Każde auto ma już fabryczny dźwięk dla swojej klasy: cztery głośniki, system premium albo referencyjny. Zamontowane głośniki zastępują fabryczne najbliżej nich, a suby je uzupełniają.
- Na zewnątrz auta przebija się głównie bas. Otwarte drzwi, okna i otwarty bagażnik wypuszczają więcej.
- Klapa bagażnika i panele bagażnika grzechoczą od basu. Suby sterowane znacznie powyżej tego, na co pozwala ich wzmacniacz, mogą się przepalić, a przepalony sub pozostaje zwęglony, dopóki nie zostanie wymieniony.
- Radio (domyślnie K) ma głośność, poziom suba, fader i balans.

Ustawienia zmieniane przez właścicieli serwerów
Każde ustawienie jest w grze, w /soundadmin. Te same wartości w config/config.lua:
| Co chcesz | Ustawienie |
|---|---|
| Przesuń warsztat albo dodaj kolejne | Config.Install.bays (każdy z label, coords, radius, blip) |
| Buduj przy aucie w dowolnym miejscu | Config.Install.anywhere = true |
| Które auta można rozbudować | Config.Install.vehicles: 'owned' (domyślnie) albo 'any' |
| Instalować mogą tylko mechanicy | Config.Install.anyone = false i joby w Config.Install.jobs |
| Darmowe części do aut | Config.Install.chargeParts = false |
| Godziny ciszy | Config.QuietHours = { enabled = true, from = 23, to = 7, maxVolume = 0.35 } |
Muzyka
Muzyka jest odtwarzana z plików audio, które dodasz do resource, i z własnego radia GTA. Gracze nie mogą wpisywać linków. Dodawaj tylko audio, które posiadasz lub do którego masz prawa.
Najczęściej zadawane pytania
Czy gracze zachowują car audio po restarcie lub garażu?
Tak. Instalacja jest zapisana przy tablicy rejestracyjnej auta i wraca, kiedy wraca auto.
Czy osoby na zewnątrz słyszą suby?
Tak. Przez karoserię przebija się głównie bas; otwarte drzwi, okna i bagażnik wypuszczają więcej muzyki.
Czy działa z moim skryptem garażu?
Nie ma czego edytować. Posiadane auta są czytane z tabeli twojego frameworka (owned_vehicles w ESX, player_vehicles w QBCore i Qbox), a tablice są dopasowywane wielkimi literami, z obciętymi spacjami.
Konfiguracja dla twojego frameworka
ESX · QBCore · Qbox · Pełny poradnik instalacji · API dla deweloperów
Wypróbuj na własnym serwerze
ZeroDev Sound kosztuje $45 jednorazowo albo $20/miesiąc, z 7-dniowym darmowym okresem próbnym na twoim własnym serwerze. Zobacz ZeroDev Sound