Dokumentacija ZeroDev Sound
ZeroDev Sound: vodnik za namestitev
Ta resource ne vsebuje in ne ponuja nobenih zvočnih ali glasbenih integracij tretjih oseb. Glasba se predvaja samo iz zvočnih datotek, ki jih lastnik strežnika doda v resource, in prek vgrajenega radia GTA. Igralci ne morejo vnašati povezav. Dodajte samo zvok, ki ga imate v lasti ali za katerega imate pravico do uporabe in distribucije; pretakanje vsebine brez dovoljenja lahko krši Cfx.re Creator Platform License Agreement in zakon.
Zvočniki, ki jih igralci kupijo, nosijo, odložijo in povežejo, ter avtomobilsko ozvočenje, ki ga vgradijo v svoje avtomobile. To je celotna referenca. Za kratko različico preberite docs/SETUP.md (5 korakov); za težave docs/TROUBLESHOOTING.md; pri prehodu z 1.x UPGRADING.md.
Vsebina 1. Zahteve 2. Namestitev 3. Predmeti za vaš inventar 4. Prvi zagon: kaj bi morali videti 5. Najpogosteje spremenjene nastavitve 6. Kontrolniki 7. Avtomobilsko ozvočenje 8. Viri glasbe 9. Pulse Phone 10. Policija, sosedje in admini 11. Jeziki 12. Odpravljanje težav 13. Posodabljanje
1. Zahteve
| Obvezno | oxmysql. ZeroDev Sound ob prvem zagonu ustvari lastne tabele; SQL datoteke za uvoz ni. |
| Framework | ESX Legacy, QBCore, Qbox ali brez (standalone). Najde se sam. |
| Inventar | ox_inventory, qb-inventory (tudi ps- in lj-inventory), qs-inventory, codem-inventory, core_inventory, origen_inventory, tgiann-inventory, inventar ESX ali brez. Najde se sam. |
| Neobvezno | ox_target ali qb-target (brez njiju igralci namesto tega dobijo poziv s tipko na zaslonu). Pulse Phone 1.2.9 ali novejši (doda aplikacijo Sound in avtoradio na Pulse Drive). pma-voice za mikrofon: brez njega lahko mikrofon držite in pojete vanj, vendar vas prek zvočnikov nihče ne sliši. |
Nič drugega: brez ox_lib, brez API ključa, brez Google računa.
Strežniki Linux
Strežniki Linux: uporabite strežniški artifact Recommended, ne Latest. Na strani za prenos strežnika FiveM (docs.fivem.net/docs/server-download/) izberite Linux in vejo posodobitev Recommended. Strežnik na najnovejšem artifactu za Linux se je med nalaganjem sesul (FXServer je izpisal dump /proc/self/maps), prehod na priporočeni artifact pa je težavo odpravil. To je edino poročilo za Linux, ki ga imamo; ZeroDev Sound na strežniku Linux sami še nismo zagnali.
Strežniki Linux: uporabite strežniški artifact Recommended, ne Latest. Na strani za prenos strežnika FiveM (docs.fivem.net/docs/server-download/) izberite Linux in vejo posodobitev Recommended. Strežnik na najnovejšem artifactu za Linux se je med nalaganjem sesul (FXServer je izpisal dump /proc/self/maps), prehod na priporočeni artifact pa je težavo odpravil. To je edino poročilo za Linux, ki ga imamo; ZeroDev Sound na strežniku Linux sami še nismo zagnali.
Na standalone strežniku (brez frameworka) je vse brezplačno: trgovina in deli za avto ne zaračunajo ničesar.
2. Namestitev
Korak 1. Spustite mapo noter. Mapo zerodev-sound postavite v mapo resources (katerakoli podmapa je v redu, na primer resources/[zerodev]/zerodev-sound). Ime mape zerodev-sound obdržite: vnosi predmetov v ox_inventory jo kličejo s tem imenom.
Korak 2. Dodajte jo v server.cfg, za bazo podatkov, frameworkom in inventarjem:
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-soundKorak 3. Adminom dajte administratorsko dovoljenje (brez omejitve zvočnikov, seznam /soundadmin, ustavitev in odstranitev na daljavo):
add_ace group.admin zerodev.sound.admin allowKorak 4. Nastavite predmete za svoj inventar: razdelek 3. Na inventarju ESX in na QBCore je to narejeno namesto vas.
Korak 5. Ponovno zaženite strežnik (celoten ponovni zagon, ne le resourca, da vsak igralec naloži modele) in preverite konzolo: razdelek 4.
3. Predmeti za vaš inventar
Predmetov je 12: deset zvočnikov, mikrofonsko stojalo in komplet za popravilo.
| Ime predmeta | Oznaka | Teža |
|---|---|---|
zds_roam |
Prenosni zvočnik Roam | 2 kg |
zds_room_shelf |
Policni zvočnik | 4 kg |
zds_room_tower |
Stoječi zvočnik | 10 kg |
zds_room_ceiling |
Stropni zvočnik | 2 kg |
zds_room_sub |
Domači subwoofer | 8 kg |
zds_stage_pa |
PA zvočnik | 10 kg |
zds_stage_sub |
Koncertni subwoofer | 15 kg |
zds_stage_array |
Line array zvočnik | 12 kg |
zds_stage_monitor |
Odrski monitor | 6 kg |
zds_stage_mixer |
DJ mešalna miza | 5 kg |
zds_stage_mic |
Mikrofonsko stojalo | 3 kg |
zds_repair_kit |
Komplet za popravilo zvočnika | 0.6 kg |
Slike so v zerodev-sound/web/img/items/. Nikoli vam ni treba ugibati: kadar kaj manjka, konzola strežnika izpiše natančne vnose za vaš inventar in navede vsako sliko, ki še ni na mestu.
Kateri inventar imate?
| Inventar | Kaj storite | Slike gredo v |
|---|---|---|
| Inventar ESX (ESX Legacy brez ox) | Nič. Predmeti se ob zagonu dodajo v tabelo items. |
Ničesar ni treba kopirati |
| ox_inventory (ESX, Qbox ali standalone) | Blok za ox_inventory prilepite v ox_inventory/data/items.lua, znotraj tabele. Ponovno zaženite ox_inventory, nato zerodev-sound. |
Ničesar ni treba kopirati: vnosi naložijo slike iz zerodev-sound |
| qb-inventory, ps-inventory, lj-inventory (QBCore) | Nič. Predmeti se ob zagonu dodajo v skupne predmete QBCore. | Kopirajte web/img/items/*.png v <your inventory>/html/images/ |
| qs-inventory | Na QBCore prilepite blok za QBCore v qb-core/shared/items.lua. Na ESX iste vnose prilepite v qs-inventory/shared/items.lua. |
qs-inventory/html/images/ |
| codem-inventory | Teh 12 predmetov dodajte v codem-inventory/config/itemlist.lua, z imeni, oznakami in težami iz bloka za QBCore. Na QBCore izvedite tudi codem-inventoryjev lasten korak namestitve, ki QBCore.Functions.UseItem usmeri na codem-inventory, sicer predmetov ni mogoče uporabljati. |
Mapa s slikami predmetov codem-inventory |
| core_inventory | Nič. Predmeti se namesto vas dodajo v skupne predmete QBCore ali v tabelo items ESX. |
Mapa s slikami predmetov core_inventory |
| origen_inventory | Teh 12 predmetov dodajte v origen_inventory/config/items.lua, z imeni, oznakami in težami iz bloka za QBCore. |
Mapa s slikami predmetov origen_inventory |
| tgiann-inventory | Teh 12 predmetov dodajte v tgiann-inventory/items/items.lua, z imeni, oznakami in težami iz bloka za QBCore. |
inventory_images/images/ |
| Brez inventarja | Nič. Kupljeni in pospravljeni zvočniki čakajo v /sound pod Your speakers, z gumbom Set up. |
Ničesar ni treba kopirati |
Če želite predmete v qb-core dodati ročno, namesto da to naredi skripta, prilepite blok za QBCore v qb-core/shared/items.lua.
Drug inventar, ki posnema enega od teh API-jev: Config.Inventory nastavite nanj (glejte razdelek 5). Lastno razvit inventar je mogoče povezati v server/bridge.lua, ki je berljiv: vsak inventar tam obsega tri majhne funkcije (štetje, dodajanje, odstranjevanje).
Blok za ox_inventory
Prilepite znotraj tabele 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 za QBCore
Oblika predmetov QBCore, ki jo berejo qb-, ps-, lj- in 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.' },Če ste v config/catalogue.lua spremenili oznako, ceno ali težo, vnose namesto tega kopirajte iz svoje konzole: izpiše jih iz vaših nastavitev.
4. Prvi zagon: kaj bi morali videti
V konzoli strežnika
ZeroDev Sound izpiše en okvir preverjanja (za ponoven izpis v konzolo strežnika vpišite soundcheck): baza podatkov in shema, framework, denar, inventar in predmeti, tabela garaže, targeting, Pulse Phone, modeli, vgradne delavnice in nastavitve, spremenjene v igri. Vsaka vrstica, ki ni OK, pove, kaj storiti; docs/SETUP.md pokaže primer, docs/TROUBLESHOOTING.md pa razloži vsako vrstico.
- Vrstica frameworka navaja, kaj je bilo najdeno. Če je napačno, nastavite
Config.FrameworkaliConfig.Inventoryvconfig/config.lua. - Rumena vrstica
Add these to ox_inventory/data/items.lua ...(ali... if these items are not in ... yet, add them), ki ji sledijo vnosi predmetov: izvedite razdelek 3 za svoj inventar, nato ponovno zaženite. Sporočilo ox_inventory izgine, ko so predmeti dodani. Na qs-, codem-, origen- in tgiann-inventory se vnosi izpišejo ob vsakem zagonu kot opomnik, ne glede na to, ali ste jih dodali. - Rumena vrstica
Copy zds_....png from zerodev-sound/web/img/items into ...: teh slik še ni v mapi s slikami vašega inventarja. Navede mapo. Pulse Phone app not registered: ...: Pulse Phone teče, a je aplikacijo zavrnil. Glejte razdelek 9.
V igri (pet preverjanj)
- Zemljevid pokaže oznako ZeroDev Sound na Legion Square in oznako Car audio bay pri Benny's.
- V trgovini prodajalec stoji ob stojalu z razstavljenimi zvočniki. Ciljajte prodajalca (ali pritisnite E, ko ni resourca za target) in kupite Roam Portable Speaker.
- Uporabite ga iz inventarja. Pride vam v roke. Pritisnite E, odprite Library in predvajajte Night Drive (demo skladba, priložena skripti). Ljudje okoli vas jo slišijo.
- Sedite v avto. Prvih nekajkrat kot zaslona pove, katera tipka odpre avtoradio (privzeto K).
- Kot voznik zapeljite v vgradno delavnico za avtomobilsko ozvočenje in pritisnite E. Vgrajevalec se odpre na vašem avtu.
5. Najpogosteje spremenjene nastavitve
V igri: /soundadmin > Settings v živo za vse spremeni pogoste nastavitve (vgradne delavnice, kdo sme vgrajevati, kateri avtomobili, cene, največja glasnost, ure tišine, omejitve, trgovina, policija in poškodbe). Shranijo se v bazo podatkov in imajo prednost pred config.lua, dokler v plošči ne pritisnete Reset to config.
Vse je v config/config.lua, razen če je navedeno drugače. Izdelki, cene in deli za avto so v config/catalogue.lua; tovarniški zvok vsakega avta je v config/vehicles.lua.
| Kaj želite | Nastavitev |
|---|---|
| Vsilite framework ali inventar | Config.Framework (auto, esx, qb, qbox, standalone), Config.Inventory (auto, ox, qb, qs, codem, core, origen, tgiann, esx, none) |
| Spremenite ukaz za daljinec | Config.Command (privzeto sound, torej /sound) |
| Spremenite tipko za avtoradio | Config.HeadUnitKey (privzeto K). Igralci jo lahko sami prevežejo v nastavitvah GTA > Key Bindings > FiveM. |
| Zvočniki na igralca | Config.MaxPlacedPerPlayer (privzeto 8). Admini nimajo omejitve. |
| Zvočniki v eni povezani skupini | Config.MaxLinkedPerGroup (privzeto 16) |
| Kako blizu za povezavo, kako daleč za upravljanje | Config.PairRange (15 m), Config.ControlRange (80 m) |
| Premaknite trgovino ali dodajte več trgovin | Config.Shop.locations. Vsaka sprejme label, coords, blip in po želji heading (v katero smer je obrnjeno stojalo) in clerk (model peda). Config.Shop.account je bank ali cash. Config.Shop.enabled = false odstrani trgovino. |
| Cene zvočnikov | price pri vsakem izdelku v config/catalogue.lua > Catalogue.Speakers. Cena kompleta za popravilo je Config.Damage.repairPrice. |
| Kje se vgrajuje avtomobilsko ozvočenje | Config.Install.bays (vsaka z label, coords, radius, blip). Privzeto: ena delavnica pri Benny's. |
| Lastnikom dovolite gradnjo pri avtu kjerkoli | Config.Install.anywhere = true. Doda gumb Install na avtoradiu in ukaz /caraudio (Config.Install.command). |
| Katere avtomobile je mogoče opremiti | Config.Install.vehicles: 'owned' (privzeto) ali 'any'. Glejte razdelek 7. |
| Vgrajujejo lahko samo mehaniki | Config.Install.anyone = false in službe navedite v Config.Install.jobs (biti morajo dežurni). |
| Brezplačni deli za avto | Config.Install.chargeParts = false. Config.Install.account je bank ali cash. |
| Cene delov za avto in pripravljeni kompleti | Catalogue.CarParts in Catalogue.CarKits v config/catalogue.lua |
| Tovarniški zvok avta | Vehicles.ByClass in Vehicles.ByModel v config/vehicles.lua (basic, premium, reference, bike, none) |
| Knjižnica vklopljena ali izklopljena | Config.Sources.library. Glejte razdelek 8. |
| Vaše lastne pesmi | Config.Library (datoteke v web/library/) |
| Ure tišine | Config.QuietHours = { enabled = true, from = 23, to = 7, maxVolume = 0.35 } (lokalni čas strežnika) |
| Policijske službe in pooblastila | Config.Police (glejte razdelek 10) |
| Zvočniki, ki se ob strelu pokvarijo | Config.Damage.enabled |
| Omejitve zmogljivosti | Config.Streaming.propRange (modeli se izrišejo do 90 m), maxAudibleSessions (6 ločenih pesmi, slišnih hkrati), maxMovingParts (24 animiranih membran na sličico) |
| Dodatne vrstice v konzoli za podporo | Config.Debug (nastavite ga na true, medtem ko iščete težavo) |
Imena predmetov. Če druga skripta že uporablja eno od imen predmetov zds_, preimenujte ključ tega izdelka v Catalogue.Speakers (na primer zds_roam = { ... }), nato novo ime uporabite v svojem inventarju in temu primerno preimenujte njegovo sliko.
6. Kontrolniki
| Kaj | Kako |
|---|---|
| Odprite daljinec | /sound ali E pri zvočniku ali aplikacija Sound v Pulse Phone |
| Avtoradio | K, ko sedite v avtu (mogoče prevezati v nastavitvah GTA) |
| Odložite zvočnik | Uporabite njegov predmet. Namerite, kamor naj gre: kjer se prilega, je obarvan zeleno. Kolešček miške ali Q / E ga zavrti. Enter ali levi klik ga odloži; Backspace ali desni klik prekliče. |
| Naložite line array | Med odlaganjem ga Arrow Up / Arrow Down dvigne ali spusti |
| Nosite Roam | Pride vam v roke in igra naprej, medtem ko hodite. E glasba, G odloži, H pospravi. Vstop v avto ali v vodo ga pospravi. |
| Premaknite ali pospravite zvočnik, ki je vaš | Ciljajte ga in izberite Move ali Pack up, ali brez resourca za target stopite zraven: G premik (pri Roam: ponovno nošenje), H pospravi. Pospravi lahko tudi zavihek Speakers na daljincu. |
| Povežite zvočnike | Povežite se z enim od svojih, odprite zavihek Speakers na daljincu in pritisnite Link ob svojih drugih bližnjih zvočnikih. Ročni se povežejo z ročnimi, notranji z notranjimi, koncertni s koncertnimi (do 40 m, 60 m oziroma 250 m). |
| Vgrajevalec avtomobilskega ozvočenja | Kot voznik zapeljite v vgradno delavnico in pritisnite E (ali gumb Install na avtoradiu / /caraudio, ko je gradnja kjerkoli vklopljena). Del povlecite, da zdrsne po površinah avta, Alt + vlečenje ga potisne ravno na njegovi višini (brez pripenjanja), Shift + vlečenje ga dvigne, Q / E ali Shift + kolesce miške ga zavrti. |
| Pojte prek zvočnikov | Pri DJ mešalni mizi ali mikrofonskem stojalu (prodaja se v trgovini, povežete ga kot zvočnik) zvočnikov, s katerimi ste povezani, ali pri mikrofonskem stojalu avtomobilske postavitve: /soundmic vzame mikrofon, ponoven /soundmic ga odloži |
| Prijavite glasno glasbo | /noise |
| Seznam za admina | /soundadmin |
| Dajte predmet (konzola strežnika) | givespeaker <player id> <item name> |
| Pregorite sub, da pokažete učinek (osebje) | /soundblow v avtu ali soundblow <plate> v konzoli |
V daljinskem upravljalniku: Music (knjižnica vašega strežnika), Queue (naslednje, shranjeni seznami predvajanja), Speakers (napajanje in glasnost vsakega zvočnika, povezovanje, pospravljanje) in Tune (šest zvočnih načinov, tripasovni izenačevalnik, kdo izbira glasbo, delovni čas in "Real distance" za koncertne postavitve). Kdo izbira glasbo: Only me; Party, kjer lahko vsak v bližini zahteva pesmi, ki jih lastnik odobri; ali Anyone, kjer lahko ljudje v bližini predvajajo, začasno ustavijo, preskočijo, dodajo v vrsto in previjajo. Opening hours sam predvaja enega od lastnikovih seznamov predvajanja med dvema urama, za trgovino ali klub.
Mikrofon (potrebuje pma-voice). Dokler ga držite, vsi v bližini katerega koli zvočnika tega sistema slišijo vaš glas skozenj, z zvokom ozvočenja, tako glasno, kot ta zvočnik predvaja glasbo, in tako daleč, kot se ga sliši. Odmaknite se 4 m od mešalne mize ali mikrofonskega stojala, prekinite povezavo ali odložite mikrofon in vaš glas bo spet običajen. Prek sistema lahko poje samo njegov lastnik (pri avtu tudi admini); drugim igralcem dodelite ace zds.mic, da lahko uporabljajo kateri koli sistem. Vaš glas se ne sliši iz mesta vsakega zvočnika: glasovni klepet glasu ne more postaviti tja, zato vas ljudje ob zvočniku slišijo z glasnostjo tega zvočnika. Nastavitve: Config.Mic.
7. Avtomobilsko ozvočenje
Kako igralci gradijo
- Zapeljite v vgradno delavnico za avtomobilsko ozvočenje (privzeto Benny's) in kot voznik pritisnite E.
- Začnite s pripravljenim kompletom (Daily thump, Competition, Trunk wall, Sound quality, Clean and hidden) ali izberite dele: subwooferje (8" do 18"), ohišja, ojačevalnike, zvočnike za vrata, visokotonce, ohišja za zvočnike (pods), dvojna dna, plošče, pleksi, kondenzator, drugo baterijo, LED trak in glavno enoto.
- Vsak del povlecite na mesto na avtu. Subi padejo v izreze svojega ohišja. Vsak del dobi izvedbo (osem barv), subi in zvočniki pa še mrežico in svetlobni obroč. Mirror kopira del na drugo stran; Fine position ga premika v majhnih korakih. Pet pogledov kamere: Boot, Cabin, Side, Front, Top. Size: subi so na voljo v 8", 10", 12", 15" in 18" (vsi subi v ohišju so iste velikosti, ohišje pa je zgrajeno okoli njih, do 30% večje ali manjše, kot je bilo narejeno); zvočniki za vrata v 5.25", 6.5" in 6x9"; vsak drug del od 80% do 130% v korakih po 5% (glavna enota je standardne velikosti). Večja ohišja in plošče stanejo več; del, ki ga zmanjšate, ne stane nič. Membrane se pri večjih zvočnikih premaknejo dlje, večji zvočnik za vrata pa seže nižje.
- Pritisnite Test system, da sestavo pred plačilom slišite skozi avto. Predvaja prvo pesem v
Config.Library(priloženo demo skladbo, razen če ste jo spremenili). - Pritisnite Install. Zaračunajo se samo deli, ki so za avto novi; deli, ohranjeni iz zadnje vgradnje, se ne zaračunajo znova.
Vgradnja se shrani glede na registrsko tablico in se vrne, kadarkoli se vrne avto: iz katerekoli garaže, zasega ali respawna. V vaši skripti za garaže ni treba ničesar urejati.
Kaj igralci slišijo
- Vsak avto že ima tovarniški zvok glede na razred in model: sistem s 4 zvočniki, premium sistem z 10 zvočniki ali referenčni sistem s 13 zvočniki, zvočnike v oklepu na motociklih; kolesa, letala in vlaki ga nimajo. Vgrajeni zvočniki nadomestijo njim najbližje tovarniške zvočnike; subi se dodajo.
- Zunaj avta skozi karoserijo pride večinoma bas. Odprta vrata, odprta okna in odprt prtljažnik vsak spustijo več zvoka ven, proti strani, v katero so obrnjeni.
- Avto s subi se z basom nežno poziblje na vzmeteh, ko je parkiran ali se plazi (nikoli med vožnjo), in vsi v njem čutijo kick.
- Radio (K) ima glasnost, raven suba, fader in balans.
- Subi, ki jih dalj časa poganjate precej čez to, kar dovoljujeta njihov ojačevalnik in nazivna moč, blizu polne glasnosti, lahko pregorijo. Vsi blizu avta vidijo tanek pramen dima iz tega suba in slišijo topo počenje. Pregorel sub se neha premikati, bas upade, njegova membrana pa ostane ožgana, dokler je v delavnici ne zamenjate (nov sub se plača; odstranitev sledi ni brezplačno popravilo). Osebje lahko to pokaže:
/soundblowv avtu alisoundblow <plate>v konzoli strežnika.
Katere avtomobile je mogoče opremiti (Config.Install.vehicles)
'owned'(privzeto): samo avtomobili iz tabele vozil v lasti vašega frameworka (owned_vehiclesna ESX,player_vehiclesna QBCore in Qbox).'any': tudi avtomobili, ki niso v nikogaršnji lasti (NPC avtomobili, spawnani avtomobili, najeti).- V obeh primerih avto, ki je last drugega igralca, ostane njegov: spremeni ga lahko samo njegov lastnik, dežurni mehanik iz
Config.Install.jobsali admin. Na standalone strežniku vsak avto šteje kot v lasti.
Garaže, tablice in zasegi
- Tablice se primerjajo obrezane in z velikimi črkami, zato se ujemajo tudi pri garažah, ki tablice dopolnijo s presledki ali spremenijo velikost črk.
- Avto z lažno ali spremenjeno tablico svoje vgradnje ne najde, dokler znova nima shranjene tablice.
- Avtomobili, ki obstajajo samo na zaslonu enega igralca (predogledi v garaži, nekateri avtomobili v razstavnem salonu), vgradnje nikoli ne dobijo: za nikogar drugega niso pravi avtomobili.
Druge skripte za zvok ali radio
ZeroDev Sound je samostojen resource z lastnimi ukazi (/sound, /caraudio, ...), dogodki in state bagi vozil, zato ne nadomešča ali spreminja drugih skript (ko igra v avtu, izklopi le GTA-jev lasten avtoradio). Hkratno delovanje dveh skript za avtomobilsko ozvočenje na istem avtu ni bilo testirano: uporabljajte en radio na avto.
8. Viri glasbe
Glasba se predvaja samo iz zvočnih datotek, ki jih dodate v resource. Igralci izbirajo z vašega seznama; ne morejo vnašati povezav in nobenega spletnega naslova se nikoli ne predvaja. Dodajte samo zvok, ki ga imate v lasti ali za katerega imate pravico do uporabe in distribucije.
- Datoteke mp3 ali ogg dajte v
zerodev-sound/web/library/in vsako navedite vConfig.Librarykot{ title = '...', artist = '...', file = 'name.mp3' }. Dobijo celotno izkušnjo: 3D zvok, prostore in stene, kabine avtomobilov, zvočne načine, EQ in stožce, ki se premikajo z resničnim basom. Config.Sources.library = falseizklopi knjižnico.- GTA-jev lastni avtoradio še vedno deluje v vsakem avtomobilu, dokler se v njem ne predvaja nobena pesem iz tega resource.
- Zagonsko okno pokaže, koliko pesmi lahko izbirajo igralci, in opozori na vsak preskočen vnos (ime
datoteke, ki ni mp3 ali ogg, v
web/library/). - Posodobitev s 3.0.0: shranjene pesmi, nedavne pesmi in vnosi v seznamih predvajanja, ki so bili povezave, se ne prikazujejo in ne predvajajo več. Pesmi iz knjižnice še naprej delujejo.
9. Pulse Phone
Ničesar ni treba nastaviti. Ko Pulse Phone teče na strežniku (ime resourca phone, katerakoli izdaja):
- Vsak telefon dobi aplikacijo Sound na domačem zaslonu. To je isti daljinec kot
/sound: povežite se z zvočnikom ali avtom, izberite glasbo, upravljajte celotno skupino. Igralci jo lahko odstranijo in jo znova dobijo iz App Hub. - Kaj se predvaja na povezanem zvočniku ali avtu, s preostalim časom, je prikazano na Island in zaklenjenem zaslonu. Dotik odpre aplikacijo Sound.
- Pulse Drive (avtomobilski zaslon Pulse, privzeto F10) prikazuje radio avta, v katerem sedite: pesem, izvajalca in naslovnico, s predvajanjem, premorom, prejšnjo, naslednjo in glasnostjo ter gumbom Open za aplikacijo Sound. To potrebuje Pulse Phone 1.2.9 ali novejši; starejše različice tega preprosto ne prikažejo.
Igralci brez telefona uporabljajo /sound in K, ki naredita vse, kar naredi aplikacija.
Če ste preimenovali mapo telefona, dodajte to vrstico z njenim imenom v config/config.lua:
Config.PulseResource = 'phone'10. Policija, sosedje in admini
| Kaj | Kako | Nastavitev |
|---|---|---|
| Prijavite glasno glasbo | /noise pošlje najbližji igrajoči zvočnik (do 60 m) dežurni policiji kot utripajočo oznako za 3 minute. Ena prijava na igralca vsaki 2 minuti. |
Config.Police.complaints, complaintRange |
| Izklop zvočnika | Dežurna policija: ciljajte zvočnik > Turn off (police) ali zavihek Tune na daljincu > Police. Do 12 m. | Config.Police.canSilence, silenceMinutes (15) |
| Zaseg zvočnika | Dežurna policija, do 4 m: target > Seize (police) ali Tune > Police > Seize. Zvočnik gre policistu. | Config.Police.canSeize |
| Policijske službe | Igralci s temi službami, na dežurstvu | Config.Police.jobs |
| Pokvarjeni zvočniki | Strel v postavljen zvočnik ga pokvari: zaprasketa in utihne. Speaker Repair Kit (naprodaj v trgovini pod Accessories) ga popravi: komplet uporabite zraven njega. | Config.Damage |
| Seznam za admina | /soundadmin: vsak zvočnik na strežniku, kaj predvaja in kdo je lastnik, z gumbi za nastavitev waypointa, ustavitev glasbe ali odstranitev zvočnika. |
Config.AdminAce (zerodev.sound.admin) |
| Dajte predmet | Konzola strežnika: givespeaker <player id> <item name> |
11. Jeziki
Skripta je na voljo v istih 25 jezikih kot Pulse Phone. Jezik nastavite v config/config.lua:
| Koda | Jezik | Koda | Jezik | Koda | Jezik |
|---|---|---|---|---|---|
en |
English | hu |
Magyar | pt-PT |
Português (Portugal) |
ar |
العربية | it |
Italiano | ro |
Română |
bs |
Bosanski | ja |
日本語 | ru |
Русский |
cs |
Čeština | ko |
한국어 | sl |
Slovenščina |
da |
Dansk | nb |
Norsk bokmål | sv |
Svenska |
de |
Deutsch | nl |
Nederlands | th |
ไทย |
es |
Español | pl |
Polski | tr |
Türkçe |
fr |
Français | pt-BR |
Português (Brasil) | uk |
Українська |
zh-CN |
简体中文 |
Na primer Config.Locale = 'de'. Privzeta vrednost 'auto' sledi Pulse Phone: strežnik prevzame Config.Locale iz Pulse, vsak igralec pa dobi Sound v jeziku, ki ga je izbral v telefonu. Brez Pulse je v angleščini. Sporočila v igri, pozivi s tipkami, imena predmetov in ime tipke avtoradia so v locales/<code>.lua; vmesnik (daljinec, avtoradio, trgovina, vgrajevalec, aplikacija Pulse) je v locales/<code>_ui.lua. Vse, kar manjka, se prikaže v angleščini.
Vrstico spremenite tako, da jo uredite v datoteki tega jezika. Vse %s, %d, %.1f, %% in ~a~ pustite nespremenjene. Za lasten jezik kopirajte locales/en.lua v locales/xx.lua, spremenite Locales['en'] v Locales['xx'] (na obeh mestih), prevedite besedilo med narekovaji in nastavite Config.Locale = 'xx'. locales/ui_strings.txt navaja vse ključe vmesnika za xx_ui.lua.
12. Odpravljanje težav
Igralci ne morejo uporabiti predmetov zvočnikov
- ox_inventory: vnosi morajo biti znotraj
ox_inventory/data/items.luas svojo vrsticoclient, ox_inventory pa je treba po lepljenju ponovno zagnati. Mapa se mora še vedno imenovatizerodev-sound(vnosi kličejozerodev-sound.useItem). - QBCore / ESX:
zerodev-soundse mora zagnati za vašim frameworkom vserver.cfg. - codem-inventory na QBCore: dokončajte lasten korak codem-inventory, ki nanj usmeri
QBCore.Functions.UseItem. - Brez inventarja: zvočniki niso predmeti. Igralci odprejo
/soundin pritisnejo Set up pod Your speakers.
Slike predmetov manjkajo
- ox_inventory: ničesar ni treba kopirati; pot do slike kaže na zerodev-sound. Če so prazne, preverite vrstico
image = 'nui://zerodev-sound/...'v vnosu in ime mape. - Drugi inventarji: preberite vrstico v konzoli
Copy ... into ...: navede manjkajoče slike in mapo, kamor spadajo. Kopirajte jih izzerodev-sound/web/img/items/in ponovno zaženite inventar.
Igralec ne more predvajati povezave
To je namerno: igralci izbirajo samo iz vaše knjižnice. Dodajte pesem v
Config.Library (razdelek 8).
Sploh ni zvoka
- Vgrajeni brskalnik FiveM zvok zažene brez klika, zato igralcem nikoli ni treba ničesar pritisniti, da bi "dovolili" zvok. Če en igralec ne sliši ničesar, drugi pa slišijo, preverite FiveM v njegovem mešalniku glasnosti Windows.
- Preverite zvočnik v zavihku Speakers na daljincu: morda je izklopljen ali Broken.
- Morda ga je izklopila policija (za
Config.Police.silenceMinutes) ali pa ure tišine omejujejo glasnost (Config.QuietHours). - Igralec hkrati sliši največ
Config.Streaming.maxAudibleSessionsločenih pesmi (6), najprej najbližje. - Test system v vgrajevalcu je tih, ko je
Config.Libraryprazen aliConfig.Sources.library = false: predvaja prvo pesem iz knjižnice.
Trgovine ni
Config.Shop.enabledmora bititrue.- Prodajalec in stojalo se prikažeta šele, ko je igralec v razdalji približno 70 m od
Config.Shop.locations, in samo na zaslonu tega igralca. Preverite koordinate, ki ste jih nastavili. - Z ox_target ali qb-target ciljajte prodajalca. Brez njiju stopite k prodajalcu: E Browse speakers.
Zvočnik je prikazan kot navaden zvočnik GTA ali sploh ne
Mapa stream/ manjka ali je bila preimenovana ali pa se je igralec pridružil, preden se je resource zagnal. Ponovno zaženite strežnik in se znova povežite.
Sporočila avtomobilskega ozvočenja in kaj pomenijo
| Sporočilo | Zakaj | Rešitev |
|---|---|---|
| Drive into a car audio bay to build. | Gradnja kjerkoli je izklopljena in avto ni v delavnici. | Zapeljite v delavnico (Config.Install.bays) ali nastavite Config.Install.anywhere = true. |
| Stand next to your car to build its sound system. | Gradnja kjerkoli je vklopljena, vi pa ste od avta oddaljeni več kot 8 m, ali pa /caraudio v razdalji 4 m ni našel avta. |
Stopite k avtu ali sedite vanj. |
| Stop the car first. | Avto se premika. | Ustavite. |
| Car audio can only be fitted to a car you own. | Config.Install.vehicles = 'owned' in te tablice ni v vaši tabeli vozil v lasti. Prikaže se tudi vsem razen adminom, ko te tabele ni mogoče prebrati: konzola takrat pokaže rdečo vrstico could not read the owned-vehicles table. |
Uporabite avto v lasti, nastavite 'any' ali popravite napako baze podatkov, ki jo navaja konzola. |
| Only the owner can change this car's audio. | Avto pripada drugemu igralcu. Prikaže se tudi, ko je Config.Install.anyone = false in igralec nima dežurne službe iz Config.Install.jobs. |
Opremi ga lastnik, dežurni mehanik ali admin. |
| Not enough money. | Novi deli stanejo več, kot ima igralec na Config.Install.account. |
Odstranite dele ali nastavite Config.Install.chargeParts = false. |
| A subwoofer blew. It needs replacing. | Subi so bili predolgo preveč obremenjeni pri skoraj polni glasnosti. | Sub zamenjajte v delavnici; pomaga večji ojačevalnik. |
Policija ne vidi svojih možnosti
Imena svojih policijskih služb dodajte v Config.Police.jobs. Igralci morajo biti dežurni.
13. Posodabljanje
Prehod z 1.x na 2.0: preberite UPGRADING.md. Med različicami 2.x:
- Varnostno kopirajte mapo
config/,locales/, če ste jo prevedli, in vse pesmi, ki ste jih dodali vweb/library/. - Ustavite strežnik. Mapo
zerodev-soundzamenjajte z novo (ime obdržite). - Vrnite svoje datoteke
config/. Če opombe k posodobitvi omenjajo nove nastavitve, te vrstice kopirajte iz novih datotek v svoje. - Zaženite strežnik in preberite konzolo. Morebitni novi predmeti se izpišejo za vaš inventar.
Postavljeni zvočniki, vgradnje v avtomobile in seznami predvajanja se hranijo v bazi podatkov (zds_speakers, zds_car_builds, zds_playlists, zds_stash) in jih posodobitev ne spremeni.
Vrnitev nazaj: prejšnjo mapo zerodev-sound hranite zunaj resources, dokler nova različica ne deluje dobro, in pred posodobitvijo naredite varnostno kopijo podatkovne baze. Za vrnitev ustavite strežnik, vrnite prejšnjo mapo in svoj config/ ter ga zaženite. Vrnitev s 3.0 na 2.x na isti podatkovni bazi ni bila preizkušena, zato obnovite varnostno kopijo baze, če kaj ni videti prav.