ZeroDev Sound-dokumentation

ZeroDev Sound: installationsguide

Til ZeroDev Sound 3.0.127 min. læsningOpdateret

Denne resource indeholder eller leverer ingen lyd- eller musikintegrationer fra tredjeparter. Musik afspilles kun fra lydfiler, som serverejeren tilføjer til resourcen, og fra GTA's indbyggede radio. Spillere kan ikke indtaste links. Tilføj kun lyd, du ejer eller har ret til at bruge og distribuere; streaming af indhold uden tilladelse kan overtræde Cfx.re Creator Platform License Agreement og loven.

Højttalere som spillerne køber, bærer rundt på, stiller ned og forbinder, og bilanlæg som de bygger ind i deres egne biler. Dette er den fulde reference. For den korte version, læs docs/SETUP.md (5 trin); ved problemer, docs/TROUBLESHOOTING.md; kommer du fra 1.x, UPGRADING.md.

Indhold 1. Krav 2. Installation 3. Items til dit inventory 4. Første opstart: hvad du bør se 5. De indstillinger, folk oftest ændrer 6. Kontroller 7. Bilanlæg 8. Musikkilder 9. Pulse Phone 10. Politi, naboer og admins 11. Sprog 12. Fejlfinding 13. Opdatering

1. Krav

Påkrævet oxmysql. ZeroDev Sound opretter sine egne tabeller ved første opstart; der er ingen SQL-fil at importere.
Framework ESX Legacy, QBCore, Qbox eller intet (standalone). Findes af sig selv.
Inventory ox_inventory, qb-inventory (også ps- og lj-inventory), qs-inventory, codem-inventory, core_inventory, origen_inventory, tgiann-inventory, ESX-inventory eller intet. Findes af sig selv.
Valgfrit ox_target eller qb-target (uden et af dem får spillerne i stedet en tast-prompt på skærmen). Pulse Phone 1.2.9 eller nyere (tilføjer Sound-appen og bilstereoen på Pulse Drive). pma-voice til mikrofonen: uden pma-voice kan man holde mikrofonen og synge i den, men ingen hører det gennem højttalerne.

Intet andet: ingen ox_lib, ingen API-nøgle, ingen Google-konto.

Linux-servere

Linux-servere: brug server-artifact'et Recommended, ikke Latest. På FiveM-serverens downloadside (docs.fivem.net/docs/server-download/) skal du vælge Linux og opdateringsgrenen Recommended. En server på det nyeste Linux-artifact crashede under indlæsning (FXServer udskrev et /proc/self/maps-dump), og skift til det anbefalede artifact løste det. Det er den eneste Linux-rapport, vi har; vi har endnu ikke selv kørt ZeroDev Sound på en Linux-server.

Linux-servere: brug server-artifact'et Recommended, ikke Latest. På FiveM-serverens downloadside (docs.fivem.net/docs/server-download/) skal du vælge Linux og opdateringsgrenen Recommended. En server på det nyeste Linux-artifact crashede under indlæsning (FXServer udskrev et /proc/self/maps-dump), og skift til det anbefalede artifact løste det. Det er den eneste Linux-rapport, vi har; vi har endnu ikke selv kørt ZeroDev Sound på en Linux-server.

På en standalone-server (intet framework) er alt gratis: butikken og bildelene koster ingenting.

2. Installation

Trin 1. Læg mappen ind. Læg mappen zerodev-sound i din resources-mappe (en hvilken som helst undermappe er fin, for eksempel resources/[zerodev]/zerodev-sound). Behold mappenavnet zerodev-sound: ox_inventory's item-indgange kalder den ved det navn.

Trin 2. Tilføj den til server.cfg, efter din database, dit framework og dit inventory:

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

Trin 3. Giv dine admins admin-tilladelsen (ingen grænse for højttalere, /soundadmin-listen, fjernstop og fjernelse):

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

Trin 4. Sæt items op til dit inventory: afsnit 3. På ESX-inventory og på QBCore bliver det gjort for dig.

Trin 5. Genstart serveren (en fuld genstart, ikke kun ressourcen, så alle spillere indlæser modellerne), og tjek konsollen: afsnit 4.

3. Items til dit inventory

Der er 12 items: ti højttalere, mikrofonstativet og reparationskittet.

Item-navn Mærkat Vægt
zds_roam Roam bærbar højttaler 2 kg
zds_room_shelf Reolhøjttaler 4 kg
zds_room_tower Tårnhøjttaler 10 kg
zds_room_ceiling Loftshøjttaler 2 kg
zds_room_sub Hjemmesubwoofer 8 kg
zds_stage_pa PA Speaker 10 kg
zds_stage_sub Koncertsubwoofer 15 kg
zds_stage_array Line Array Speaker 12 kg
zds_stage_monitor Scenemonitor 6 kg
zds_stage_mixer DJ-mixer 5 kg
zds_stage_mic Mikrofonstativ 3 kg
zds_repair_kit Speaker Repair Kit 0,6 kg

Billederne ligger i zerodev-sound/web/img/items/. Du skal aldrig gætte: når noget mangler, udskriver serverkonsollen præcis de indgange, dit inventory skal bruge, og nævner ethvert billede, der endnu ikke er på plads.

Hvilket inventory har du?

Inventory Hvad du gør Billederne skal i
ESX-inventory (ESX Legacy uden ox) Intet. Items tilføjes til items-tabellen ved opstart. Intet at kopiere
ox_inventory (ESX, Qbox eller standalone) Indsæt ox_inventory-blokken i ox_inventory/data/items.lua, inde i tabellen. Genstart ox_inventory og derefter zerodev-sound. Intet at kopiere: indgangene indlæser billederne fra zerodev-sound
qb-inventory, ps-inventory, lj-inventory (QBCore) Intet. Items tilføjes til QBCore's shared items ved opstart. Kopiér web/img/items/*.png til <your inventory>/html/images/
qs-inventory På QBCore skal du indsætte QBCore-blokken i qb-core/shared/items.lua. På ESX skal du indsætte de samme indgange i qs-inventory/shared/items.lua. qs-inventory/html/images/
codem-inventory Tilføj de 12 items til codem-inventory/config/itemlist.lua med navne, etiketter og vægte fra QBCore-blokken. På QBCore skal du også gennemføre codem-inventory's eget installationstrin, der peger QBCore.Functions.UseItem på codem-inventory, ellers kan items ikke bruges. codem-inventory's mappe til item-billeder
core_inventory Intet. Items tilføjes for dig til QBCore's shared items eller ESX' items-tabel. core_inventory's mappe til item-billeder
origen_inventory Tilføj de 12 items til origen_inventory/config/items.lua med navne, etiketter og vægte fra QBCore-blokken. origen_inventory's mappe til item-billeder
tgiann-inventory Tilføj de 12 items til tgiann-inventory/items/items.lua med navne, etiketter og vægte fra QBCore-blokken. inventory_images/images/
Intet inventory Intet. Købte og nedpakkede højttalere venter i /sound under Your speakers, med en Set up-knap. Intet at kopiere

For at tilføje items til qb-core i hånden i stedet for at lade scriptet gøre det skal du indsætte QBCore-blokken i qb-core/shared/items.lua.

Et andet inventory, der kopierer en af disse API'er: sæt Config.Inventory til det (se afsnit 5). Et hjemmelavet inventory kan forbindes i server/bridge.lua, som kan læses: hvert inventory der er tre små funktioner (tæl, tilføj, fjern).

ox_inventory-blok

Indsæt inde 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-blok

QBCore-itemformatet, som qb-, ps-, lj- og qs-inventory læser:

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 ændret en etiket, pris eller vægt i config/catalogue.lua, så kopiér i stedet indgangene fra din egen konsol: den udskriver dem ud fra dine indstillinger.

4. Første opstart: hvad du bør se

I serverkonsollen

ZeroDev Sound udskriver én tjekboks (skriv soundcheck i serverkonsollen for at udskrive den igen): database og skema, framework, penge, inventory og items, garagetabellen, targeting, Pulse Phone, modeller, monteringsværksteder og indstillinger ændret i spillet. Hver linje, der ikke er OK, siger, hvad du skal gøre; docs/SETUP.md viser et eksempel, og docs/TROUBLESHOOTING.md forklarer hver linje.

  • Framework-linjen nævner, hvad der blev fundet. Hvis det er forkert, så sæt 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) efterfulgt af item-indgange: gør afsnit 3 for dit inventory, og genstart derefter. ox_inventory-beskeden stopper, så snart items er der. På qs-, codem-, origen- og tgiann-inventory udskrives indgangene ved hver opstart som en påmindelse, uanset om du har tilføjet dem eller ej.
  • En gul linje Copy zds_....png from zerodev-sound/web/img/items into ...: de billeder er endnu ikke i dit inventorys billedmappe. Den nævner mappen.
  • Pulse Phone app not registered: ...: Pulse Phone kører, men afviste appen. Se afsnit 9.

I spillet (fem tjek)

  1. Kortet viser et ZeroDev Sound-blip på Legion Square og et Car audio bay-blip ved Benny's.
  2. I butikken står en ekspedient ved en stand med højttalerne udstillet. Target ekspedienten (eller tryk E, når der ikke er nogen target-ressource), og køb en Roam Portable Speaker.
  3. Brug den fra dit inventory. Den kommer frem i dine hænder. Tryk E, åbn Library, og afspil Night Drive (et demonummer, der følger med scriptet). Folk omkring dig hører det.
  4. Sæt dig ind i en bil. De første par gange siger hjørnet af skærmen, hvilken tast der åbner bilstereoen (K som standard).
  5. Kør ind i monteringsværkstedet som fører, og tryk E. Installationsværktøjet åbner på din bil.

5. De indstillinger, folk oftest ændrer

I spillet: /soundadmin > Settings ændrer de almindelige live for alle (monteringsværksteder, hvem der må installere, hvilke biler, priser, højeste lydstyrke, stilletimer, grænser, butik, politi og skader). De gemmes i databasen og vinder over config.lua, indtil du trykker Reset to config i panelet.

Alt ligger i config/config.lua, medmindre andet er nævnt. Produkter, priser og bildele ligger i config/catalogue.lua; hver bils fabrikslyd ligger i config/vehicles.lua.

Hvad du vil Indstilling
Tvinge framework eller inventory Config.Framework (auto, esx, qb, qbox, standalone), Config.Inventory (auto, ox, qb, qs, codem, core, origen, tgiann, esx, none)
Ændre kommandoen til fjernbetjeningen Config.Command (standard sound, altså /sound)
Ændre tasten til bilstereoen Config.HeadUnitKey (standard K). Spillerne kan selv binde den om i GTA-indstillinger > Key Bindings > FiveM.
Højttalere pr. spiller Config.MaxPlacedPerPlayer (standard 8). Admins har ingen grænse.
Højttalere i én forbundet gruppe Config.MaxLinkedPerGroup (standard 16)
Hvor tæt man skal være for at forbinde, hvor langt væk man kan styre Config.PairRange (15 m), Config.ControlRange (80 m)
Flytte butikken eller tilføje flere butikker Config.Shop.locations. Hver tager label, coords, blip og eventuelt heading (hvilken vej standen vender) og clerk (en ped-model). Config.Shop.account er bank eller cash. Config.Shop.enabled = false fjerner butikken.
Priser på højttalere price på hvert produkt i config/catalogue.lua > Catalogue.Speakers. Prisen på reparationskittet er Config.Damage.repairPrice.
Hvor bilanlæg monteres Config.Install.bays (hver med label, coords, radius, blip). Standard: ét værksted ved Benny's.
Lade ejere bygge ved deres bil hvor som helst Config.Install.anywhere = true. Tilføjer en Install-knap på bilstereoen og kommandoen /caraudio (Config.Install.command).
Hvilke biler der kan bygges Config.Install.vehicles: 'owned' (standard) eller 'any'. Se afsnit 7.
Kun mekanikere må installere Config.Install.anyone = false, og angiv jobbene i Config.Install.jobs (de skal være på tjeneste).
Gratis bildele Config.Install.chargeParts = false. Config.Install.account er bank eller cash.
Priser på bildele og de færdige kits Catalogue.CarParts og Catalogue.CarKits i config/catalogue.lua
En bils fabrikslyd Vehicles.ByClass og Vehicles.ByModel i config/vehicles.lua (basic, premium, reference, bike, none)
Bibliotek slået til eller fra Config.Sources.library. Se afsnit 8.
Dine egne sange Config.Library (filer i web/library/)
Stilletimer Config.QuietHours = { enabled = true, from = 23, to = 7, maxVolume = 0.35 } (serverens lokale tid)
Politijobs og -beføjelser Config.Police (se afsnit 10)
Højttalere der går i stykker, når der skydes på dem Config.Damage.enabled
Ydeevnegrænser Config.Streaming.propRange (modeller tegnes inden for 90 m), maxAudibleSessions (6 forskellige sange høres på én gang), maxMovingParts (24 animerede membraner pr. frame)
Ekstra konsollinjer til support Config.Debug (sæt den til true, mens du jagter et problem)

Item-navne. Hvis et andet script allerede bruger et af zds_-item-navnene, så omdøb det produkts nøgle i Catalogue.Speakers (for eksempel zds_roam = { ... }), brug derefter det nye navn i dit inventory, og omdøb billedet, så det passer.

6. Kontroller

Hvad Hvordan
Åbn fjernbetjeningen /sound, E ved en højttaler eller Sound-appen i Pulse Phone
Bilstereo K, mens du sidder i en bil (kan bindes om i GTA-indstillinger)
Stil en højttaler ned Brug dens item. Sigt derhen, hvor den skal stå: den vises grøn, hvor den passer. Musehjulet eller Q / E drejer den. Enter eller venstreklik stiller den ned; Backspace eller højreklik annullerer.
Stabl et line array Mens du stiller den ned, hæver eller sænker Arrow Up / Arrow Down den
Bær en Roam Den kommer frem i dine hænder og bliver ved med at spille, mens du går. E musik, G stil ned, H pak sammen. Når du sætter dig ind i en bil eller går i vandet, pakkes den væk.
Flyt eller pak en højttaler, du ejer, sammen Target den, og vælg Move eller Pack up, eller stil dig ved siden af den uden en target-ressource: G flyt (på en Roam: bær den igen), H pak sammen. Fjernbetjeningens Speakers-fane kan også pakke sammen.
Forbind højttalere Forbind til en af dine, åbn fjernbetjeningens Speakers-fane, og tryk Link ud for dine andre højttalere i nærheden. Håndholdte forbindes med håndholdte, indendørs med indendørs, koncert med koncert (inden for henholdsvis 40 m, 60 m og 250 m).
Installationsværktøj til bilanlæg Kør ind i værkstedet som fører, og tryk E (eller Install-knappen på stereoen / /caraudio, når byg-hvor-som-helst er slået til). Træk en del for at lade den glide hen over bilens flader, Alt + træk skubber den fladt i dens højde (uden snap), Shift + træk løfter den, Q / E eller Shift + scroll drejer den.
Syng gennem højttalerne Ved DJ-mixeren eller et mikrofonstativ (sælges i butikken, forbind det som en højttaler) på de højttalere, du er forbundet til, eller ved mikrofonstativet i et bilbyg: /soundmic tager mikrofonen, /soundmic igen lægger den tilbage
Anmeld høj musik /noise
Admin-liste /soundadmin
Giv et item (serverkonsol) givespeaker <player id> <item name>
Spræng en sub for at vise effekten (staff) /soundblow i bilen eller soundblow <plate> i konsollen

I fjernbetjeningen: Music (serverens bibliotek), Queue (næste op, gemte playlister), Speakers (hver højttalers strøm og niveau, sammenkobling, pakning) og Tune (seks lydtilstande, en tre-bånds equalizer, hvem der vælger musikken, åbningstider og "Real distance" til koncertopsætninger). Hvem der vælger musikken: Only me; Party, hvor alle i nærheden kan bede om sange, som ejeren godkender; eller Anyone, hvor folk i nærheden kan afspille, pause, springe over, sætte i kø og spole. Opening hours afspiller af sig selv en af ejerens playlister mellem to klokkeslæt, til en butik eller en klub.

Mikrofonen (kræver pma-voice). Mens du holder den, hører alle i nærheden af en højttaler i det system din stemme gennem den, med PA-lyd, lige så højt som den højttaler spiller musik og så langt, som den rækker; gå 4 m væk fra mixeren eller mikrofonstativet, afbryd forbindelsen eller læg mikrofonen tilbage, så er din stemme normal igen. Kun systemets ejer (og admins, for en bil) kan synge gennem det; giv andre spillere ace'en zds.mic, så de kan bruge ethvert system. Din stemme høres ikke fra hver højttalers plads: voicechat kan ikke placere en stemme der, så folk i nærheden af en højttaler hører dig i stedet med den højttalers lydstyrke. Indstillinger: Config.Mic.

7. Bilanlæg

Sådan bygger spillerne

  1. Kør ind i monteringsværkstedet (Benny's som standard), og tryk E som fører.
  2. Start fra et færdigt kit (Daily thump, Competition, Trunk wall, Sound quality, Clean and hidden), eller vælg dele: subwoofere (8" til 18"), kasser, forstærkere, dørhøjttalere, diskanthøjttalere, pods, falske bunde, paneler, plexi, kondensator, ekstra batteri, LED-strip og head unit.
  3. Træk hver del på plads i bilen. Subs falder ned i deres kasses udskæringer. Hver del får en finish (otte farver), og subs og højttalere et gitter og en lysring. Mirror kopierer en del til den anden side; Fine position flytter den i små trin. Fem kameravinkler: Boot, Cabin, Side, Front, Top. Størrelse: subs fås i 8", 10", 12", 15" og 18" (alle subs i en kasse har samme størrelse, og kassen bygges rundt om dem, op til 30% større eller mindre end den blev lavet til); dørhøjttalere i 5.25", 6.5" og 6x9"; alle andre dele fra 80% til 130% i trin på 5% (head unit'en har en standardstørrelse). Større kasser og paneler koster mere; en del, der gøres mindre, koster ingenting. Membraner bevæger sig mere på større enheder, og en større dørhøjttaler går dybere.
  4. Tryk Test system for at høre buildet spille gennem bilen, før du betaler. Det afspiller den første sang i Config.Library (det medfølgende demonummer, medmindre du har ændret det).
  5. Tryk Install. Kun dele, der er nye for bilen, koster penge; dele, der er beholdt fra sidste installation, betales ikke igen.

Installationen gemmes på nummerpladen og kommer tilbage, hver gang bilen gør: fra enhver garage, ethvert impound eller respawn. Intet at redigere i dit garagescript.

Hvad spillerne hører

  • Alle biler har allerede en fabrikslyd efter klasse og model: et 4-højttalersystem, et premium 10-højttalersystem eller et reference 13-højttalersystem, kåbehøjttalere på motorcykler; cykler, fly og tog har ingen. Monterede højttalere erstatter de fabrikshøjttalere, der er nærmest dem; subs lægges oveni.
  • Uden for bilen kommer mest bassen gennem karosseriet. Åbne døre, åbne vinduer og et åbent bagagerum lukker hver især mere ud, mod den side de vender.
  • En bil med subs gynger blødt på fjedrene med bassen, mens den holder parkeret eller kryber (aldrig under kørsel), og alle indeni mærker kicket.
  • Stereoen (K) har lydstyrke, sub-niveau, fader og balance.
  • Subs, der i et stykke tid presses langt ud over, hvad deres forstærker og specifikation tillader, nær fuld lydstyrke, kan sprænges. Alle i nærheden af bilen ser en tynd sky røg fra den sub og hører et dumpt knald. En sprængt sub holder op med at bevæge sig, bassen falder, og membranen forbliver forkullet, indtil den udskiftes i værkstedet (en ny sub skal betales; at fjerne mærket er ikke en gratis reparation). Staff kan vise det: /soundblow i bilen eller soundblow <plate> i serverkonsollen.

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

  • 'owned' (standard): kun biler i dit frameworks tabel over ejede køretøjer (owned_vehicles på ESX, player_vehicles på QBCore og Qbox).
  • 'any': også biler, som ingen ejer (NPC-biler, spawnede biler, lejebiler).
  • Uanset hvad forbliver en bil, som en anden spiller ejer, deres: kun dens ejer, en mekaniker på tjeneste fra Config.Install.jobs eller en admin kan ændre den. På en standalone-server tæller alle biler som ejede.

Garager, nummerplader og impounds

  • Nummerplader matches trimmet og med store bogstaver, så garager, der fylder op eller ændrer store/små bogstaver i nummerplader, stadig matcher.
  • En bil med en falsk eller ændret nummerplade finder ikke sin installation, før den har sin gemte nummerplade igen.
  • Biler, der kun findes på én spillers skærm (garage-forhåndsvisninger, nogle showroom-biler), får aldrig en installation: de er ikke rigtige biler for nogen andre.

Andre lyd- eller stereoscripts

ZeroDev Sound er sin egen ressource med sine egne kommandoer (/sound, /caraudio, ...), events og state bags på køretøjer, så den erstatter eller ændrer ikke andre scripts (mens den spiller i en bil, slukker den kun GTA's egen bilradio). At køre to bilanlægsscripts på den samme bil på én gang er ikke testet sammen: brug én stereo pr. bil.

8. Musikkilder

Musik afspilles kun fra lydfiler, du tilføjer til resourcen. Spillerne vælger fra din liste; de kan ikke indtaste links, og ingen webadresse afspilles nogensinde. Tilføj kun lyd, du ejer eller har ret til at bruge og distribuere.

  • Læg mp3- eller ogg-filer i zerodev-sound/web/library/ og angiv hver af dem i Config.Library som { title = '...', artist = '...', file = 'name.mp3' }. De får hele oplevelsen: 3D-lyd, rum og vægge, bilkabiner, lydtilstande, EQ og kegler, der bevæger sig med den rigtige bas.
  • Config.Sources.library = false slår biblioteket fra.
  • GTA's egen bilradio virker stadig i alle biler, så længe ingen sang fra denne resource afspilles i dem.
  • Startboksen viser, hvor mange sange spillerne kan vælge, og advarer om hver post, den sprang over (et filnavn, der ikke er mp3 eller ogg, i web/library/).
  • Opdatering fra 3.0.0: gemte sange, seneste sange og playlistposter, der var links, vises eller afspilles ikke længere. Sange i biblioteket virker stadig.

9. Pulse Phone

Intet at sætte op. Når Pulse Phone kører på serveren (ressourcenavn phone, begge udgaver):

  • Hver telefon får en Sound-app på sin hjemmeskærm. Det er den samme fjernbetjening som /sound: forbind til en højttaler eller bilen, vælg musik, styr hele gruppen. Spillerne kan fjerne den og få den tilbage fra App Hub.
  • Det, der spiller på den forbundne højttaler eller bil, med resterende tid, vises på Island og låseskærmen. Et tryk åbner Sound-appen.
  • Pulse Drive (Pulses bilskærm, F10 som standard) viser stereoen i den bil, du sidder i: sang, kunstner og cover, med afspil, pause, forrige, næste og lydstyrke og en Open-knap til Sound-appen. Det kræver Pulse Phone 1.2.9 eller nyere; ældre versioner viser det bare ikke.

Spillere uden telefonen bruger /sound og K, som gør alt det, appen gør.

Hvis du har omdøbt telefonens mappe, så tilføj denne linje til config/config.lua med dens navn:

Lua
Config.PulseResource = 'phone'

10. Politi, naboer og admins

Hvad Hvordan Indstilling
Anmeld høj musik /noise sender den nærmeste højttaler, der spiller (inden for 60 m), til politiet på tjeneste som et blinkende blip i 3 minutter. Én anmeldelse pr. spiller hvert 2. minut. Config.Police.complaints, complaintRange
Sluk for en højttaler Politi på tjeneste: target højttaleren > Turn off (police) eller fjernbetjeningens Tune-fane > Police. Inden for 12 m. Config.Police.canSilence, silenceMinutes (15)
Beslaglæg en højttaler Politi på tjeneste, inden for 4 m: target > Seize (police) eller Tune > Police > Seize. Højttaleren går til betjenten. Config.Police.canSeize
Politijobs Spillere med disse jobs, på tjeneste Config.Police.jobs
Ødelagte højttalere Skyder man på en placeret højttaler, går den i stykker: den knitrer og stopper. Et Speaker Repair Kit (sælges i butikken under Accessories) reparerer den: brug kittet ved siden af den. Config.Damage
Admin-liste /soundadmin: alle højttalere på serveren, hvad de spiller, og hvem der ejer dem, med knapper til at sætte et waypoint, stoppe musikken eller fjerne højttaleren. Config.AdminAce (zerodev.sound.admin)
Giv et item Serverkonsol: givespeaker <player id> <item name>

11. Sprog

Scriptet leveres på de samme 25 sprog som Pulse Phone. Vælg et i config/config.lua:

Kode Sprog Kode Sprog Kode Sprog
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. Standarden, 'auto', følger Pulse Phone: serveren bruger Pulses Config.Locale, og hver spiller får Sound på det sprog, de har valgt på deres telefon. Uden Pulse er det engelsk. Beskeder i spillet, tast-prompts, item-navne og navnet på stereotasten ligger i locales/<code>.lua; interfacet (fjernbetjening, bilstereo, butik, installationsværktøj, Pulse-app) ligger i locales/<code>_ui.lua. Alt, der mangler, falder tilbage til engelsk.

For at ændre en linje skal du redigere den i det sprogs fil. Behold hver %s, %d, %.1f, %% og ~a~, som de er. For at tilføje dit eget sprog skal du kopiere locales/en.lua til locales/xx.lua, ændre Locales['en'] til Locales['xx'] (begge steder), oversætte teksten mellem anførselstegnene og sætte Config.Locale = 'xx'. locales/ui_strings.txt viser alle interface-nøgler til en xx_ui.lua.

12. Fejlfinding

Spillerne kan ikke bruge højttaler-items

  • ox_inventory: indgangene skal være inde i ox_inventory/data/items.lua med deres client-linje, og ox_inventory skal genstartes efter indsættelsen. Mappen skal stadig hedde zerodev-sound (indgangene kalder zerodev-sound.useItem).
  • QBCore / ESX: zerodev-sound skal starte efter dit framework i server.cfg.
  • codem-inventory på QBCore: gennemfør codem-inventory's eget trin, der peger QBCore.Functions.UseItem på det.
  • Intet inventory: højttalere er ikke items. Spillerne åbner /sound og trykker Set up under Your speakers.

Item-billeder mangler

  • ox_inventory: intet at kopiere; billedstien peger på zerodev-sound. Hvis de er tomme, så tjek indgangens linje image = 'nui://zerodev-sound/...' og mappenavnet.
  • Andre inventories: læs konsollinjen Copy ... into ...: den viser de manglende billeder og den mappe, de skal i. Kopiér dem fra zerodev-sound/web/img/items/, og genstart inventory.

Det er med vilje: spillerne vælger kun fra dit bibliotek. Tilføj sangen til Config.Library (afsnit 8).

Ingen lyd overhovedet

  • FiveM's indbyggede browser starter lyd uden et klik, så spillerne behøver aldrig at trykke på noget for at "tillade" lyd. Hvis én spiller ikke hører noget, mens andre gør, så tjek FiveM i deres Windows-lydstyrkemixer.
  • Tjek højttaleren i fjernbetjeningens Speakers-fane: den er måske slukket eller Broken.
  • Politiet har måske slukket den (i Config.Police.silenceMinutes), eller stilletimer begrænser måske lydstyrken (Config.QuietHours).
  • En spiller hører højst Config.Streaming.maxAudibleSessions forskellige sange på én gang (6), de nærmeste først.
  • Test system i installationsværktøjet er stille, når Config.Library er tom eller Config.Sources.library = false: det afspiller den første sang i biblioteket.

Butikken er der ikke

  • Config.Shop.enabled skal være true.
  • Ekspedienten og standen vises kun, når en spiller er inden for cirka 70 m af Config.Shop.locations, og kun på den spillers skærm. Tjek de koordinater, du har sat.
  • Med ox_target eller qb-target skal du target ekspedienten. Uden et af dem skal du stille dig ved ekspedienten: E Browse speakers.

En højttaler vises som en almindelig GTA-højttaler eller slet ikke

Mappen stream/ mangler eller er blevet omdøbt, eller spilleren joinede, før ressourcen startede. Genstart serveren, og forbind igen.

Beskeder om bilanlæg, og hvad de betyder

Besked Hvorfor Løsning
Drive into a car audio bay to build. Byg-hvor-som-helst er slået fra, og bilen er ikke i et værksted. Kør ind i værkstedet (Config.Install.bays), eller sæt Config.Install.anywhere = true.
Stand next to your car to build its sound system. Byg-hvor-som-helst er slået til, og du er mere end 8 m fra bilen, eller /caraudio fandt ingen bil inden for 4 m. Stil dig ved bilen, eller sæt dig ind i den.
Stop the car first. Bilen er i bevægelse. Stop.
Car audio can only be fitted to a car you own. Config.Install.vehicles = 'owned', og denne nummerplade er ikke i din tabel over ejede køretøjer. Vises også for alle undtagen admins, når den tabel ikke kan læses: konsollen viser så en rød linje could not read the owned-vehicles table. Brug en ejet bil, sæt 'any', eller ret den databasefejl, konsollen nævner.
Only the owner can change this car's audio. Bilen tilhører en anden spiller. Vises også, når Config.Install.anyone = false, og spilleren ikke har et job på tjeneste fra Config.Install.jobs. Ejeren bygger det, eller en mekaniker på tjeneste, eller en admin.
Not enough money. De nye dele koster mere, end spilleren har på Config.Install.account. Fjern dele, eller sæt Config.Install.chargeParts = false.
A subwoofer blew. It needs replacing. Subs blev presset for hårdt for længe ved næsten fuld lydstyrke. Udskift sub'en i værkstedet; en større forstærker hjælper.

Politiet kan ikke se deres muligheder

Tilføj dine politijobnavne til Config.Police.jobs. Spillerne skal være på tjeneste.

13. Opdatering

Fra 1.x til 2.0: læs UPGRADING.md. Mellem 2.x-versioner:

  1. Tag backup af din config/-mappe, locales/, hvis du har oversat den, og eventuelle sange, du har tilføjet til web/library/.
  2. Stop serveren. Erstat mappen zerodev-sound med den nye (behold navnet).
  3. Læg dine config/-filer tilbage. Hvis opdateringsnoterne nævner nye indstillinger, så kopiér de linjer fra de nye filer over i dine.
  4. Start serveren, og læs konsollen. Eventuelle nye items udskrives til dit inventory.

Placerede højttalere, bilinstallationer og playlister gemmes i databasen (zds_speakers, zds_car_builds, zds_playlists, zds_stash) og røres ikke af en opdatering.

Tilbage til den gamle version: behold den forrige zerodev-sound-mappe uden for resources, indtil den nye version kører godt, og tag en backup af databasen, før du opdaterer. For at gå tilbage skal du stoppe serveren, lægge den forrige mappe og din config/ tilbage og starte den. At gå tilbage fra 3.0 til 2.x på den samme database er ikke testet, så gendan database-backuppen, hvis noget ser forkert ud.

Oversat fra engelsk. Hvis noget her ikke stemmer overens med den engelske side, er det den engelske side, der gælder. English