Pulse Phone-dokumentation

Installationsdetaljer

Til Pulse Phone 1.4.26 min. læsningOpdateret

1. Hurtig installation

Før du kopierer noget

Brug et server-artifact, der opfylder kravene nedenfor, med OneSync slået til og game build 2699 eller nyere. På en normal roleplay-server skal dit framework, dit inventory, oxmysql, din voice-ressource og screenshot-basic virke først. Standalone virker også uden et framework; inventory-items er valgfrie der.

Download ressourcen fra din Cfx.re-konto, efter du har indløst købet. Brug den servernøgle, der hører til den konto, som ejer asset'et. Hvis Cfx.re melder en entitlement-fejl, så ret koblingen mellem konto og nøgle; at ændre telefonens indstillinger kan ikke give entitlement.

Trin 1 — Læg ressourcen på din server

Pak pakken ud, og kopiér ressourcemappen phone, der indeholder fxmanifest.lua, ind i din servers resources-mappe. Omdøb den ikke, og læg ikke den ydre ZIP-/pakkemappe i stedet.

På en hostet server skal du uploade i Binary-tilstand eller uploade zip-filen og pakke den ud der (hvorfor). Kvikstarten (trin 2) viser antal filer og størrelse på hver mappe for denne build, og opstartstjekket nævner enhver fil, der mangler eller har den forkerte størrelse.

Stop din tidligere telefonressource, før du tester Pulse, så to telefoner ikke kæmper om den samme tast og det samme item. Tag backup af dens data, hvis du vil importere dem senere.

Trin 2 — Tilføj dine inventory-items

Vælg dit eksisterende inventory; du behøver ikke at erstatte det.

Dit inventory Påkrævet handling
ox_inventory Åbn den medfølgende config/items/ox_inventory.lua. Flet dens indgange ind i ox_inventory/data/items.lua, inde i den eksisterende tabel. Erstat ikke hele inventoryets fil. Behold ox_inventory's egen phone-indgang: når den bruges, åbner den Pulse Phone, og opstartstjekkets Phone item-linje bekræfter det. Erstat den kun med den udskrevne indgang, når den linje siger, at den åbner et andet script. Kopiér billeder fra config/items/images/ til ox_inventory/web/images/. Genstart serveren efter redigeringen.
qb-inventory med QBCore Manglende item-definitioner registreres automatisk ved opstart. Kopiér config/items/images/ til qb-inventory/html/images/. Hvis dit inventory kræver permanente shared-indgange, er den medfølgende config/items/qb-core.lua klar til at blive flettet ind i qb-core/shared/items.lua.
ESX' standard-inventory Manglende items tilføjes automatisk. Hvis konsollen beder om en genstart, så genstart én gang, så ESX læser dem. Hvis din databasekonto ikke kan tilføje dem, så brug config/items/esx.sql.
qs-inventory eller et andet understøttet inventory Følg den korte række for dit inventory i Items og inventories. Brug dets egen item-liste og billedmappe.
Standalone uden et inventory Ingen inventory-indgange nødvendige. Lad krav om items være slået fra.

Opstartstjekket finder manglende indgange og udskriver kun de definitioner, du stadig mangler. Et inventory, der indlæser item-definitioner ved opstart, såsom ox_inventory, kræver indgangene ovenfor; Pulse overskriver ikke en anden ressources filer.

Trin 3 — Tjek hovedkonfigurationen

Åbn config/config.lua. Standardværdierne registrerer din eksisterende opsætning:

Lua
Config.Framework = 'auto'

Lad inventory = 'auto' stå i den eksisterende Config.Providers-tabel. Hvis du kører flere inventory-ressourcer, så sæt værdien til det inventory, du vil bruge, såsom 'ox_inventory'. Tilføj ikke en ekstra Config.Providers- eller Config.Item-tabel nederst i filen.

Vælg i den eksisterende Config.Item-tabel, hvordan telefoner fungerer:

Indstilling Hvad den gør
required = false, unique = false Hver karakter har en telefon uden at have et item på sig. Nyttigt til din første test.
required = true, unique = false Karakteren skal have et phone-item for at åbne sin egen telefon. At give det item væk overfører ikke deres data.
unique = true Hvert telefon-item har sit eget nummer og sine egne data. At give item'et videre overfører den telefon. Kræver ox_inventory, qb-inventory, qs-inventory, core_inventory eller codem-inventory.
name = 'phone' Inventory-itemets navn. Behold det, medmindre du også ændrer den medfølgende item-definition.

Unikke telefoner følger den valgte inventory-bridge. Lad Config.Item.inventory = 'auto' stå; denne ældre tilsidesættelse er kun til eksisterende avancerede installationer. Config.Providers.inventory har forrang, når den er sat eksplicit.

Ændr ikke Config.IdentityScope på en eksisterende server. Standardværdien, 'character', holder forskellige karakterers telefoner adskilt.

Valgfrit: telefoner i inventory og betalt abonnement

For at kræve et separat telefon-item for hver telefon skal du sætte required = true og unique = true inde i den eksisterende Config.Item-tabel i config/config.lua, efter du har tilføjet inventory-indgangene. Brug et af de inventories til unikke telefoner, der er nævnt ovenfor.

For at sælge telefonabonnementer skal du sætte Config.Carrier.enabled = true i den samme fil. Det slår Carrier-appen til, hvor spillerne køber deres abonnement. Nye telefoner skal have et abonnement, før normale opkald, beskeder og apps med mobildata er tilgængelige. App Hub er der, hvor spillerne installerer apps, ikke abonnementsbutikken. Sæt Config.Coverage.enabled = true, hvis du også vil have dækningszoner. Dækning og betalte abonnementer er separate muligheder; lad den ene eller anden være slået fra, hvis du ikke vil have den funktion.

Redigér de eksisterende indstillinger i stedet for at tilføje dublerede tabeller. Genstart serveren, når du har gemt. Hvis en indstilling i spillet tidligere er blevet gemt, så nulstil den indstilling i Settings → Server, så værdien fra din fil gælder.

Trin 4 — Start afhængigheder før Pulse

Behold din eksisterende databaseforbindelse og dine framework-indstillinger. Tilføj kun manglende linjer; start ikke en ekstra kopi af nogen afhængighed.

Brug denne rækkefølge med de ressourcer, der allerede er installeret på din server:

  1. Databaseressourcen og dens eksisterende forbindelsesindstillinger.
  2. Frameworket og dets påkrævede biblioteker, identitets- og karakterressourcer.
  3. Inventory, med det inventorys konfiguration til dit framework.
  4. Én understøttet voice-ressource og screenshot-basic.
  5. ensure phone.

Installer ikke ESX, QBCore eller et andet inventory kun for Pulses skyld. Vælg din eksisterende opsætning i Dit framework for et eksempel på dens startrækkefølge. Qbox registreres som Qbox, selv når en anden ressource bruger dens QBCore-kompatible exports.

For administratoradgang til Pulse skal du tilføje add_ace group.admin phone.admin allow. Din administratorkonto skal allerede høre til group.admin, for at den tilladelse gælder.

Trin 5 — Læs tjekket ved første opstart

Genstart serveren. Pulse udskriver en opstartsrapport og opretter automatisk sine databasetabeller, når SQL-forbindelsen er tilgængelig.

  • FIX / FAIL: en påkrævet del kan ikke virke. Følg linjen med rettelsen, før du lader spillerne bruge den.
  • NOTE / WARN: læs, hvilken funktion der er berørt; nogle advarsler beskriver valgfrie funktioner, du ikke har konfigureret.
  • Kør phone:health i serverkonsollen for at gentage tjekket.
  • Kør phone:diag for at se det valgte framework/inventory/providers.
  • Som admin skal du joine, åbne F8 og køre phone:setup for den eksisterende guidede opsætning.

Indstillinger gemt i admin-opsætningen i spillet tilsidesætter de tilsvarende filindstillinger. Hvis en filændring ser ud til at blive ignoreret, så tjek Settings → Server, og nulstil den gemte tilsidesættelse, før du ændrer flere filer.

Trin 6 — Test som spiller

  1. Indlæs en karakter, tryk F1, og gennemfør telefonopsætningen. Hvis krav om items er slået til, så køb først en telefon i butikken eller giv karakteren det konfigurerede telefon-item.
  2. Hvis du har købt en forseglet æske, så brug æsken fra inventory til at pakke den ud, og gør derefter opsætningen færdig. Telefonen ankommer tændt; med Config.Device.arrivesOn = false skal du først holde End eller O nede.
  3. Åbn Messages, Contacts og Phone. Gå tilbage til hjemmeskærmen, åbn app-skifteren, og luk hver app en efter en.
  4. Tag et billede og en kort video. Åbn begge i Photos, luk og genåbn telefonen, og bekræft, at de stadig er der.
  5. Forbind igen, og tjek, at den samme karakter stadig har den samme telefon. Test opkald med en anden spiller via din installerede voice-ressource.

Hvor du ændrer ting

Hvad du vil ændre Fil eller sted
Framework, inventory-provider, telefon-item, butik, modeller, tastbinding config/config.lua
Voice-provider config/config.lua
Indstillinger for apps og service/jobs config/apps.lua
Inventory-indgange og billeder config/items/
Databaseforbindelse, startrækkefølge for ressourcer, loginoplysninger til mediehost server.cfg (hold private loginoplysninger på serversiden)
Udviklerintegrationer Avancerede integrationer, det valgfrie Developer Kit (zerodevscripts.com/downloads/PulsePhone-developer-kit.zip) og de eksisterende bridge/-filer; en normal installation kræver ikke, at du redigerer dem
Spillernes billeder/videoer med indbygget lager media/; bevar denne mappe ved opdatering

Afsnittene nedenfor indeholder den detaljerede reference. Du behøver ikke læse alle funktionsindstillinger for at gøre den første installation færdig.

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