ZeroDev Sound: návod k instalaci

Tento resource neobsahuje ani neposkytuje žádné integrace zvuku či hudby třetích stran. Hudba hraje pouze ze zvukových souborů, které majitel serveru přidá do resource, a z vestavěného rádia GTA. Hráči nemohou zadávat odkazy. Přidávejte jen zvuk, který vlastníte nebo ke kterému máte práva ho používat a šířit; streamování obsahu bez povolení může porušovat Cfx.re Creator Platform License Agreement i zákon.

Reproduktory, které si hráči koupí, nosí, postaví a propojí, a car audio, které si postaví do vlastních aut. Toto je kompletní reference. Pro krátkou verzi si přečtěte docs/SETUP.md (5 kroků); pro problémy docs/TROUBLESHOOTING.md; při přechodu z 1.x UPGRADING.md.

Obsah 1. Požadavky 2. Instalace 3. Předměty pro váš inventář 4. První start: co byste měli vidět 5. Nejčastěji měněná nastavení 6. Ovládání 7. Car audio 8. Zdroje hudby 9. Pulse Phone 10. Policie, sousedé a admini 11. Jazyky 12. Řešení problémů 13. Aktualizace

1. Požadavky

Nic dalšího: žádný ox_lib, žádný API klíč, žádný účet Google.

Linuxové servery: použijte server artifact Recommended, ne Latest. Na stránce pro stažení FiveM serveru (docs.fivem.net/docs/server-download/) zvolte Linux a větev aktualizací Recommended. Server na nejnovějším linuxovém artifactu spadl při načítání (FXServer vypsal dump /proc/self/maps) a přechod na doporučený artifact to vyřešil. Je to jediné hlášení z Linuxu, které máme; sami jsme ZeroDev Sound na linuxovém serveru zatím nespouštěli.

Na standalone serveru (bez frameworku) je všechno zdarma: obchod ani díly do aut nic neúčtují.

2. Instalace

Krok 1. Vložte složku. Dejte složku zerodev-sound do své složky resources (jakákoli podsložka je v pořádku, například resources/[zerodev]/zerodev-sound). Ponechte název složky zerodev-sound: záznamy předmětů v ox_inventory ji volají tímto názvem.

Krok 2. Přidejte ji do server.cfg, za databázi, framework a inventář:

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

Krok 3. Dejte adminům administrátorské oprávnění (bez limitu reproduktorů, seznam /soundadmin, vzdálené zastavení a odebrání):

add_ace group.admin zerodev.sound.admin allow

Krok 4. Nastavte předměty pro svůj inventář: sekce 3. Na inventáři ESX a na QBCore se to udělá za vás.

Krok 5. Restartujte server (celý restart, ne jen resource, aby si každý hráč načetl modely) a zkontrolujte konzoli: sekce 4.

3. Předměty pro váš inventář

Předmětů je 12: deset reproduktorů, mikrofonní stojan a opravná sada.

Obrázky jsou v zerodev-sound/web/img/items/. Nikdy nemusíte hádat: kdykoli něco chybí, konzole serveru vypíše přesné záznamy pro váš inventář a uvede každý obrázek, který ještě není na svém místě.

Jaký inventář máte?

Pokud chcete předměty do qb-core přidat ručně, místo aby to udělal script, vložte blok pro QBCore do qb-core/shared/items.lua.

Jiný inventář, který kopíruje některé z těchto API: nastavte Config.Inventory na ten, který kopíruje (viz sekce 5). Interní inventář lze připojit v server/bridge.lua, který je čitelný: každý inventář tam tvoří tři malé funkce (počet, přidání, odebrání).

Blok pro ox_inventory

Vložte dovnitř tabulky return { ... } v 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' } },

Blok pro QBCore

Tvar předmětu QBCore, který čtou 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.' },

Pokud jste změnili popisek, cenu nebo váhu v config/catalogue.lua, zkopírujte místo toho záznamy z vlastní konzole: vypíše je podle vašeho nastavení.

4. První start: co byste měli vidět

V konzoli serveru

ZeroDev Sound vypíše jeden kontrolní rámeček (napište soundcheck do konzole serveru a vypíše se znovu): databáze a schéma, framework, peníze, inventář a předměty, tabulka garáží, target, Pulse Phone, modely, montážní dílny a nastavení změněná ve hře. Každý řádek, který není OK, říká, co dělat; docs/SETUP.md ukazuje ukázku a docs/TROUBLESHOOTING.md vysvětluje každý řádek.

• Řádek frameworku uvádí, co bylo nalezeno. Pokud je to špatně, nastavte Config.Framework nebo Config.Inventory v config/config.lua.
• Žlutý řádek Add these to ox_inventory/data/items.lua ... (nebo ... if these items are not in ... yet, add them) následovaný záznamy předmětů: proveďte sekci 3 pro svůj inventář a restartujte. Hláška pro ox_inventory zmizí, jakmile jsou předměty na místě. Na qs-, codem-, origen- a tgiann-inventory se záznamy vypisují při každém startu jako připomínka, ať už jste je přidali, nebo ne.
• Žlutý řádek Copy zds_....png from zerodev-sound/web/img/items into ...: tyto obrázky ještě nejsou ve složce obrázků vašeho inventáře. Řádek složku uvádí.
• Pulse Phone app not registered: ...: Pulse Phone běží, ale aplikaci odmítl. Viz sekce 9.

Ve hře (pět kontrol)

1. Mapa ukazuje blip ZeroDev Sound na Legion Square a blip Car audio bay u Benny's.
2. V obchodě stojí prodavač u stánku s vystavenými reproduktory. Zaměřte prodavače (nebo stiskněte E, když není target resource) a kupte Roam Portable Speaker.
3. Použijte ho z inventáře. Objeví se vám v rukou. Stiskněte E, otevřete Library a pusťte Night Drive (demo skladba dodávaná se scriptem). Lidé kolem vás ji slyší.
4. Nastupte do auta. Prvních několikrát se v rohu obrazovky ukáže, která klávesa otevírá autorádio (ve výchozím stavu K).
5. Zajeďte jako řidič do montážní dílny car audia a stiskněte E. Montážní menu se otevře na vašem autě.

5. Nejčastěji měněná nastavení

Ve hře: /soundadmin > Settings mění ta běžná nastavení živě pro všechny (montážní dílny, kdo smí montovat, která auta, ceny, maximální hlasitost, noční klid, limity, obchod, policie a poškození). Ukládají se do databáze a mají přednost před config.lua, dokud v panelu nestisknete Reset to config.

Pokud není uvedeno jinak, je vše v config/config.lua. Produkty, ceny a díly do aut jsou v config/catalogue.lua; tovární zvuk každého auta je v config/vehicles.lua.

Názvy předmětů. Pokud jiný script už používá některý z názvů předmětů zds_, přejmenujte klíč daného produktu v Catalogue.Speakers (například zds_roam = { ... }), pak použijte nový název ve svém inventáři a odpovídajícím způsobem přejmenujte jeho obrázek.

6. Ovládání

V ovladači: Music (knihovna vašeho serveru), Queue (co hraje dál, uložené playlisty), Speakers (výkon a hlasitost každého reproduktoru, propojení, sbalení) a Tune (šest zvukových režimů, třípásmový ekvalizér, kdo vybírá hudbu, otevírací doba a "Real distance" pro koncertní sestavy). Kdo vybírá hudbu: Only me; Party, kde mohou lidé poblíž žádat písně ke schválení majitelem; nebo Anyone, kde lidé poblíž mohou přehrávat, pauzovat, přeskakovat, řadit do fronty a přetáčet. Opening hours samy přehrají v určenou dobu jeden z playlistů majitele, pro obchod nebo klub.

Mikrofon (vyžaduje pma-voice). Dokud ho držíte, slyší váš hlas každý v blízkosti kteréhokoli reproduktoru daného systému, se zvukem jako z PA, stejně hlasitě, jak ten reproduktor hraje hudbu, a stejně daleko, kam dosáhne; odejděte 4 m od mixpultu nebo mikrofonního stojanu, odpojte se nebo mikrofon vraťte a váš hlas je zase normální. Zpívat přes systém může jen jeho vlastník (a u auta admini); dejte ostatním hráčům ace zds.mic, aby mohli používat jakýkoli systém. Váš hlas nezní z místa každého reproduktoru: voice chat tam hlas umístit neumí, takže lidé u reproduktoru vás místo toho slyší s hlasitostí toho reproduktoru. Nastavení: Config.Mic.

7. Car audio

Jak hráči staví

1. Zajeďte do montážní dílny car audia (ve výchozím stavu Benny's) a jako řidič stiskněte E.
2. Začněte z hotové sady (Daily thump, Competition, Trunk wall, Sound quality, Clean and hidden) nebo si vyberte díly: subwoofery (8" až 18"), boxy, zesilovače, dveřní reproduktory, výškové reproduktory, pody, falešné podlahy, panely, plexi, kondenzátor, druhou baterii, LED pásek a head unit.
3. Každý díl přetáhněte na místo v autě. Suby zapadnou do výřezů svého boxu. Každý díl dostane povrchovou úpravu (osm barev) a suby a reproduktory mřížku a světelný prstenec. Mirror zkopíruje díl na druhou stranu; Fine position ho posouvá po malých krocích. Pět pohledů kamery: Boot, Cabin, Side, Front, Top. Size: suby jsou v 8", 10", 12", 15" a 18" (všechny suby v boxu mají stejnou velikost a box se postaví kolem nich, až o 30 % větší nebo menší, než pro jaký byl navržen); dveřní reproduktory v 5.25", 6.5" a 6x9"; každý další díl od 80 % do 130 % po 5 % (head unit má standardní velikost). Větší boxy a panely stojí víc; zmenšený díl nestojí nic. Na větších měničích mají membrány větší zdvih a větší dveřní reproduktor sahá níž.
4. Stiskněte Test system a před zaplacením si poslechněte, jak sestava hraje v autě. Přehraje první skladbu v Config.Library (dodanou demo skladbu, pokud jste ji nezměnili).
5. Stiskněte Install. Účtují se jen díly, které jsou v autě nové; díly ponechané z minulé instalace se znovu neúčtují.

Instalace se uloží podle SPZ a vrátí se, kdykoli se vrátí auto: z jakékoli garáže, odtahovky nebo respawnu. Ve vašem garážovém scriptu není co upravovat.

Co hráči slyší

• Každé auto už má tovární zvuk podle třídy a modelu: 4reproduktorový systém, prémiový 10reproduktorový nebo referenční 13reproduktorový systém, reproduktory v kapotáži na motorkách; kola, letadla a vlaky nemají žádný. Namontované reproduktory nahradí tovární reproduktory nejblíže k nim; suby se k němu přidají.
• Mimo auto prochází karoserií hlavně basy. Otevřené dveře, otevřená okna a otevřený kufr pustí ven víc, směrem ke straně, kam míří.
• Auto se suby jemně poskakuje na pružinách do basů, když parkuje nebo se plazí (nikdy za jízdy), a všichni uvnitř cítí kopák.
• Autorádio (K) má hlasitost, úroveň subu, fader a balance.
• Suby hnané dlouho daleko nad to, co dovoluje jejich zesilovač a parametry, při téměř plné hlasitosti, se mohou spálit. Každý poblíž auta uvidí tenký obláček kouře z daného subu a uslyší tupé lupnutí. Spálený sub se přestane hýbat, basy klesnou a jeho membrána zůstane ohořelá, dokud ho v dílně nevyměníte (nový sub se platí; odstranění stopy není bezplatná oprava). Personál to může předvést: /soundblow v autě, nebo soundblow <plate> v konzoli serveru.

Která auta lze osadit (Config.Install.vehicles)

• 'owned' (výchozí): jen auta z tabulky vlastněných vozidel vašeho frameworku (owned_vehicles na ESX, player_vehicles na QBCore a Qbox).
• 'any': i auta, která nikdo nevlastní (NPC auta, spawnutá auta, půjčená auta).
• Tak či tak auto, které vlastní jiný hráč, zůstává jeho: změnit ho může jen jeho majitel, mechanik ve službě z Config.Install.jobs, nebo admin. Na standalone serveru se každé auto počítá jako vlastněné.

Garáže, SPZ a odtahovky

• SPZ se porovnávají oříznuté a velkými písmeny, takže se shodují i u garáží, které SPZ doplňují mezerami nebo mění velikost písmen.
• Auto s falešnou nebo změněnou SPZ svou instalaci nenajde, dokud nebude mít znovu uloženou SPZ.
• Auta, která existují jen na obrazovce jednoho hráče (náhledy v garáži, některá auta v showroomu), instalaci nikdy nedostanou: pro nikoho jiného to nejsou skutečná auta.

Jiné zvukové nebo audio scripty

ZeroDev Sound je samostatný resource s vlastními příkazy (/sound, /caraudio, ...), eventy a state bagy vozidel, takže jiné scripty nenahrazuje ani nemění (když hraje v autě, vypne jen vlastní autorádio GTA). Provoz dvou car-audio scriptů na stejném autě najednou nebyl společně testován: používejte jedno audio na auto.

8. Zdroje hudby

Hudba hraje jen ze zvukových souborů, které přidáte do resource. Hráči vybírají z vašeho seznamu; nemohou zadávat odkazy a žádná webová adresa se nikdy nepřehraje. Přidávejte jen zvuk, který vlastníte nebo ke kterému máte práva ho používat a šířit.

• Vložte soubory mp3 nebo ogg do zerodev-sound/web/library/ a každý uveďte v Config.Library jako { title = '...', artist = '...', file = 'name.mp3' }. Dostanou plný zážitek: 3D zvuk, místnosti a stěny, kabiny aut, zvukové režimy, EQ a kužely, které se hýbou se skutečnými basy.
• Config.Sources.library = false knihovnu vypne.
• Vlastní autorádio GTA dál funguje v každém autě, dokud se v něm nepřehrává žádná píseň z tohoto resource.
• Úvodní okno ukazuje, kolik písní mohou hráči vybírat, a upozorní na každou přeskočenou položku (název souboru, který není mp3 ani ogg, v web/library/).
• Aktualizace z 3.0.0: uložené písně, nedávné písně a položky playlistů, které byly odkazy, se už nezobrazují ani nepřehrávají. Písně z knihovny dál fungují.

9. Pulse Phone

Nic se nenastavuje. Když na serveru běží Pulse Phone (název resource phone, kterákoli edice):

• Každý telefon dostane na domovskou obrazovku aplikaci Sound. Je to stejný ovladač jako /sound: připojte se k reproduktoru nebo autu, vyberte hudbu, řiďte celou skupinu. Hráči ji mohou odebrat a znovu získat z App Hub.
• Co hraje na připojeném reproduktoru nebo v autě, i se zbývajícím časem, se zobrazí v Islandu a na zamykací obrazovce. Klepnutí otevře aplikaci Sound.
• Pulse Drive (displej v autě od Pulse, ve výchozím stavu F10) ukazuje audio auta, ve kterém sedíte: skladbu, interpreta a obal, s přehráním, pauzou, předchozí, další a hlasitostí a tlačítkem Open pro aplikaci Sound. Vyžaduje Pulse Phone 1.2.9 nebo novější; starší verze to prostě nezobrazí.

Hráči bez telefonu používají /sound a K, které umí vše co aplikace.

Pokud jste přejmenovali složku telefonu, přidejte tento řádek s jejím názvem do config/config.lua:

Config.PulseResource = 'phone'

10. Policie, sousedé a admini

11. Jazyky

Script je dodáván ve stejných 25 jazycích jako Pulse Phone. Jazyk nastavíte v config/config.lua:

Například Config.Locale = 'de'. Výchozí hodnota 'auto' se řídí podle Pulse Phone: server převezme Config.Locale z Pulse a každý hráč dostane Sound v jazyce, který si vybral v telefonu. Bez Pulse je vše anglicky. Herní hlášky, výzvy ke stisku kláves, názvy předmětů a název klávesy pro autorádio jsou v locales/<code>.lua; rozhraní (ovladač, autorádio, obchod, montážní menu, aplikace v Pulse) je v locales/<code>_ui.lua. Cokoli chybí, zobrazí se anglicky.

Chcete-li změnit řádek, upravte ho v souboru daného jazyka. Ponechte každé %s, %d, %.1f, %% a ~a~ tak, jak je. Chcete-li přidat vlastní jazyk, zkopírujte locales/en.lua do locales/xx.lua, změňte Locales['en'] na Locales['xx'] (na obou místech), přeložte text mezi uvozovkami a nastavte Config.Locale = 'xx'. locales/ui_strings.txt uvádí všechny klíče rozhraní pro xx_ui.lua.

12. Řešení problémů

Hráči nemohou použít předměty reproduktorů

• ox_inventory: záznamy musí být uvnitř ox_inventory/data/items.lua se svým řádkem client a ox_inventory musí být po vložení restartovaný. Složka se musí stále jmenovat zerodev-sound (záznamy volají zerodev-sound.useItem).
• QBCore / ESX: zerodev-sound musí v server.cfg startovat až po vašem frameworku.
• codem-inventory na QBCore: dokončete vlastní krok codem-inventory, který na něj nasměruje QBCore.Functions.UseItem.
• Bez inventáře: reproduktory nejsou předměty. Hráči otevřou /sound a stisknou Set up pod Your speakers.

Chybí obrázky předmětů

• ox_inventory: nic se nekopíruje; cesta k obrázku vede do zerodev-sound. Pokud jsou prázdné, zkontrolujte v záznamu řádek image = 'nui://zerodev-sound/...' a název složky.
• Ostatní inventáře: přečtěte si řádek konzole Copy ... into ...: uvádí chybějící obrázky a složku, kam patří. Zkopírujte je ze zerodev-sound/web/img/items/ a restartujte inventář.

Hráč nemůže přehrát odkaz

Je to záměr: hráči vybírají jen z vaší knihovny. Přidejte píseň do Config.Library (sekce 8).

Vůbec žádný zvuk

• Vestavěný prohlížeč FiveM spouští zvuk bez kliknutí, takže hráči nikdy nemusí nic mačkat, aby zvuk „povolili“. Pokud jeden hráč nic neslyší, zatímco ostatní ano, zkontrolujte FiveM v jeho směšovači hlasitosti ve Windows.
• Zkontrolujte reproduktor v záložce Speakers ovladače: může být vypnutý, nebo Broken.
• Mohla ho vypnout policie (na Config.Police.silenceMinutes), nebo noční klid omezuje hlasitost (Config.QuietHours).
• Hráč slyší najednou nejvýše Config.Streaming.maxAudibleSessions různých skladeb (6), nejbližší přednostně.
• Test system v montážním menu je potichu, když je Config.Library prázdné nebo Config.Sources.library = false: přehrává první skladbu z knihovny.

Obchod tam není

• Config.Shop.enabled musí být true.
• Prodavač a stánek se objeví, jen když je hráč do zhruba 70 m od Config.Shop.locations, a jen na obrazovce tohoto hráče. Zkontrolujte nastavené souřadnice.
• S ox_target nebo qb-target zaměřte prodavače. Bez nich stoupněte k prodavači: E Browse speakers.

Reproduktor se zobrazí jako obyčejný reproduktor z GTA, nebo vůbec

Složka stream/ chybí nebo byla přejmenována, nebo se hráč připojil dřív, než resource nastartoval. Restartujte server a připojte se znovu.

Hlášky car audia a co znamenají

Policie nevidí své možnosti

Přidejte názvy svých policejních jobů do Config.Police.jobs. Hráči musí být ve službě.

13. Aktualizace

Přechod z 1.x na 2.0: přečtěte si UPGRADING.md. Mezi verzemi 2.x:

1. Zálohujte svou složku config/, locales/, pokud jste ji překládali, a všechny skladby, které jste přidali do web/library/.
2. Zastavte server. Nahraďte složku zerodev-sound novou (název ponechte).
3. Vraťte zpět své soubory v config/. Pokud poznámky k aktualizaci zmiňují nová nastavení, zkopírujte ty řádky z nových souborů do svých.
4. Spusťte server a přečtěte si konzoli. Případné nové předměty se vypíšou pro váš inventář.

Umístěné reproduktory, instalace v autech a playlisty jsou uložené v databázi (zds_speakers, zds_car_builds, zds_playlists, zds_stash) a aktualizace se jich nedotkne.

Návrat zpět: předchozí složku zerodev-sound si nechte mimo resources, dokud nová verze nepoběží dobře, a před aktualizací zálohujte databázi. Pro návrat zastavte server, vraťte zpět předchozí složku a svůj config/ a server spusťte. Návrat z 3.0 na 2.x se stejnou databází nebyl testován, takže pokud něco nevypadá dobře, obnovte zálohu databáze.