Dokumentacija ZeroDev Sound

ZeroDev Sound: vodnik za namestitev

Za ZeroDev Sound 3.0.127 min branjaPosodobljeno

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:

server.cfg
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. Adminom dajte administratorsko dovoljenje (brez omejitve zvočnikov, seznam /soundadmin, ustavitev in odstranitev na daljavo):

server.cfg
add_ace group.admin zerodev.sound.admin allow

Korak 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:

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:

Lua
    ['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.Framework ali Config.Inventory v config/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)

  1. Zemljevid pokaže oznako ZeroDev Sound na Legion Square in oznako Car audio bay pri Benny's.
  2. 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.
  3. 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.
  4. Sedite v avto. Prvih nekajkrat kot zaslona pove, katera tipka odpre avtoradio (privzeto K).
  5. 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

  1. Zapeljite v vgradno delavnico za avtomobilsko ozvočenje (privzeto Benny's) in kot voznik pritisnite E.
  2. 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.
  3. 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.
  4. 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).
  5. 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: /soundblow v avtu ali soundblow <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_vehicles na ESX, player_vehicles na 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.jobs ali 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 v Config.Library kot { 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 = false izklopi 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:

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.lua s svojo vrstico client, ox_inventory pa je treba po lepljenju ponovno zagnati. Mapa se mora še vedno imenovati zerodev-sound (vnosi kličejo zerodev-sound.useItem).
  • QBCore / ESX: zerodev-sound se mora zagnati za vašim frameworkom v server.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 /sound in 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 iz zerodev-sound/web/img/items/ in ponovno zaženite inventar.

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.maxAudibleSessions ločenih pesmi (6), najprej najbližje.
  • Test system v vgrajevalcu je tih, ko je Config.Library prazen ali Config.Sources.library = false: predvaja prvo pesem iz knjižnice.

Trgovine ni

  • Config.Shop.enabled mora biti true.
  • 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:

  1. Varnostno kopirajte mapo config/, locales/, če ste jo prevedli, in vse pesmi, ki ste jih dodali v web/library/.
  2. Ustavite strežnik. Mapo zerodev-sound zamenjajte z novo (ime obdržite).
  3. Vrnite svoje datoteke config/. Če opombe k posodobitvi omenjajo nove nastavitve, te vrstice kopirajte iz novih datotek v svoje.
  4. 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.

Prevedeno iz angleščine. Če se kaj na tej strani ne ujema z angleško stranjo, velja angleška stran. English