ZeroDev Sound: telepítési útmutató

Ez a resource nem tartalmaz és nem biztosít semmilyen harmadik féltől származó hang- vagy zeneintegrációt. A zene csak olyan hangfájlokból szól, amelyeket a szerver tulajdonosa ad hozzá a resource-hoz, valamint a GTA beépített rádiójából. A játékosok nem adhatnak meg linkeket. Csak olyan hangot adj hozzá, amelynek a tulajdonosa vagy felhasználására és terjesztésére jogosult vagy; a tartalom engedély nélküli streamelése sértheti a Cfx.re Creator Platform License Agreementet és a törvényt.

Hangszórók, amelyeket a játékosok megvesznek, magukkal visznek, letesznek és összekapcsolnak, és autóhifi, amelyet a saját autóikba építenek. Ez a teljes referencia. A rövid változatért olvasd el a docs/SETUP.md fájlt (5 lépés); problémák esetén a docs/TROUBLESHOOTING.md fájlt; 1.x-ről érkezve az UPGRADING.md fájlt.

Tartalom 1. Követelmények 2. Telepítés 3. Tárgyak az inventorydhoz 4. Első indítás: mit kell látnod 5. A leggyakrabban módosított beállítások 6. Vezérlés 7. Autóhifi 8. Zeneforrások 9. Pulse Phone 10. Rendőrség, szomszédok és adminok 11. Nyelvek 12. Hibaelhárítás 13. Frissítés

1. Követelmények

Semmi más: nincs ox_lib, nincs API kulcs, nincs Google fiók.

Linux szerverek: a Recommended szerver artifactot használd, ne a Latestet. A FiveM szerver letöltési oldalán (docs.fivem.net/docs/server-download/) válaszd a Linuxot és a Recommended frissítési ágat. Egy szerver a legújabb Linux artifacton betöltés közben összeomlott (az FXServer egy /proc/self/maps dumpot írt ki), és az ajánlott artifactra váltás megoldotta. Ez az egyetlen Linux jelentés, ami nálunk van; mi magunk még nem futtattuk a ZeroDev Soundot Linux szerveren.

Standalone szerveren (framework nélkül) minden ingyenes: az üzlet és az autós alkatrészek semmibe sem kerülnek.

2. Telepítés

1. lépés: Tedd be a mappát. Tedd a zerodev-sound mappát a resources mappádba (bármilyen almappa megfelel, például resources/[zerodev]/zerodev-sound). A mappa neve maradjon zerodev-sound: az ox_inventory tárgybejegyzései ezen a néven hivatkoznak rá.

2. lépés: Add hozzá a server.cfg fájlhoz az adatbázis, a framework és az inventory után:

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

3. lépés: Add meg az adminjaidnak az admin jogosultságot (nincs hangszórókorlát, /soundadmin lista, távoli leállítás és eltávolítás):

add_ace group.admin zerodev.sound.admin allow

4. lépés: Állítsd be a tárgyakat az inventorydhoz: 3. fejezet. Az ESX inventoryn és a QBCore-on ezt elvégzi helyetted.

5. lépés: Indítsd újra a szervert (teljes újraindítás, nem csak a resource-é, hogy minden játékos betöltse a modelleket), és nézd meg a konzolt: 4. fejezet.

3. Tárgyak az inventorydhoz

12 tárgy van: tíz hangszóró, a mikrofonállvány és a javítókészlet.

A képek a zerodev-sound/web/img/items/ mappában vannak. Soha nem kell találgatnod: ha valami hiányzik, a szerverkonzol kiírja a pontos bejegyzéseket az inventorydhoz, és megnevez minden képet, amely még nincs a helyén.

Milyen inventoryd van?

Ha inkább kézzel adnád hozzá a tárgyakat a qb-core-hoz ahelyett, hogy a script végezné, illeszd be a QBCore blokkot a qb-core/shared/items.lua fájlba.

Egy másik inventory, amely ezen API-k valamelyikét másolja: állítsd a Config.Inventory értéket arra (lásd az 5. fejezetet). Egy saját fejlesztésű inventory a server/bridge.lua fájlban köthető be, amely olvasható: minden inventory ott három kis függvény (count, add, remove).

ox_inventory blokk

Illeszd be a return { ... } táblázaton belülre az ox_inventory/data/items.lua fájlban:

    ['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 blokk

A QBCore tárgyformátum, amelyet a qb-, ps-, lj- és qs-inventory olvas:

    ['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.' },

Ha módosítottál egy feliratot, árat vagy súlyt a config/catalogue.lua fájlban, inkább a saját konzolodból másold a bejegyzéseket: az a te beállításaid alapján írja ki őket.

4. Első indítás: mit kell látnod

A szerverkonzolban

A ZeroDev Sound egy ellenőrző dobozt ír ki (az újbóli kiíratáshoz írd be a soundcheck parancsot a szerverkonzolba): adatbázis és séma, framework, pénz, inventory és tárgyak, a garázstábla, targeting, Pulse Phone, modellek, szerelőműhelyek és a játékon belül módosított beállítások. Minden sor, amely nem OK, megmondja, mit kell tenni; a docs/SETUP.md mutat egy mintát, a docs/TROUBLESHOOTING.md pedig minden sort elmagyaráz.

• A framework sor megnevezi, mit talált. Ha rossz, állítsd be a Config.Framework vagy a Config.Inventory értéket a config/config.lua fájlban.
• Egy sárga sor: Add these to ox_inventory/data/items.lua ... (vagy ... if these items are not in ... yet, add them), utána tárgybejegyzések: végezd el a 3. fejezetet az inventorydhoz, majd indíts újra. Az ox_inventory üzenet megszűnik, amint a tárgyak bekerültek. A qs-, codem-, origen- és tgiann-inventory esetén a bejegyzések emlékeztetőként minden indításkor kiíródnak, akár hozzáadtad őket, akár nem.
• Egy sárga sor: Copy zds_....png from zerodev-sound/web/img/items into ...: ezek a képek még nincsenek az inventoryd képmappájában. A sor megnevezi a mappát.
• Pulse Phone app not registered: ...: a Pulse Phone fut, de elutasította az alkalmazást. Lásd a 9. fejezetet.

Játékon belül (öt ellenőrzés)

1. A térképen egy ZeroDev Sound jel látható a Legion Square-en és egy Car audio bay jel a Benny's-nél.
2. Az üzletben egy eladó áll egy standnál, ahol a hangszórók ki vannak állítva. Célozd meg az eladót (vagy nyomd meg az E-t, ha nincs target resource), és vegyél egy Roam Portable Speaker hangszórót.
3. Használd az inventorydból. A kezedbe kerül. Nyomd meg az E-t, nyisd meg a Library részt, és játszd le a Night Drive számot (egy demószám, amely a scripttel érkezik). A körülötted lévők hallják.
4. Ülj be egy autóba. Az első néhány alkalommal a képernyő sarka jelzi, melyik gomb nyitja meg az autórádiót (alapból a K).
5. Hajts be sofőrként az autóhifi-szerelőműhelybe, és nyomd meg az E-t. A szerelő megnyílik az autódon.

5. A leggyakrabban módosított beállítások

Játékon belül: a /soundadmin > Settings élőben, mindenkire érvényesen módosítja a gyakoriakat (szerelőműhelyek, ki szerelhet be, mely autókba, árak, maximális hangerő, csendes órák, korlátok, üzlet, rendőrség és sérülés). Az adatbázisba mentődnek, és elsőbbséget élveznek a config.lua fájllal szemben, amíg meg nem nyomod a panelen a Reset to config gombot.

Ha nincs másképp jelezve, minden a config/config.lua fájlban van. A termékek, az árak és az autós alkatrészek a config/catalogue.lua fájlban; az egyes autók gyári hangja a config/vehicles.lua fájlban található.

Tárgynevek. Ha egy másik script már használja valamelyik zds_ tárgynevet, nevezd át annak a terméknek a kulcsát a Catalogue.Speakers táblában (például zds_roam = { ... }), majd használd az új nevet az inventorydban, és nevezd át a képét is ennek megfelelően.

6. Vezérlés

A távirányítóban: Music (a szervered könyvtára), Queue (következő, mentett playlistek), Speakers (minden hangszóró áramellátása és hangereje, összekapcsolás, összecsomagolás) és Tune (hat hangmód, egy háromsávos hangszínszabályzó, ki választja a zenét, nyitvatartás és "Real distance" koncertfelállásokhoz). Ki választja a zenét: Only me; Party, ahol bárki a közelben kérhet dalokat, amelyeket a tulajdonos jóváhagy; vagy Anyone, ahol a közelben lévők lejátszhatnak, szüneteltethetnek, átugorhatnak, sorba tehetnek és tekerhetnek. Opening hours két időpont között magától lejátssza a tulajdonos egyik playlistjét, egy üzlethez vagy klubhoz.

A mikrofon (pma-voice kell hozzá). Amíg a kezedben van, a rendszer bármelyik hangszórója közelében mindenki azon keresztül hallja a hangodat, hangosítás-szerű hangzással, olyan hangosan, ahogy az a hangszóró a zenét szólja, és olyan messzire, ameddig elhallatszik. Ha 4 m-re eltávolodsz a keverőtől vagy a mikrofonállványtól, lecsatlakozol, vagy visszateszed a mikrofont, a hangod újra a megszokott. Csak a rendszer tulajdonosa (autónál az adminok is) énekelhet rajta keresztül; add meg más játékosoknak a zds.mic ace-t, hogy bármelyik rendszert használhassák. A hangod nem az egyes hangszórók helyéről szól: a hangcsevegés nem tudja oda helyezni a hangot, ezért a hangszóró közelében lévők annak a hangszórónak a hangerejével hallanak. Beállítások: Config.Mic.

7. Autóhifi

Hogyan építenek a játékosok

1. Hajts be az autóhifi-szerelőműhelybe (alapból a Benny's), és sofőrként nyomd meg az E-t.
2. Indulj egy kész készletből (Daily thump, Competition, Trunk wall, Sound quality, Clean and hidden), vagy válassz alkatrészeket: mélyládák (8"-tól 18"-ig), dobozok, erősítők, ajtóhangszórók, magassugárzók, podok, álpadlók, panelek, plexi, kondenzátor, második akkumulátor, LED-szalag és fejegység.
3. Húzz minden alkatrészt a helyére az autón. A mélyládák a dobozuk kivágásaiba kerülnek. Minden alkatrész kaphat egy kivitelt (nyolc szín), a mélyládák és hangszórók pedig rácsot és fénygyűrűt. A Mirror átmásol egy alkatrészt a másik oldalra; a Fine position kis lépésekben mozgatja. Öt kameranézet: Boot, Cabin, Side, Front, Top. Méret: a mélyládák 8", 10", 12", 15" és 18" méretben kaphatók (egy dobozban minden mélyláda azonos méretű, és a doboz köréjük épül, legfeljebb 30%-kal nagyobbra vagy kisebbre, mint amire készült); az ajtóhangszórók 5.25", 6.5" és 6x9" méretben; minden más alkatrész 80%-tól 130%-ig, 5%-os lépésekben (a fejegység szabványos méretű). A nagyobb dobozok és panelek többe kerülnek; egy kisebbre vett alkatrész semmibe. A nagyobb hangszórókon a membránok többet mozognak, és egy nagyobb ajtóhangszóró mélyebbre szól.
4. Nyomd meg a Test system gombot, hogy fizetés előtt meghallgasd, hogyan szól az összeállítás az autóban. A Config.Library első dalát játssza le (a mellékelt demószámot, hacsak nem módosítottad).
5. Nyomd meg az Install gombot. Csak az autón új alkatrészekért kell fizetni; az előző beszerelésből megtartott alkatrészekért nem kell újra.

A beszerelés a rendszámhoz kötve mentődik, és visszatér, valahányszor az autó is: bármilyen garázsból, lefoglalásból vagy újraspawnolásból. A garázs scriptedben nincs mit szerkeszteni.

Mit hallanak a játékosok

• Minden autónak már van gyári hangja kategória és modell szerint: 4 hangszórós rendszer, prémium 10 hangszórós vagy referencia 13 hangszórós rendszer, motorokon idomhangszórók; a kerékpároknak, repülőknek és vonatoknak nincs. A beszerelt hangszórók a hozzájuk legközelebbi gyári hangszórókat váltják ki; a mélyládák hozzáadódnak.
• Az autón kívül főleg a basszus jut át a karosszérián. A nyitott ajtók, a nyitott ablakok és a nyitott csomagtartó mind többet engednek ki, abba az irányba, amerre néznek.
• Egy mélyládás autó parkolás vagy lassú gurulás közben finoman rugózik a basszusra (vezetés közben soha), és mindenki, aki bent ül, érzi az ütést.
• Az autórádión (K) van hangerő, mélyláda-szint, fader és balansz.
• Azok a mélyládák, amelyeket jóval az erősítőjük és a terhelhetőségük fölött, közel teljes hangerőn hajtanak egy ideig, kiéghetnek. Mindenki az autó közelében egy vékony füstöt lát abból a mélyládából, és egy tompa pukkanást hall. A kiégett mélyláda leáll, a basszus lecsökken, és a membránja megpörkölődve marad, amíg ki nem cserélik a műhelyben (az új mélyládáért fizetni kell; a nyom eltüntetése nem ingyenes javítás). A staff be tudja mutatni: /soundblow az autóban, vagy soundblow <plate> a szerverkonzolban.

Mely autókba lehet építeni (Config.Install.vehicles)

• 'owned' (alapértelmezett): csak a frameworköd saját járműtáblájában lévő autók (owned_vehicles ESX-en, player_vehicles QBCore-on és Qboxon).
• 'any': azok az autók is, amelyek senkié (NPC-autók, spawnolt autók, bérautók).
• Mindkét esetben egy másik játékos autója az övé marad: csak a tulajdonosa, egy szolgálatban lévő szerelő a Config.Install.jobs listából, vagy egy admin módosíthatja. Standalone szerveren minden autó sajátnak számít.

Garázsok, rendszámok és lefoglalások

• A rendszámokat szóközök nélkül és nagybetűsítve egyezteti, így azok a garázsok is egyeznek, amelyek kitöltik vagy átírják a rendszámok kis- és nagybetűit.
• Egy hamis vagy megváltoztatott rendszámú autó addig nem találja a beszerelését, amíg vissza nem kapja a mentett rendszámát.
• Azok az autók, amelyek csak egy játékos képernyőjén léteznek (garázselőnézetek, egyes bemutatótermi autók), sosem kapnak beszerelést: senki más számára nem valódi autók.

Egyéb hang- vagy hifi scriptek

A ZeroDev Sound önálló resource saját parancsokkal (/sound, /caraudio, ...), eventekkel és jármű state bagekkel, így nem helyettesít és nem módosít más scripteket (amíg egy autóban szól, csak a GTA saját autórádióját kapcsolja ki). Két autóhifi script egyidejű futtatását ugyanazon az autón nem teszteltük együtt: autónként egy hifit használj.

8. Zeneforrások

A zene csak a resource-hoz hozzáadott hangfájlokból szól. A játékosok a te listádból választanak; nem adhatnak meg linkeket, és weboldal-cím soha nem játszódik le. Csak olyan hangot adj hozzá, amelynek a tulajdonosa vagy felhasználására és terjesztésére jogosult vagy.

• Tegyél mp3 vagy ogg fájlokat a zerodev-sound/web/library/ mappába, és mindegyiket sorold fel a Config.Library alatt így: { title = '...', artist = '...', file = 'name.mp3' }. Ezek megkapják a teljes élményt: 3D hang, termek és falak, autókabinok, hangmódok, EQ és a valódi basszussal mozgó kúpok.
• A Config.Sources.library = false kikapcsolja a könyvtárat.
• A GTA saját autórádiója bármelyik autóban tovább működik, amíg nem szól benne dal ebből a resource-ból.
• Az indítódoboz megmutatja, hány dalt választhatnak a játékosok, és figyelmeztet minden kihagyott bejegyzésre (olyan fájlnév, amely nem mp3 vagy ogg, a web/library/ mappában).
• Frissítés a 3.0.0-ról: a mentett dalok, a legutóbbi dalok és a playlist-bejegyzések, amelyek linkek voltak, már nem jelennek meg és nem szólnak. A könyvtári dalok tovább működnek.

9. Pulse Phone

Nincs mit beállítani. Ha a Pulse Phone fut a szerveren (resource-név: phone, bármelyik kiadás):

• Minden telefon kap egy Sound alkalmazást a kezdőképernyőjén. Ez ugyanaz a távirányító, mint a /sound: csatlakozz egy hangszóróhoz vagy az autóhoz, válassz zenét, vezéreld az egész csoportot. A játékosok eltávolíthatják, és visszakaphatják az App Hubból.
• Ami a csatlakoztatott hangszórón vagy autón szól, a hátralévő idővel együtt megjelenik az Islanden és a zárolási képernyőn. Egy koppintás megnyitja a Sound alkalmazást.
• A Pulse Drive (a Pulse autós kijelzője, alapból F10) mutatja annak az autónak a hifijét, amelyben ülsz: dal, előadó és borító, lejátszás, szünet, előző, következő és hangerő, valamint egy Open gomb a Sound alkalmazáshoz. Ehhez Pulse Phone 1.2.9 vagy újabb kell; a régebbi verziók egyszerűen nem mutatják.

A telefon nélküli játékosok a /sound parancsot és a K gombot használják, amelyek mindent tudnak, amit az alkalmazás.

Ha átnevezted a telefon mappáját, add hozzá ezt a sort a config/config.lua fájlhoz a mappa nevével:

Config.PulseResource = 'phone'

10. Rendőrség, szomszédok és adminok

11. Nyelvek

A script ugyanazon a 25 nyelven érhető el, mint a Pulse Phone. A nyelvet a config/config.lua fájlban állítod be:

Például Config.Locale = 'de'. Az alapértelmezett 'auto' a Pulse Phone-t követi: a szerver a Pulse Config.Locale beállítását veszi át, és minden játékos azon a nyelven kapja a Soundot, amelyet a telefonján választott. Pulse nélkül angol. A játékbeli üzenetek, gombfelszólítások, tárgynevek és az autórádió gombjának neve a locales/<code>.lua fájlban vannak; a felület (távirányító, autórádió, üzlet, szerelő, Pulse alkalmazás) a locales/<code>_ui.lua fájlban. Ami hiányzik, az angolul jelenik meg.

Egy sor módosításához szerkeszd az adott nyelv fájljában. Minden %s, %d, %.1f, %% és ~a~ maradjon változatlan. Saját nyelv hozzáadásához másold a locales/en.lua fájlt locales/xx.lua néven, írd át a Locales['en'] részt erre: Locales['xx'] (mindkét helyen), fordítsd le az idézőjelek közötti szöveget, és állítsd be: Config.Locale = 'xx'. A locales/ui_strings.txt felsorol minden felületkulcsot egy xx_ui.lua fájlhoz.

12. Hibaelhárítás

A játékosok nem tudják használni a hangszóró tárgyakat

• ox_inventory: a bejegyzéseknek az ox_inventory/data/items.lua fájlban kell lenniük a client sorukkal együtt, és beillesztés után újra kell indítani az ox_inventoryt. A mappa nevének továbbra is zerodev-sound kell lennie (a bejegyzések a zerodev-sound.useItem függvényt hívják).
• QBCore / ESX: a zerodev-sound a frameworköd után induljon a server.cfg fájlban.
• codem-inventory QBCore-on: végezd el a codem-inventory saját lépését, amely a QBCore.Functions.UseItem függvényt rá irányítja.
• Nincs inventory: a hangszórók nem tárgyak. A játékosok megnyitják a /sound menüt, és megnyomják a Set up gombot a Your speakers alatt.

Hiányoznak a tárgyképek

• ox_inventory: nincs mit másolni; a kép elérési útja a zerodev-soundra mutat. Ha üresek, ellenőrizd a bejegyzés image = 'nui://zerodev-sound/...' sorát és a mappa nevét.
• Más inventoryk: olvasd el a Copy ... into ... konzolsort: felsorolja a hiányzó képeket és a mappát, ahová kerülnek. Másold őket a zerodev-sound/web/img/items/ mappából, és indítsd újra az inventoryt.

A játékos nem tud linket lejátszani

Ez szándékos: a játékosok csak a te könyvtárodból választanak. Add hozzá a dalt a Config.Library alá (8. szakasz).

Egyáltalán nincs hang

• A FiveM beépített böngészője kattintás nélkül is elindítja a hangot, így a játékosoknak soha nem kell semmit megnyomniuk a hang "engedélyezéséhez". Ha egy játékos semmit nem hall, miközben a többiek igen, ellenőrizd a FiveM-et a Windows hangerőkeverőjében.
• Ellenőrizd a hangszórót a távirányító Speakers fülén: lehet, hogy ki van kapcsolva, vagy Broken.
• Lehet, hogy a rendőrség kikapcsolta (Config.Police.silenceMinutes időre), vagy a csendes órák korlátozzák a hangerőt (Config.QuietHours).
• Egy játékos egyszerre legfeljebb Config.Streaming.maxAudibleSessions külön dalt hall (6), a legközelebbiekkel kezdve.
• A szerelőben a Test system néma, ha a Config.Library üres, vagy Config.Sources.library = false: a könyvtár első dalát játssza le.

Az üzlet nincs ott

• A Config.Shop.enabled értékének true-nak kell lennie.
• Az eladó és a stand csak akkor jelenik meg, ha egy játékos körülbelül 70 m-en belül van a Config.Shop.locations helyeitől, és csak annak a játékosnak a képernyőjén. Ellenőrizd a megadott koordinátákat.
• ox_target vagy qb-target mellett célozd meg az eladót. Ezek nélkül állj az eladóhoz: E Browse speakers.

Egy hangszóró sima GTA hangszóróként jelenik meg, vagy egyáltalán nem

A stream/ mappa hiányzik vagy át lett nevezve, vagy a játékos a resource elindulása előtt csatlakozott. Indítsd újra a szervert, és csatlakozz újra.

Autóhifi üzenetek és jelentésük

A rendőrség nem látja az opcióit

Add hozzá a rendőrségi munkák neveit a Config.Police.jobs listához. A játékosoknak szolgálatban kell lenniük.

13. Frissítés

1.x-ről 2.0-ra váltva: olvasd el az UPGRADING.md fájlt. 2.x verziók között:

1. Készíts mentést a config/ mappádról, a locales/ mappáról, ha lefordítottad, és minden dalról, amit a web/library/ mappába tettél.
2. Állítsd le a szervert. Cseréld le a zerodev-sound mappát az újra (a név maradjon).
3. Tedd vissza a config/ fájljaidat. Ha a frissítési megjegyzések új beállításokat említenek, másold át ezeket a sorokat az új fájlokból a sajátjaidba.
4. Indítsd el a szervert, és olvasd el a konzolt. Az esetleges új tárgyak az inventorydhoz kiíródnak.

Az elhelyezett hangszórók, az autós beszerelések és a lejátszási listák az adatbázisban vannak (zds_speakers, zds_car_builds, zds_playlists, zds_stash), és egy frissítés nem érinti őket.

Visszaállás: tartsd meg az előző zerodev-sound mappát a resources mappán kívül, amíg az új verzió rendesen nem fut, és frissítés előtt ments az adatbázisról. A visszaálláshoz állítsd le a szervert, tedd vissza az előző mappát és a config/ mappádat, majd indítsd el. A 3.0-ról 2.x-re való visszaállást ugyanazon az adatbázison nem teszteltük, ezért ha bármi hibásnak tűnik, állítsd vissza az adatbázismentést.