ZeroDev Sound-dokumentasjon
ZeroDev Sound: installasjonsguide
Denne resourcen inneholder eller tilbyr ingen lyd- eller musikkintegrasjoner fra tredjeparter. Musikk spilles bare fra lydfiler som servereieren legger til i resourcen, og fra GTAs innebygde radio. Spillere kan ikke skrive inn lenker. Legg bare til lyd du eier eller har rett til å bruke og distribuere; strømming av innhold uten tillatelse kan bryte Cfx.re Creator Platform License Agreement og loven.
Høyttalere spillerne kjøper, bærer, setter ned og kobler sammen, og bilstereo de bygger inn i sine egne biler. Dette er hele referansen. For kortversjonen, les docs/SETUP.md (5 steg); for problemer, docs/TROUBLESHOOTING.md; kommer du fra 1.x, UPGRADING.md.
Innhold 1. Krav 2. Installasjon 3. Items for inventoryet ditt 4. Første oppstart: hva du skal se 5. Innstillingene folk endrer mest 6. Kontroller 7. Bilstereo 8. Musikkilder 9. Pulse Phone 10. Politi, naboer og admins 11. Språk 12. Feilsøking 13. Oppdatering
1. Krav
| Påkrevd | oxmysql. ZeroDev Sound oppretter sine egne tabeller ved første oppstart; det finnes ingen SQL-fil å importere. |
| Framework | ESX Legacy, QBCore, Qbox, eller ingen (standalone). Oppdages av seg selv. |
| Inventory | ox_inventory, qb-inventory (også ps- og lj-inventory), qs-inventory, codem-inventory, core_inventory, origen_inventory, tgiann-inventory, ESX-inventoryet, eller ingen. Oppdages av seg selv. |
| Valgfritt | ox_target eller qb-target (uten et av dem får spillerne en tastemelding på skjermen i stedet). Pulse Phone 1.2.9 eller nyere (legger til Sound-appen og bilstereoen på Pulse Drive). pma-voice for mikrofonen: uten pma-voice kan man holde mikrofonen og synge i den, men ingen hører det gjennom høyttalerne. |
Ingenting annet: ingen ox_lib, ingen API-nøkkel, ingen Google-konto.
Linux-servere
Linux-servere: bruk Recommended-server-artifacten, ikke Latest. På nedlastingssiden for FiveM-serveren (docs.fivem.net/docs/server-download/) velger du Linux og oppdateringsgrenen Recommended. En server på den nyeste Linux-artifacten krasjet under lasting (FXServer skrev ut en /proc/self/maps-dump), og bytte til den anbefalte artifacten løste det. Det er den eneste Linux-rapporten vi har; vi har ikke kjørt ZeroDev Sound på en Linux-server selv ennå.
Linux-servere: bruk Recommended-server-artifacten, ikke Latest. På nedlastingssiden for FiveM-serveren (docs.fivem.net/docs/server-download/) velger du Linux og oppdateringsgrenen Recommended. En server på den nyeste Linux-artifacten krasjet under lasting (FXServer skrev ut en /proc/self/maps-dump), og bytte til den anbefalte artifacten løste det. Det er den eneste Linux-rapporten vi har; vi har ikke kjørt ZeroDev Sound på en Linux-server selv ennå.
På en standalone-server (uten framework) er alt gratis: butikken og bildeler koster ingenting.
2. Installasjon
Steg 1. Legg inn mappen. Legg zerodev-sound-mappen i resources-mappen din (en hvilken som helst undermappe går fint, for eksempel resources/[zerodev]/zerodev-sound). Behold mappenavnet zerodev-sound: ox_inventory-item-oppføringene kaller den ved det navnet.
Steg 2. Legg den til i server.cfg, etter databasen, frameworket og inventoryet:
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-soundSteg 3. Gi adminene dine admin-tillatelsen (ingen høyttalergrense, /soundadmin-listen, fjernstopp og fjerning):
add_ace group.admin zerodev.sound.admin allowSteg 4. Sett opp itemene for inventoryet ditt: del 3. På ESX-inventoryet og på QBCore gjøres dette for deg.
Steg 5. Start serveren på nytt (en full omstart, ikke bare ressursen, så alle spillere laster modellene) og sjekk konsollen: del 4.
3. Items for inventoryet ditt
Det er 12 items: ti høyttalere, mikrofonstativet og reparasjonssettet.
| Item-navn | Merke | Vekt |
|---|---|---|
zds_roam |
Roam bærbar høyttaler | 2 kg |
zds_room_shelf |
Hyllehøyttaler | 4 kg |
zds_room_tower |
Tårnhøyttaler | 10 kg |
zds_room_ceiling |
Takhøyttaler | 2 kg |
zds_room_sub |
Hjemmesubwoofer | 8 kg |
zds_stage_pa |
PA Speaker | 10 kg |
zds_stage_sub |
Konsertsubwoofer | 15 kg |
zds_stage_array |
Line Array Speaker | 12 kg |
zds_stage_monitor |
Scenemonitor | 6 kg |
zds_stage_mixer |
DJ-mikser | 5 kg |
zds_stage_mic |
Mikrofonstativ | 3 kg |
zds_repair_kit |
Speaker Repair Kit | 0.6 kg |
Bildene ligger i zerodev-sound/web/img/items/. Du trenger aldri gjette: når noe mangler, skriver serverkonsollen ut nøyaktig de oppføringene inventoryet ditt trenger, og navngir alle bilder som ikke er på plass ennå.
Hvilket inventory har du?
| Inventory | Hva du gjør | Bildene skal i |
|---|---|---|
| ESX-inventory (ESX Legacy uten ox) | Ingenting. Itemene legges til i items-tabellen ved oppstart. |
Ingenting å kopiere |
| ox_inventory (ESX, Qbox eller standalone) | Lim inn ox_inventory-blokken i ox_inventory/data/items.lua, inne i tabellen. Start ox_inventory på nytt, deretter zerodev-sound. |
Ingenting å kopiere: oppføringene laster bildene fra zerodev-sound |
| qb-inventory, ps-inventory, lj-inventory (QBCore) | Ingenting. Itemene legges til i QBCore sine shared items ved oppstart. | Kopier web/img/items/*.png til <your inventory>/html/images/ |
| qs-inventory | På QBCore limer du inn QBCore-blokken i qb-core/shared/items.lua. På ESX limer du inn de samme oppføringene i qs-inventory/shared/items.lua. |
qs-inventory/html/images/ |
| codem-inventory | Legg til de 12 itemene i codem-inventory/config/itemlist.lua med navnene, etikettene og vektene fra QBCore-blokken. På QBCore må du også fullføre codem-inventory sitt eget installasjonssteg som peker QBCore.Functions.UseItem mot codem-inventory, ellers kan ikke itemene brukes. |
Item-bildemappen til codem-inventory |
| core_inventory | Ingenting. Itemene legges til i QBCore sine shared items eller ESX sin items-tabell for deg. |
Item-bildemappen til core_inventory |
| origen_inventory | Legg til de 12 itemene i origen_inventory/config/items.lua med navnene, etikettene og vektene fra QBCore-blokken. |
Item-bildemappen til origen_inventory |
| tgiann-inventory | Legg til de 12 itemene i tgiann-inventory/items/items.lua med navnene, etikettene og vektene fra QBCore-blokken. |
inventory_images/images/ |
| Uten inventory | Ingenting. Kjøpte og pakkede høyttalere venter i /sound under Your speakers, med en Set up-knapp. |
Ingenting å kopiere |
For å legge itemene til i qb-core for hånd i stedet for å la scriptet gjøre det, lim inn QBCore-blokken i qb-core/shared/items.lua.
Et annet inventory som kopierer et av disse API-ene: sett Config.Inventory til det (se del 5). Et egenutviklet inventory kan kobles til i server/bridge.lua, som er lesbar: hvert inventory der er tre små funksjoner (telle, legge til, fjerne).
ox_inventory-blokk
Lim inn inne i return { ... }-tabellen i ox_inventory/data/items.lua:
['zds_repair_kit'] = { label = 'Speaker Repair Kit', weight = 600, stack = false, close = true, description = 'Fixes a broken speaker. Use it next to one.',
client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_repair_kit.png' } },
['zds_roam'] = { label = 'Roam Portable Speaker', weight = 2000, stack = false, close = true, description = 'Portable speaker with twin bass radiators. Carry it or set it down.',
client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_roam.png' } },
['zds_room_ceiling'] = { label = 'Ceiling Speaker', weight = 2000, stack = false, close = true, description = 'Indoor. Round ceiling or wall speaker for background music in a business.',
client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_room_ceiling.png' } },
['zds_room_shelf'] = { label = 'Shelf Speaker', weight = 4000, stack = false, close = true, description = 'Indoor. Bookshelf speaker: link several around a home or shop.',
client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_room_shelf.png' } },
['zds_room_sub'] = { label = 'Home Subwoofer', weight = 8000, stack = false, close = true, description = 'Indoor. Cube subwoofer: link it to your indoor speakers for deep bass.',
client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_room_sub.png' } },
['zds_room_tower'] = { label = 'Tower Speaker', weight = 10000, stack = false, close = true, description = 'Indoor. Floor-standing tower with two woofers: deep, clean sound for a whole room.',
client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_room_tower.png' } },
['zds_stage_array'] = { label = 'Line Array Speaker', weight = 12000, stack = false, close = true, description = 'Concert. Line-array speaker for long throw over a big crowd. Stack them.',
client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_array.png' } },
['zds_stage_mic'] = { label = 'Mic Stand', weight = 3000, stack = false, close = true, description = 'Concert. A mic on a boom stand: link it to your concert speakers, stand at it and sing through them (/soundmic).',
client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_mic.png' } },
['zds_stage_mixer'] = { label = 'DJ Mixer', weight = 5000, stack = false, close = true, description = 'Concert. Not a speaker: whoever stands at it runs every linked concert speaker (volume, bass, sound, timing).',
client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_mixer.png' } },
['zds_stage_monitor'] = { label = 'Stage Monitor', weight = 6000, stack = false, close = true, description = 'Concert. Wedge monitor so the DJ or band hears the mix on stage.',
client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_monitor.png' } },
['zds_stage_pa'] = { label = 'PA Speaker', weight = 10000, stack = false, close = true, description = 'Concert. Powered 15" PA top on a tripod: link many for an event.',
client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_pa.png' } },
['zds_stage_sub'] = { label = 'Concert Subwoofer', weight = 15000, stack = false, close = true, description = 'Concert. Double 18" sub cabinet: the bass you feel at a show.',
client = { export = 'zerodev-sound.useItem', image = 'nui://zerodev-sound/web/img/items/zds_stage_sub.png' } },QBCore-blokk
Item-formatet til QBCore, som qb-, ps-, lj- og qs-inventory leser:
['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.' },Hvis du har endret en etikett, pris eller vekt i config/catalogue.lua, kopier oppføringene fra din egen konsoll i stedet: den skriver dem ut fra innstillingene dine.
4. Første oppstart: hva du skal se
I serverkonsollen
ZeroDev Sound skriver ut én sjekkboks (skriv soundcheck i serverkonsollen for å skrive den ut igjen): database og skjema, framework, penger, inventory og items, garasjetabellen, targeting, Pulse Phone, modeller, monteringsverksteder og innstillinger endret i spillet. Hver linje som ikke er OK sier hva du skal gjøre; docs/SETUP.md viser et eksempel, og docs/TROUBLESHOOTING.md forklarer hver linje.
- Framework-linjen navngir det som ble funnet. Er det feil, sett
Config.FrameworkellerConfig.Inventoryiconfig/config.lua. - En gul linje
Add these to ox_inventory/data/items.lua ...(eller... if these items are not in ... yet, add them) etterfulgt av item-oppføringer: gjør del 3 for inventoryet ditt, og start så på nytt. ox_inventory-meldingen forsvinner når itemene er på plass. På qs-, codem-, origen- og tgiann-inventory skrives oppføringene ut ved hver oppstart som en påminnelse, enten du har lagt dem til eller ikke. - En gul linje
Copy zds_....png from zerodev-sound/web/img/items into ...: de bildene er ikke i bildemappen til inventoryet ditt ennå. Den navngir mappen. Pulse Phone app not registered: ...: Pulse Phone kjører, men avviste appen. Se del 9.
I spillet (fem sjekker)
- Kartet viser en ZeroDev Sound-blip på Legion Square og en Car audio bay-blip ved Benny's.
- I butikken står en ekspeditør ved en stand med høyttalerne utstilt. Target ekspeditøren (eller trykk E når det ikke finnes noen target-ressurs) og kjøp en Roam Portable Speaker.
- Bruk den fra inventoryet ditt. Den kommer ut i hendene dine. Trykk E, åpne Library og spill Night Drive (et demospor som følger med scriptet). Folk rundt deg hører det.
- Sett deg inn i en bil. De første gangene sier hjørnet av skjermen hvilken tast som åpner bilstereoen (K som standard).
- Kjør inn i monteringsverkstedet for bilstereo som sjåfør og trykk E. Installatøren åpnes på bilen din.
5. Innstillingene folk endrer mest
I spillet: /soundadmin > Settings endrer de vanligste live for alle (monteringsverksteder, hvem som kan montere, hvilke biler, priser, høyeste volum, stilletid, grenser, butikk, politi og skade). De lagres i databasen og vinner over config.lua til du trykker Reset to config i panelet.
Alt ligger i config/config.lua med mindre annet er nevnt. Produkter, priser og bildeler ligger i config/catalogue.lua; fabrikklyden for hver bil ligger i config/vehicles.lua.
| Hva du vil | Innstilling |
|---|---|
| Tvinge framework eller inventory | Config.Framework (auto, esx, qb, qbox, standalone), Config.Inventory (auto, ox, qb, qs, codem, core, origen, tgiann, esx, none) |
| Endre fjernkontrollkommandoen | Config.Command (standard sound, altså /sound) |
| Endre tasten for bilstereo | Config.HeadUnitKey (standard K). Spillerne kan binde den om selv i GTA-innstillinger > Key Bindings > FiveM. |
| Høyttalere per spiller | Config.MaxPlacedPerPlayer (standard 8). Admins har ingen grense. |
| Høyttalere i én sammenkoblet gruppe | Config.MaxLinkedPerGroup (standard 16) |
| Hvor nær for å koble til, hvor langt unna for å styre | Config.PairRange (15 m), Config.ControlRange (80 m) |
| Flytte butikken eller legge til flere butikker | Config.Shop.locations. Hver tar label, coords, blip, og valgfritt heading (hvilken vei standen vender) og clerk (en ped-modell). Config.Shop.account er bank eller cash. Config.Shop.enabled = false fjerner butikken. |
| Priser på høyttalere | price på hvert produkt i config/catalogue.lua > Catalogue.Speakers. Prisen på reparasjonssettet er Config.Damage.repairPrice. |
| Hvor bilstereo monteres | Config.Install.bays (hver med label, coords, radius, blip). Standard: ett verksted hos Benny's. |
| La eiere bygge ved bilen sin hvor som helst | Config.Install.anywhere = true. Legger til en Install-knapp på bilstereoen og kommandoen /caraudio (Config.Install.command). |
| Hvilke biler som kan bygges | Config.Install.vehicles: 'owned' (standard) eller 'any'. Se del 7. |
| Bare mekanikere får montere | Config.Install.anyone = false og list jobbene i Config.Install.jobs (de må være på vakt). |
| Gratis bildeler | Config.Install.chargeParts = false. Config.Install.account er bank eller cash. |
| Priser på bildeler og de ferdige settene | Catalogue.CarParts og Catalogue.CarKits i config/catalogue.lua |
| Fabrikklyden til en bil | Vehicles.ByClass og Vehicles.ByModel i config/vehicles.lua (basic, premium, reference, bike, none) |
| Bibliotek av eller på | Config.Sources.library. Se del 8. |
| Dine egne sanger | Config.Library (filer i web/library/) |
| Stilletid | Config.QuietHours = { enabled = true, from = 23, to = 7, maxVolume = 0.35 } (serverens lokale tid) |
| Politijobber og -fullmakter | Config.Police (se del 10) |
| Høyttalere som går i stykker når de skytes | Config.Damage.enabled |
| Ytelsesgrenser | Config.Streaming.propRange (modeller tegnes innenfor 90 m), maxAudibleSessions (6 forskjellige sanger hørt samtidig), maxMovingParts (24 animerte membraner per frame) |
| Ekstra konsollinjer for support | Config.Debug (sett den til true mens du jakter på et problem) |
Item-navn. Hvis et annet script allerede bruker et av zds_-item-navnene, gi det produktets nøkkel et nytt navn i Catalogue.Speakers (for eksempel zds_roam = { ... }), bruk så det nye navnet i inventoryet ditt og gi bildet tilsvarende navn.
6. Kontroller
| Hva | Hvordan |
|---|---|
| Åpne fjernkontrollen | /sound, eller E ved en høyttaler, eller Sound-appen i Pulse Phone |
| Bilstereo | K mens du sitter i en bil (kan bindes om i GTA-innstillingene) |
| Sette ned en høyttaler | Bruk itemet. Sikt dit den skal: den vises grønn der den passer. Musehjulet eller Q / E roterer den. Enter eller venstreklikk setter den ned; Backspace eller høyreklikk avbryter. |
| Stable et line array | Mens du setter det ned, hever eller senker Pil opp / Pil ned det |
| Bære en Roam | Den kommer ut i hendene dine og fortsetter å spille mens du går. E musikk, G sett ned, H pakk sammen. Setter du deg i en bil eller går i vannet, pakkes den bort. |
| Flytte eller pakke sammen en høyttaler du eier | Target den og velg Move eller Pack up, eller uten target-ressurs, stå ved siden av den: G flytt (på en Roam: bær den igjen), H pakk sammen. Speakers-fanen i fjernkontrollen kan også pakke sammen. |
| Koble sammen høyttalere | Koble til en av dine, åpne Speakers-fanen i fjernkontrollen og trykk Link ved siden av de andre høyttalerne dine i nærheten. Bærbare kobles med bærbare, innendørs med innendørs, konsert med konsert (innenfor henholdsvis 40 m, 60 m og 250 m). |
| Installatør for bilstereo | Kjør inn i verkstedet som sjåfør og trykk E (eller Install-knappen på stereoen / /caraudio når bygging hvor som helst er på). Dra en del for å skyve den over overflatene på bilen, Alt + dra skyver den flatt i sin egen høyde (uten snapping), Shift + dra løfter den, Q / E eller Shift + scroll roterer den. |
| Syng gjennom høyttalerne | Ved DJ-mikseren eller et mikrofonstativ (selges i butikken, kobles sammen som en høyttaler) på høyttalerne du er koblet til, eller ved mikrofonstativet på en bilbygg: /soundmic tar mikrofonen, /soundmic igjen legger den tilbake |
| Melde fra om høy musikk | /noise |
| Adminliste | /soundadmin |
| Gi et item (serverkonsoll) | givespeaker <player id> <item name> |
| Sprenge en sub for å vise effekten (staff) | /soundblow i bilen, eller soundblow <plate> i konsollen |
I fjernkontrollen: Music (serverens bibliotek), Queue (neste, lagrede spillelister), Speakers (strøm og nivå for hver høyttaler, kobling, pakking) og Tune (seks lydmodi, en tre-bånds equalizer, hvem som velger musikken, åpningstider og "Real distance" for konsertoppsett). Hvem som velger musikken: Only me; Party, der alle i nærheten kan be om sanger som eieren godkjenner; eller Anyone, der folk i nærheten kan spille av, pause, hoppe over, legge i kø og spole. Opening hours spiller av seg selv en av eierens spillelister mellom to klokkeslett, for en butikk eller en klubb.
Mikrofonen (krever pma-voice). Mens du holder den, hører alle i nærheten av en høyttaler i det systemet stemmen din gjennom den, med PA-lyd, like høyt som den høyttaleren spiller musikk og så langt som den når; gå 4 m bort fra mikseren eller mikrofonstativet, koble fra eller legg mikrofonen tilbake, så er stemmen din normal igjen. Bare eieren av systemet (og admins, for en bil) kan synge gjennom det; gi andre spillere ace-en zds.mic så de kan bruke alle systemer. Stemmen din høres ikke fra hver høyttalers plass: voicechat kan ikke plassere en stemme der, så folk i nærheten av en høyttaler hører deg i stedet med den høyttalerens lydstyrke. Innstillinger: Config.Mic.
7. Bilstereo
Hvordan spillerne bygger
- Kjør inn i monteringsverkstedet for bilstereo (Benny's som standard) og trykk E som sjåfør.
- Start fra et ferdig sett (Daily thump, Competition, Trunk wall, Sound quality, Clean and hidden) eller velg deler: subwoofere (8" til 18"), kasser, forsterkere, dørhøyttalere, diskanter, pods, falske gulv, paneler, plexi, kondensator, ekstra batteri, LED-list og hovedenhet.
- Dra hver del på plass i bilen. Subs faller ned i utskjæringene i kassen sin. Hver del får en utførelse (åtte farger), og subs og høyttalere en grill og en lysring. Mirror kopierer en del til den andre siden; Fine position flytter den i små steg. Fem kameravinkler: Boot, Cabin, Side, Front, Top. Størrelse: subs finnes i 8", 10", 12", 15" og 18" (alle subs i en kasse har samme størrelse, og kassen bygges rundt dem, opptil 30% større eller mindre enn den var laget for); dørhøyttalere i 5.25", 6.5" og 6x9"; alle andre deler fra 80% til 130% i steg på 5% (hovedenheten har standardstørrelse). Større kasser og paneler koster mer; en del som gjøres mindre koster ingenting. Membranene beveger seg lenger på større elementer, og en større dørhøyttaler går dypere.
- Trykk Test system for å høre oppsettet spille i bilen før du betaler. Det spiller den første sangen i
Config.Library(demosporet som følger med, med mindre du har endret det). - Trykk Install. Bare deler som er nye for bilen koster penger; deler beholdt fra forrige installasjon belastes ikke på nytt.
Installasjonen lagres knyttet til skiltet og kommer tilbake når bilen gjør det: fra enhver garasje, beslagleggelse eller respawn. Ingenting å redigere i garasjescriptet ditt.
Hva spillerne hører
- Hver bil har allerede en fabrikklyd etter klasse og modell: et system med 4 høyttalere, et premium-system med 10 høyttalere eller et referansesystem med 13 høyttalere, kåpehøyttalere på motorsykler; sykler, fly og tog har ingen. Monterte høyttalere erstatter fabrikkhøyttalerne nærmest dem; subs kommer i tillegg.
- Utenfor bilen er det mest bassen som kommer gjennom karosseriet. Åpne dører, åpne vinduer og et åpent bagasjerom slipper hver for seg ut mer, mot den siden de vender.
- En bil med subs hopper forsiktig på fjærene i takt med bassen mens den står parkert eller kryper (aldri under kjøring), og alle inne kjenner kicken.
- Stereoen (K) har volum, sub-nivå, fader og balanse.
- Subs som drives langt forbi det forsterkeren og spesifikasjonen tillater, nær fullt volum, en stund, kan sprenges. Alle nær bilen ser en tynn røykdott fra den suben og hører et dumpt smell. En sprengt sub slutter å bevege seg, bassen faller, og membranen forblir svidd til den byttes i verkstedet (en ny sub må betales; å fjerne merket er ikke en gratis reparasjon). Staff kan vise det:
/soundblowi bilen, ellersoundblow <plate>i serverkonsollen.
Hvilke biler som kan bygges (Config.Install.vehicles)
'owned'(standard): bare biler i frameworkets tabell over eide kjøretøy (owned_vehiclespå ESX,player_vehiclespå QBCore og Qbox).'any': også biler ingen eier (NPC-biler, spawnede biler, leiebiler).- Uansett forblir en bil en annen spiller eier deres: bare eieren, en mekaniker på vakt fra
Config.Install.jobs, eller en admin kan endre den. På en standalone-server regnes alle biler som eid.
Garasjer, skilt og beslagleggelse
- Skilt sammenlignes uten mellomrom i endene og med store bokstaver, så garasjer som fyller ut eller endrer store/små bokstaver på skilt fortsatt treffer.
- En bil med falskt eller endret skilt finner ikke installasjonen sin før den har det lagrede skiltet igjen.
- Biler som bare finnes på én spillers skjerm (garasjeforhåndsvisninger, noen showroom-biler) får aldri en installasjon: de er ikke ekte biler for noen andre.
Andre lyd- eller stereoscripts
ZeroDev Sound er sin egen ressurs med egne kommandoer (/sound, /caraudio, ...), events og state bags for kjøretøy, så den erstatter eller endrer ikke andre scripts (mens den spiller i en bil slår den bare av GTAs egen bilradio). Å kjøre to bilstereoscripts på samme bil samtidig er ikke testet sammen: bruk én stereo per bil.
8. Musikkilder
Musikk spilles bare fra lydfiler du legger til i resourcen. Spillerne velger fra listen din; de kan ikke skrive inn lenker, og ingen nettadresse spilles noen gang av. Legg bare til lyd du eier eller har rett til å bruke og distribuere.
- Legg mp3- eller ogg-filer i
zerodev-sound/web/library/og før opp hver av dem iConfig.Librarysom{ title = '...', artist = '...', file = 'name.mp3' }. De får hele opplevelsen: 3D-lyd, rom og vegger, bilkabiner, lydmodi, EQ og kjegler som beveger seg med den ekte bassen. Config.Sources.library = falseslår av biblioteket.- GTAs egen bilradio fungerer fortsatt i alle biler så lenge ingen sang fra denne resourcen spilles i dem.
- Oppstartsboksen viser hvor mange sanger spillerne kan velge, og advarer om hver oppføring den hoppet over (et
filnavn som ikke er mp3 eller ogg i
web/library/). - Oppdatering fra 3.0.0: lagrede sanger, nylige sanger og spilleliste-oppføringer som var lenker, vises eller spilles ikke lenger av. Sanger i biblioteket fungerer fortsatt.
9. Pulse Phone
Ingenting å sette opp. Når Pulse Phone kjører på serveren (ressursnavn phone, begge utgavene):
- Hver telefon får en Sound-app på hjemskjermen. Det er den samme fjernkontrollen som
/sound: koble til en høyttaler eller bilen, velg musikk, styr hele gruppen. Spillerne kan fjerne den og hente den tilbake fra App Hub. - Det som spilles på den tilkoblede høyttaleren eller bilen, med gjenstående tid, vises på Island og låseskjermen. Et trykk åpner Sound-appen.
- Pulse Drive (Pulses bilskjerm, F10 som standard) viser stereoen i bilen du sitter i: sang, artist og cover, med spill av, pause, forrige, neste og volum, og en Open-knapp for Sound-appen. Dette krever Pulse Phone 1.2.9 eller nyere; eldre versjoner viser det rett og slett ikke.
Spillere uten telefonen bruker /sound og K, som gjør alt appen gjør.
Har du gitt telefonens mappe nytt navn, legg til denne linjen i config/config.lua med navnet:
Config.PulseResource = 'phone'10. Politi, naboer og admins
| Hva | Hvordan | Innstilling |
|---|---|---|
| Melde fra om høy musikk | /noise sender den nærmeste høyttaleren som spiller (innenfor 60 m) til politi på vakt som en blinkende blip i 3 minutter. Én melding per spiller hvert 2. minutt. |
Config.Police.complaints, complaintRange |
| Slå av en høyttaler | Politi på vakt: target høyttaleren > Turn off (police), eller Tune-fanen i fjernkontrollen > Police. Innenfor 12 m. | Config.Police.canSilence, silenceMinutes (15) |
| Beslaglegge en høyttaler | Politi på vakt, innenfor 4 m: target > Seize (police), eller Tune > Police > Seize. Høyttaleren går til betjenten. | Config.Police.canSeize |
| Politijobber | Spillere med disse jobbene, på vakt | Config.Police.jobs |
| Ødelagte høyttalere | Å skyte en plassert høyttaler ødelegger den: den knitrer og stopper. Et Speaker Repair Kit (selges i butikken under Accessories) reparerer den: bruk settet ved siden av den. | Config.Damage |
| Adminliste | /soundadmin: hver høyttaler på serveren, hva den spiller og hvem som eier den, med knapper for å sette et waypoint, stoppe musikken eller fjerne høyttaleren. |
Config.AdminAce (zerodev.sound.admin) |
| Gi et item | Serverkonsoll: givespeaker <player id> <item name> |
11. Språk
Scriptet leveres på de samme 25 språkene som Pulse Phone. Velg ett i config/config.lua:
| Kode | Språk | Kode | Språk | Kode | Språk |
|---|---|---|---|---|---|
en |
Engelsk | 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 |
简体中文 |
Config.Locale = 'de', for eksempel. Standardverdien, 'auto', følger Pulse Phone: serveren bruker Pulses Config.Locale, og hver spiller får Sound på språket de valgte på telefonen sin. Uten Pulse er det engelsk. Meldinger i spillet, tastemeldinger, item-navn og navnet på stereotasten ligger i locales/<code>.lua; grensesnittet (fjernkontroll, bilstereo, butikk, installatør, Pulse-app) ligger i locales/<code>_ui.lua. Alt som mangler, faller tilbake til engelsk.
For å endre en linje, rediger den i filen for det språket. Behold hver %s, %d, %.1f, %% og ~a~ som de er. For å legge til et eget språk, kopier locales/en.lua til locales/xx.lua, endre Locales['en'] til Locales['xx'] (begge steder), oversett teksten mellom anførselstegnene og sett Config.Locale = 'xx'. locales/ui_strings.txt lister hver grensesnittnøkkel for en xx_ui.lua.
12. Feilsøking
Spillerne kan ikke bruke høyttaler-itemene
- ox_inventory: oppføringene må være inne i
ox_inventory/data/items.luamedclient-linjen sin, og ox_inventory må startes på nytt etter innlimingen. Mappen må fortsatt hetezerodev-sound(oppføringene kallerzerodev-sound.useItem). - QBCore / ESX:
zerodev-soundmå starte etter frameworket ditt iserver.cfg. - codem-inventory på QBCore: fullfør codem-inventory sitt eget steg som peker
QBCore.Functions.UseItemmot det. - Uten inventory: høyttalere er ikke items. Spillerne åpner
/soundog trykker Set up under Your speakers.
Item-bilder mangler
- ox_inventory: ingenting å kopiere; bildestien peker på zerodev-sound. Er de tomme, sjekk oppføringens
image = 'nui://zerodev-sound/...'-linje og mappenavnet. - Andre inventories: les konsollinjen
Copy ... into ...: den lister bildene som mangler og mappen de skal i. Kopier dem frazerodev-sound/web/img/items/og start inventoryet på nytt.
En spiller kan ikke spille av en lenke
Det er med vilje: spillerne velger bare fra biblioteket ditt. Legg sangen til i
Config.Library (del 8).
Ingen lyd i det hele tatt
- FiveMs innebygde nettleser starter lyd uten klikk, så spillerne trenger aldri trykke noe for å «tillate» lyd. Hører én spiller ingenting mens andre gjør det, sjekk FiveM i Windows-volummikseren deres.
- Sjekk høyttaleren i Speakers-fanen i fjernkontrollen: den kan være slått av, eller Broken.
- Politiet kan ha slått den av (i
Config.Police.silenceMinutes), eller stilletid kan begrense volumet (Config.QuietHours). - En spiller hører maksimalt
Config.Streaming.maxAudibleSessionsforskjellige sanger samtidig (6), nærmeste først. - Test system i installatøren er stille når
Config.Libraryer tom ellerConfig.Sources.library = false: den spiller den første sangen i biblioteket.
Butikken er ikke der
Config.Shop.enabledmå væretrue.- Ekspeditøren og standen dukker bare opp når en spiller er innenfor rundt 70 m fra
Config.Shop.locations, og bare på den spillerens skjerm. Sjekk koordinatene du har satt. - Med ox_target eller qb-target, target ekspeditøren. Uten, stå ved ekspeditøren: E Browse speakers.
En høyttaler vises som en vanlig GTA-høyttaler, eller ikke i det hele tatt
stream/-mappen mangler eller har fått nytt navn, eller spilleren koblet til før ressursen startet. Start serveren på nytt og koble til igjen.
Bilstereomeldinger og hva de betyr
| Melding | Hvorfor | Løsning |
|---|---|---|
| Drive into a car audio bay to build. | Bygging hvor som helst er av, og bilen er ikke i et verksted. | Kjør inn i verkstedet (Config.Install.bays), eller sett Config.Install.anywhere = true. |
| Stand next to your car to build its sound system. | Bygging hvor som helst er på, og du er mer enn 8 m fra bilen, eller /caraudio fant ingen bil innenfor 4 m. |
Stå ved bilen eller sitt i den. |
| Stop the car first. | Bilen er i bevegelse. | Stopp. |
| Car audio can only be fitted to a car you own. | Config.Install.vehicles = 'owned', og dette skiltet står ikke i tabellen over eide kjøretøy. Vises også for alle unntatt admins når den tabellen ikke kan leses: konsollen viser da en rød linje could not read the owned-vehicles table. |
Bruk en eid bil, sett 'any', eller rett databasefeilen konsollen navngir. |
| Only the owner can change this car's audio. | Bilen tilhører en annen spiller. Vises også når Config.Install.anyone = false og spilleren ikke har en jobb på vakt fra Config.Install.jobs. |
Eieren bygger det, eller en mekaniker på vakt, eller en admin. |
| Not enough money. | De nye delene koster mer enn spilleren har på Config.Install.account. |
Fjern deler, eller sett Config.Install.chargeParts = false. |
| A subwoofer blew. It needs replacing. | Subs ble presset for hardt for lenge nær fullt volum. | Bytt suben i verkstedet; en større forsterker hjelper. |
Politiet ser ikke valgene sine
Legg til politijobbnavnene dine i Config.Police.jobs. Spillerne må være på vakt.
13. Oppdatering
Kommer du fra 1.x til 2.0: les UPGRADING.md. Mellom 2.x-versjoner:
- Ta backup av
config/-mappen,locales/hvis du har oversatt den, og eventuelle sanger du har lagt til iweb/library/. - Stopp serveren. Erstatt
zerodev-sound-mappen med den nye (behold navnet). - Legg
config/-filene dine tilbake. Hvis oppdateringsnotatene nevner nye innstillinger, kopier de linjene fra de nye filene inn i dine. - Start serveren og les konsollen. Eventuelle nye items skrives ut for inventoryet ditt.
Plasserte høyttalere, bilinstallasjoner og spillelister lagres i databasen (zds_speakers, zds_car_builds, zds_playlists, zds_stash) og røres ikke av en oppdatering.
Gå tilbake: behold den forrige zerodev-sound-mappen utenfor resources til den nye versjonen kjører fint, og ta backup av databasen før du oppdaterer. For å gå tilbake stopper du serveren, legger tilbake den forrige mappen og config/, og starter den. Å gå tilbake fra 3.0 til 2.x på samme database er ikke testet, så gjenopprett databasebackupen hvis noe ser feil ut.