ZeroDev Sound: vodič za instalaciju

Ovaj resurs ne sadrži niti pruža nikakve integracije zvuka ili muzike trećih strana. Muzika se reprodukuje samo iz audio datoteka koje vlasnik servera doda u resurs i putem ugrađenog GTA radija. Igrači ne mogu unositi linkove. Dodajte samo zvuk koji posjedujete ili za koji imate pravo korištenja i distribucije; strimovanje sadržaja bez dozvole može kršiti Cfx.re Creator Platform License Agreement i zakon.

Zvučnici koje igrači kupuju, nose, spuštaju i povezuju i auto audio koji ugrađuju u vlastite automobile. Ovo je kompletna referenca. Za kratku verziju pročitajte docs/SETUP.md (5 koraka); za probleme docs/TROUBLESHOOTING.md; ako dolazite s 1.x, UPGRADING.md.

Sadržaj 1. Zahtjevi 2. Instalacija 3. Predmeti za vaš inventar 4. Prvo pokretanje: šta biste trebali vidjeti 5. Postavke koje se najčešće mijenjaju 6. Kontrole 7. Auto audio 8. Izvori muzike 9. Pulse Phone 10. Policija, komšije i admini 11. Jezici 12. Rješavanje problema 13. Ažuriranje

1. Zahtjevi

Ništa drugo: bez ox_lib, bez API ključa, bez Google računa.

Linux serveri: koristite Recommended server artifact, ne Latest. Na stranici za preuzimanje FiveM servera (docs.fivem.net/docs/server-download/) odaberite Linux i granu ažuriranja Recommended. Server na najnovijem Linux artifactu srušio se pri učitavanju (FXServer je ispisao dump /proc/self/maps), a prelazak na preporučeni artifact je to riješio. To je jedina prijava za Linux koju imamo; ZeroDev Sound još nismo sami pokrenuli na Linux serveru.

Na standalone serveru (bez frameworka) sve je besplatno: prodavnica i dijelovi za automobile ništa ne naplaćuju.

2. Instalacija

Korak 1. Ubacite folder. Stavite folder zerodev-sound u svoj folder resources (bilo koji podfolder je u redu, na primjer resources/[zerodev]/zerodev-sound). Zadržite ime foldera zerodev-sound: ox_inventory unosi predmeta pozivaju ga tim imenom.

Korak 2. Dodajte ga u server.cfg, nakon baze podataka, frameworka i inventara:

ensure oxmysql
ensure es_extended        # or qb-core / qbx_core, or nothing on a standalone server
ensure ox_inventory       # or your inventory
ensure ox_target          # optional, or qb-target
ensure phone              # optional: Pulse Phone
ensure zerodev-sound

Korak 3. Dajte adminima admin dozvolu (bez ograničenja zvučnika, lista /soundadmin, daljinsko zaustavljanje i uklanjanje):

add_ace group.admin zerodev.sound.admin allow

Korak 4. Podesite predmete za svoj inventar: odjeljak 3. Na ESX inventaru i na QBCore to se radi za vas.

Korak 5. Restartujte server (potpuni restart, ne samo resursa, kako bi svaki igrač učitao modele) i provjerite konzolu: odjeljak 4.

3. Predmeti za vaš inventar

Postoji 12 predmeta: deset zvučnika, stalak za mikrofon i komplet za popravku.

Slike se nalaze u zerodev-sound/web/img/items/. Nikad ne morate pogađati: kad god nešto nedostaje, konzola servera ispisuje tačne unose za vaš inventar i navodi svaku sliku koja još nije na mjestu.

Koji inventar imate?

Da predmete u qb-core dodate ručno umjesto da to uradi skripta, zalijepite QBCore blok u qb-core/shared/items.lua.

Drugi inventar koji kopira jedan od ovih API-ja: postavite Config.Inventory na taj (pogledajte odjeljak 5). Vlastiti inventar može se povezati u server/bridge.lua, koji je čitljiv: svaki inventar tamo čine tri male funkcije (prebroj, dodaj, ukloni).

ox_inventory blok

Zalijepite unutar tabele return { ... } u ox_inventory/data/items.lua:

    ['zds_repair_kit'] = { label = 'Speaker Repair Kit', weight = 600, stack = false, close = true, description = 'Fixes a broken speaker. Use it next to one.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_repair_kit.png' } },
    ['zds_roam'] = { label = 'Roam Portable Speaker', weight = 2000, stack = false, close = true, description = 'Portable speaker with twin bass radiators. Carry it or set it down.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_roam.png' } },
    ['zds_room_ceiling'] = { label = 'Ceiling Speaker', weight = 2000, stack = false, close = true, description = 'Indoor. Round ceiling or wall speaker for background music in a business.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_room_ceiling.png' } },
    ['zds_room_shelf'] = { label = 'Shelf Speaker', weight = 4000, stack = false, close = true, description = 'Indoor. Bookshelf speaker: link several around a home or shop.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_room_shelf.png' } },
    ['zds_room_sub'] = { label = 'Home Subwoofer', weight = 8000, stack = false, close = true, description = 'Indoor. Cube subwoofer: link it to your indoor speakers for deep bass.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_room_sub.png' } },
    ['zds_room_tower'] = { label = 'Tower Speaker', weight = 10000, stack = false, close = true, description = 'Indoor. Floor-standing tower with two woofers: deep, clean sound for a whole room.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_room_tower.png' } },
    ['zds_stage_array'] = { label = 'Line Array Speaker', weight = 12000, stack = false, close = true, description = 'Concert. Line-array speaker for long throw over a big crowd. Stack them.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_array.png' } },
    ['zds_stage_mic'] = { label = 'Mic Stand', weight = 3000, stack = false, close = true, description = 'Concert. A mic on a boom stand: link it to your concert speakers, stand at it and sing through them (/soundmic).',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_mic.png' } },
    ['zds_stage_mixer'] = { label = 'DJ Mixer', weight = 5000, stack = false, close = true, description = 'Concert. Not a speaker: whoever stands at it runs every linked concert speaker (volume, bass, sound, timing).',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_mixer.png' } },
    ['zds_stage_monitor'] = { label = 'Stage Monitor', weight = 6000, stack = false, close = true, description = 'Concert. Wedge monitor so the DJ or band hears the mix on stage.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_monitor.png' } },
    ['zds_stage_pa'] = { label = 'PA Speaker', weight = 10000, stack = false, close = true, description = 'Concert. Powered 15" PA top on a tripod: link many for an event.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_pa.png' } },
    ['zds_stage_sub'] = { label = 'Concert Subwoofer', weight = 15000, stack = false, close = true, description = 'Concert. Double 18" sub cabinet: the bass you feel at a show.',
        client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_sub.png' } },

QBCore blok

QBCore oblik predmeta, koji čitaju qb-, ps-, lj- i qs-inventory:

    ['zds_repair_kit'] = { name = 'zds_repair_kit', label = 'Speaker Repair Kit', weight = 600, type = 'item', image = 'zds_repair_kit.png', unique = true, useable = true, shouldClose = true, description = 'Fixes a broken speaker. Use it next to one.' },
    ['zds_roam'] = { name = 'zds_roam', label = 'Roam Portable Speaker', weight = 2000, type = 'item', image = 'zds_roam.png', unique = true, useable = true, shouldClose = true, description = 'Portable speaker with twin bass radiators. Carry it or set it down.' },
    ['zds_room_ceiling'] = { name = 'zds_room_ceiling', label = 'Ceiling Speaker', weight = 2000, type = 'item', image = 'zds_room_ceiling.png', unique = true, useable = true, shouldClose = true, description = 'Indoor. Round ceiling or wall speaker for background music in a business.' },
    ['zds_room_shelf'] = { name = 'zds_room_shelf', label = 'Shelf Speaker', weight = 4000, type = 'item', image = 'zds_room_shelf.png', unique = true, useable = true, shouldClose = true, description = 'Indoor. Bookshelf speaker: link several around a home or shop.' },
    ['zds_room_sub'] = { name = 'zds_room_sub', label = 'Home Subwoofer', weight = 8000, type = 'item', image = 'zds_room_sub.png', unique = true, useable = true, shouldClose = true, description = 'Indoor. Cube subwoofer: link it to your indoor speakers for deep bass.' },
    ['zds_room_tower'] = { name = 'zds_room_tower', label = 'Tower Speaker', weight = 10000, type = 'item', image = 'zds_room_tower.png', unique = true, useable = true, shouldClose = true, description = 'Indoor. Floor-standing tower with two woofers: deep, clean sound for a whole room.' },
    ['zds_stage_array'] = { name = 'zds_stage_array', label = 'Line Array Speaker', weight = 12000, type = 'item', image = 'zds_stage_array.png', unique = true, useable = true, shouldClose = true, description = 'Concert. Line-array speaker for long throw over a big crowd. Stack them.' },
    ['zds_stage_mic'] = { name = 'zds_stage_mic', label = 'Mic Stand', weight = 3000, type = 'item', image = 'zds_stage_mic.png', unique = true, useable = true, shouldClose = true, description = 'Concert. A mic on a boom stand: link it to your concert speakers, stand at it and sing through them (/soundmic).' },
    ['zds_stage_mixer'] = { name = 'zds_stage_mixer', label = 'DJ Mixer', weight = 5000, type = 'item', image = 'zds_stage_mixer.png', unique = true, useable = true, shouldClose = true, description = 'Concert. Not a speaker: whoever stands at it runs every linked concert speaker (volume, bass, sound, timing).' },
    ['zds_stage_monitor'] = { name = 'zds_stage_monitor', label = 'Stage Monitor', weight = 6000, type = 'item', image = 'zds_stage_monitor.png', unique = true, useable = true, shouldClose = true, description = 'Concert. Wedge monitor so the DJ or band hears the mix on stage.' },
    ['zds_stage_pa'] = { name = 'zds_stage_pa', label = 'PA Speaker', weight = 10000, type = 'item', image = 'zds_stage_pa.png', unique = true, useable = true, shouldClose = true, description = 'Concert. Powered 15" PA top on a tripod: link many for an event.' },
    ['zds_stage_sub'] = { name = 'zds_stage_sub', label = 'Concert Subwoofer', weight = 15000, type = 'item', image = 'zds_stage_sub.png', unique = true, useable = true, shouldClose = true, description = 'Concert. Double 18" sub cabinet: the bass you feel at a show.' },

Ako ste promijenili oznaku, cijenu ili težinu u config/catalogue.lua, umjesto toga kopirajte unose iz vlastite konzole: ona ih ispisuje prema vašim postavkama.

4. Prvo pokretanje: šta biste trebali vidjeti

U konzoli servera

ZeroDev Sound ispisuje jedan okvir s provjerom (upišite soundcheck u konzolu servera da se ponovo ispiše): baza podataka i shema, framework, novac, inventar i predmeti, tabela garaže, targeting, Pulse Phone, modeli, radionice za ugradnju i postavke promijenjene u igri. Svaka linija koja nije OK kaže šta treba uraditi; docs/SETUP.md prikazuje primjer, a docs/TROUBLESHOOTING.md objašnjava svaku liniju.

• Linija frameworka navodi šta je pronađeno. Ako je pogrešno, postavite Config.Framework ili Config.Inventory u config/config.lua.
• Žuta linija Add these to ox_inventory/data/items.lua ... (ili ... if these items are not in ... yet, add them) nakon koje slijede unosi predmeta: uradite odjeljak 3 za svoj inventar, a zatim restartujte. Poruka za ox_inventory prestaje kad su predmeti dodani. Na qs-, codem-, origen- i tgiann-inventory unosi se ispisuju pri svakom pokretanju kao podsjetnik, bez obzira jeste li ih dodali.
• Žuta linija Copy zds_....png from zerodev-sound/web/img/items into ...: te slike još nisu u folderu sa slikama vašeg inventara. Navodi folder.
• Pulse Phone app not registered: ...: Pulse Phone radi, ali je odbio aplikaciju. Pogledajte odjeljak 9.

U igri (pet provjera)

1. Mapa prikazuje blip ZeroDev Sound na Legion Square i blip Car audio bay kod Benny's.
2. U prodavnici prodavač stoji kod štanda s izloženim zvučnicima. Targetirajte prodavača (ili pritisnite E kada nema target resursa) i kupite Roam Portable Speaker.
3. Iskoristite ga iz inventara. Izlazi vam u ruke. Pritisnite E, otvorite Library i pustite Night Drive (demo pjesma koja dolazi sa skriptom). Ljudi oko vas je čuju.
4. Uđite u automobil. Prvih nekoliko puta, ugao ekrana kaže koja tipka otvara auto stereo (po zadanim postavkama K).
5. Uđite u radionicu za ugradnju auto audija kao vozač i pritisnite E. Instaler se otvara na vašem automobilu.

5. Postavke koje se najčešće mijenjaju

U igri: /soundadmin > Settings mijenja uobičajene postavke uživo za sve (radionice za ugradnju, ko može ugrađivati, koji automobili, cijene, najjača jačina zvuka, tihi sati, ograničenja, prodavnica, policija i oštećenja). Spremaju se u bazu podataka i imaju prednost nad config.lua dok u panelu ne pritisnete Reset to config.

Sve je u config/config.lua osim ako nije drugačije navedeno. Proizvodi, cijene i dijelovi za automobile nalaze se u config/catalogue.lua; fabrički zvuk svakog automobila je u config/vehicles.lua.

Imena predmeta. Ako druga skripta već koristi neko od imena predmeta zds_, preimenujte ključ tog proizvoda u Catalogue.Speakers (na primjer zds_roam = { ... }), zatim koristite novo ime u svom inventaru i preimenujte odgovarajuću sliku.

6. Kontrole

U daljinskom: Music (biblioteka vašeg servera), Queue (sljedeće na redu, spremljene playliste), Speakers (snaga i glasnoća svakog zvučnika, povezivanje, spremanje) i Tune (šest zvučnih modova, trobandni ekvilajzer, ko bira muziku, radno vrijeme i "Real distance" za koncertne postavke). Ko bira muziku: Only me; Party, gdje bilo ko u blizini može tražiti pjesme koje vlasnik odobrava; ili Anyone, gdje ljudi u blizini mogu puštati, pauzirati, preskakivati, dodavati u red i premotavati. Opening hours samostalno puštaju jednu od vlasnikovih playlisti između dva sata, za prodavnicu ili klub.

Mikrofon (potreban je pma-voice). Dok ga držite, svi u blizini bilo kojeg zvučnika tog sistema čuju vaš glas kroz njega, sa zvukom razglasa, glasno koliko taj zvučnik pušta muziku i daleko koliko se on čuje. Udaljite se 4 m od miksete ili stalka za mikrofon, prekinite vezu ili vratite mikrofon i vaš glas je ponovo normalan. Kroz sistem može pjevati samo njegov vlasnik (a za automobil i admini); dajte drugim igračima ace zds.mic da bi mogli koristiti bilo koji sistem. Vaš glas se ne čuje sa mjesta svakog zvučnika: glasovni chat ne može tamo smjestiti glas, pa vas ljudi pored zvučnika čuju jačinom tog zvučnika. Postavke: Config.Mic.

7. Auto audio

Kako igrači opremaju automobile

1. Uđite u radionicu za ugradnju auto audija (po zadanim postavkama Benny's) i pritisnite E kao vozač.
2. Počnite od gotovog kompleta (Daily thump, Competition, Trunk wall, Sound quality, Clean and hidden) ili odaberite dijelove: subwoofere (od 8" do 18"), kutije, pojačala, zvučnike u vratima, visokotonce, kućišta, lažne podove, panele, pleksiglas, kondenzator, drugu bateriju, LED traku i head unit.
3. Prevucite svaki dio na mjesto u automobilu. Subovi upadaju u otvore svoje kutije. Svaki dio dobija završnu obradu (osam boja), a subovi i zvučnici rešetku i svjetlosni prsten. Mirror kopira dio na drugu stranu; Fine position ga pomjera u malim koracima. Pet pogleda kamere: Boot, Cabin, Side, Front, Top. Size: subovi dolaze u 8", 10", 12", 15" i 18" (svi subovi u jednoj kutiji su iste veličine, a kutija se gradi oko njih, do 30% veća ili manja nego što je napravljena); zvučnici u vratima u 5.25", 6.5" i 6x9"; svi ostali dijelovi od 80% do 130% u koracima od 5% (head unit je standardne veličine). Veće kutije i paneli koštaju više; smanjeni dio ne košta ništa. Membrane se više pomiču na većim zvučnicima, a veći zvučnik u vratima ide niže.
4. Pritisnite Test system da čujete kako konfiguracija svira kroz automobil prije plaćanja. Pušta prvu pjesmu iz Config.Library (isporučenu demo pjesmu, osim ako ste je promijenili).
5. Pritisnite Install. Naplaćuju se samo dijelovi koji su novi za automobil; dijelovi zadržani iz posljednje ugradnje ne naplaćuju se ponovo.

Ugradnja se sprema uz tablicu i vraća se kad god se vrati automobil: iz bilo koje garaže, zapljene ili respawna. U vašoj skripti za garaže ništa se ne mijenja.

Šta igrači čuju

• Svaki automobil već ima fabrički zvuk prema klasi i modelu: sistem s 4 zvučnika, premium s 10 zvučnika ili referentni sistem s 13 zvučnika, zvučnike u oplati na motorima; bicikli, letjelice i vozovi nemaju zvuk. Ugrađeni zvučnici zamjenjuju fabričke zvučnike koji su im najbliži; subovi se dodaju.
• Izvan automobila kroz karoseriju uglavnom prolazi bas. Otvorena vrata, otvoreni prozori i otvoren prtljažnik svaki puštaju više zvuka, prema strani na koju su okrenuti.
• Automobil sa subovima lagano poskakuje na oprugama uz bas dok je parkiran ili mili (nikad tokom vožnje), a svi unutra osjećaju udarac.
• Stereo (K) ima jačinu zvuka, nivo suba, fader i balans.
• Subovi koji se neko vrijeme tjeraju daleko preko onoga što njihovo pojačalo i specifikacija dozvoljavaju, blizu pune jačine, mogu pregorjeti. Svi blizu automobila vide tanak pramen dima iz tog suba i čuju tup prasak. Pregorjeli sub prestaje se pomicati, bas pada, a membrana ostaje nagorjela dok se ne zamijeni u radionici (novi sub se plaća; uklanjanje tragova nije besplatna popravka). Osoblje to može pokazati: /soundblow u automobilu ili soundblow <plate> u konzoli servera.

Koji se automobili mogu opremiti (Config.Install.vehicles)

• 'owned' (zadano): samo automobili iz tabele vozila u vlasništvu vašeg frameworka (owned_vehicles na ESX, player_vehicles na QBCore i Qbox).
• 'any': i automobili koje niko ne posjeduje (NPC automobili, spawnani automobili, iznajmljeni).
• U svakom slučaju, automobil koji posjeduje drugi igrač ostaje njegov: mijenjati ga može samo vlasnik, mehaničar na dužnosti iz Config.Install.jobs ili admin. Na standalone serveru svaki automobil se računa kao posjedovan.

Garaže, tablice i zapljene

• Tablice se upoređuju bez razmaka na krajevima i velikim slovima, pa se poklapaju i kod garaža koje dopunjuju razmacima ili mijenjaju veličinu slova.
• Automobil s lažnom ili promijenjenom tablicom ne pronalazi svoju ugradnju dok ponovo ne dobije spremljenu tablicu.
• Automobili koji postoje samo na ekranu jednog igrača (pregledi u garaži, neki automobili u salonu) nikad ne dobijaju ugradnju: za sve ostale to nisu pravi automobili.

Druge skripte za zvuk ili stereo

ZeroDev Sound je zaseban resurs s vlastitim komandama (/sound, /caraudio, ...), eventima i state bagovima vozila, pa ne zamjenjuje niti mijenja druge skripte (dok svira u automobilu samo isključuje GTA vlastiti auto radio). Pokretanje dvije skripte za auto audio na istom automobilu istovremeno nije testirano zajedno: koristite jedan stereo po automobilu.

8. Izvori muzike

Muzika se reprodukuje samo iz audio datoteka koje dodate u resurs. Igrači biraju s vaše liste; ne mogu unositi linkove i nijedna web adresa se nikada ne reprodukuje. Dodajte samo zvuk koji posjedujete ili za koji imate pravo korištenja i distribucije.

• Stavite mp3 ili ogg datoteke u zerodev-sound/web/library/ i navedite svaku u Config.Library kao { title = '...', artist = '...', file = 'name.mp3' }. Dobijaju puno iskustvo: 3D zvuk, prostorije i zidove, kabine automobila, zvučne modove, EQ i čunjeve koji se kreću uz pravi bas.
• Config.Sources.library = false isključuje biblioteku.
• GTA-in vlastiti auto radio i dalje radi u svakom automobilu dok se u njemu ne reprodukuje nijedna pjesma iz ovog resursa.
• Početni okvir prikazuje koliko pjesama igrači mogu odabrati i upozorava na svaki preskočen unos (naziv datoteke koji nije mp3 ili ogg unutar web/library/).
• Ažuriranje s 3.0.0: spremljene pjesme, nedavne pjesme i stavke playlisti koje su bile linkovi više se ne prikazuju niti reprodukuju. Pjesme iz biblioteke i dalje rade.

9. Pulse Phone

Ništa se ne podešava. Kada Pulse Phone radi na serveru (ime resursa phone, bilo koje izdanje):

• Svaki telefon dobija aplikaciju Sound na Home Screenu. To je isti daljinski kao /sound: spojite se na zvučnik ili automobil, odaberite muziku, upravljajte cijelom grupom. Igrači je mogu ukloniti i ponovo je dobiti iz App Huba.
• Ono što svira na povezanom zvučniku ili automobilu, s preostalim vremenom, prikazuje se na Islandu i Lock Screenu. Dodir otvara aplikaciju Sound.
• Pulse Drive (Pulseov ekran u automobilu, po zadanim postavkama F10) prikazuje stereo automobila u kojem sjedite: pjesmu, izvođača i omot, s opcijama za puštanje, pauzu, prethodnu, sljedeću i jačinu zvuka te dugmetom Open za aplikaciju Sound. Za to je potreban Pulse Phone 1.2.9 ili noviji; starije verzije to jednostavno ne prikazuju.

Igrači bez telefona koriste /sound i K, koji rade sve što radi i aplikacija.

Ako ste preimenovali folder telefona, dodajte ovu liniju u config/config.lua s njegovim imenom:

Config.PulseResource = 'phone'

10. Policija, komšije i admini

11. Jezici

Skripta dolazi na istih 25 jezika kao Pulse Phone. Jezik postavite u config/config.lua:

Na primjer Config.Locale = 'de'. Zadana vrijednost 'auto' prati Pulse Phone: server preuzima Config.Locale iz Pulsea, a svaki igrač dobija Sound na jeziku koji je izabrao na svom telefonu. Bez Pulsea je na engleskom. Poruke u igri, upiti za tipke, nazivi predmeta i naziv tipke za stereo nalaze se u locales/<code>.lua; interfejs (daljinski, auto stereo, prodavnica, instaler, Pulse aplikacija) je u locales/<code>_ui.lua. Sve što nedostaje prikazuje se na engleskom.

Da biste promijenili red, uredite ga u fajlu tog jezika. Svaki %s, %d, %.1f, %% i ~a~ ostavite kakav jeste. Da biste dodali svoj jezik, kopirajte locales/en.lua u locales/xx.lua, promijenite Locales['en'] u Locales['xx'] (na oba mjesta), prevedite tekst između navodnika i postavite Config.Locale = 'xx'. locales/ui_strings.txt navodi svaki ključ interfejsa za xx_ui.lua.

12. Rješavanje problema

Igrači ne mogu koristiti predmete zvučnika

• ox_inventory: unosi moraju biti unutar ox_inventory/data/items.lua sa svojom linijom client, a ox_inventory se mora restartovati nakon lijepljenja. Folder se i dalje mora zvati zerodev-sound (unosi pozivaju zerodev-sound.useItem).
• QBCore / ESX: zerodev-sound se mora pokretati nakon vašeg frameworka u server.cfg.
• codem-inventory na QBCore: završite korak samog codem-inventoryja koji usmjerava QBCore.Functions.UseItem na njega.
• Bez inventara: zvučnici nisu predmeti. Igrači otvaraju /sound i pritiskaju Set up pod Your speakers.

Slike predmeta nedostaju

• ox_inventory: ništa se ne kopira; putanja slike upućuje na zerodev-sound. Ako su prazne, provjerite liniju image = 'nui://zerodev-sound/...' u unosu i ime foldera.
• Ostali inventari: pročitajte liniju u konzoli Copy ... into ...: navodi slike koje nedostaju i folder u koji idu. Kopirajte ih iz zerodev-sound/web/img/items/ i restartujte inventar.

Igrač ne može pustiti link

To je namjerno: igrači biraju samo iz vaše biblioteke. Dodajte pjesmu u Config.Library (odjeljak 8).

Uopće nema zvuka

• Ugrađeni preglednik FiveM-a pokreće zvuk bez klika, pa igrači nikad ne moraju ništa pritisnuti da "dozvole" zvuk. Ako jedan igrač ništa ne čuje dok ostali čuju, provjerite FiveM u njegovom Windows mikseru jačine zvuka.
• Provjerite zvučnik u kartici Speakers na daljinskom: možda je isključen ili Broken.
• Policija ga je možda isključila (na Config.Police.silenceMinutes) ili tihi sati možda ograničavaju jačinu zvuka (Config.QuietHours).
• Igrač čuje najviše Config.Streaming.maxAudibleSessions zasebnih pjesama odjednom (6), prvo najbliže.
• Test system u instaleru je tih kada je Config.Library prazan ili je Config.Sources.library = false: pušta prvu pjesmu iz biblioteke.

Prodavnice nema

• Config.Shop.enabled mora biti true.
• Prodavač i štand pojavljuju se samo kada je igrač na oko 70 m od Config.Shop.locations, i to samo na ekranu tog igrača. Provjerite koordinate koje ste postavili.
• Uz ox_target ili qb-target targetirajte prodavača. Bez njih stanite kod prodavača: E Browse speakers.

Zvučnik se prikazuje kao obični GTA zvučnik ili se uopće ne prikazuje

Folder stream/ nedostaje ili je preimenovan, ili se igrač pridružio prije nego što se resurs pokrenuo. Restartujte server i ponovo se povežite.

Poruke auto audija i šta znače

Policija ne vidi svoje opcije

Dodajte imena svojih policijskih poslova u Config.Police.jobs. Igrači moraju biti na dužnosti.

13. Ažuriranje

Prelazak s 1.x na 2.0: pročitajte UPGRADING.md. Između 2.x verzija:

1. Napravite rezervnu kopiju foldera config/, foldera locales/ ako ste ga prevodili i svih pjesama koje ste dodali u web/library/.
2. Zaustavite server. Zamijenite folder zerodev-sound novim (zadržite ime).
3. Vratite svoje fajlove u config/. Ako bilješke o ažuriranju spominju nove postavke, kopirajte te linije iz novih fajlova u svoje.
4. Pokrenite server i pročitajte konzolu. Novi predmeti, ako ih ima, ispisuju se za vaš inventar.

Postavljeni zvučnici, ugradnje u automobile i playliste čuvaju se u bazi podataka (zds_speakers, zds_car_builds, zds_playlists, zds_stash) i ažuriranje ih ne dira.

Vraćanje na staru verziju: držite prethodni folder zerodev-sound izvan resources dok nova verzija ne bude radila dobro i napravite backup baze podataka prije ažuriranja. Za vraćanje zaustavite server, vratite prethodni folder i svoj config/ i pokrenite ga. Vraćanje s 3.0 na 2.x na istoj bazi podataka nije testirano, pa vratite backup baze ako išta izgleda pogrešno.