ZeroDev Sound-dokumentasjon

ZeroDev Sound: installasjonsguide

For ZeroDev Sound 3.0.127 min lesingOppdatert

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:

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

Steg 3. Gi adminene dine admin-tillatelsen (ingen høyttalergrense, /soundadmin-listen, fjernstopp og fjerning):

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

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

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:

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

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.Framework eller Config.Inventory i config/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)

  1. Kartet viser en ZeroDev Sound-blip på Legion Square og en Car audio bay-blip ved Benny's.
  2. 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.
  3. 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.
  4. Sett deg inn i en bil. De første gangene sier hjørnet av skjermen hvilken tast som åpner bilstereoen (K som standard).
  5. 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

  1. Kjør inn i monteringsverkstedet for bilstereo (Benny's som standard) og trykk E som sjåfør.
  2. 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.
  3. 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.
  4. 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).
  5. 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: /soundblow i bilen, eller soundblow <plate> i serverkonsollen.

Hvilke biler som kan bygges (Config.Install.vehicles)

  • 'owned' (standard): bare biler i frameworkets tabell over eide kjøretøy (owned_vehicles på ESX, player_vehicles på 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 i Config.Library som { 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 = false slå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:

Lua
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.lua med client-linjen sin, og ox_inventory må startes på nytt etter innlimingen. Mappen må fortsatt hete zerodev-sound (oppføringene kaller zerodev-sound.useItem).
  • QBCore / ESX: zerodev-sound må starte etter frameworket ditt i server.cfg.
  • codem-inventory på QBCore: fullfør codem-inventory sitt eget steg som peker QBCore.Functions.UseItem mot det.
  • Uten inventory: høyttalere er ikke items. Spillerne åpner /sound og 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 fra zerodev-sound/web/img/items/ og start inventoryet på nytt.

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.maxAudibleSessions forskjellige sanger samtidig (6), nærmeste først.
  • Test system i installatøren er stille når Config.Library er tom eller Config.Sources.library = false: den spiller den første sangen i biblioteket.

Butikken er ikke der

  • Config.Shop.enabled må være true.
  • 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:

  1. Ta backup av config/-mappen, locales/ hvis du har oversatt den, og eventuelle sanger du har lagt til i web/library/.
  2. Stopp serveren. Erstatt zerodev-sound-mappen med den nye (behold navnet).
  3. Legg config/-filene dine tilbake. Hvis oppdateringsnotatene nevner nye innstillinger, kopier de linjene fra de nye filene inn i dine.
  4. 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.

Oversatt fra engelsk. Hvis noe her ikke stemmer med den engelske siden, er det den engelske siden som gjelder. English