Pulse Phone-dokumentasjon
Installasjonsdetaljer
1. Rask installasjon
Før du kopierer noe
Bruk en server-artifact som oppfyller kravene nedenfor, med OneSync aktivert og game build 2699 eller nyere. For en vanlig roleplay-server bør frameworket, inventoryet, oxmysql, voice-ressursen og screenshot-basic fungere først. Standalone fungerer også uten framework; inventory-items er valgfrie der.
Last ned ressursen fra Cfx.re-kontoen din etter at du har hentet kjøpet. Bruk servernøkkelen som tilhører kontoen som eier asseten. Hvis Cfx.re melder en entitlement-feil, rett koblingen mellom konto og nøkkel; å endre telefoninnstillinger kan ikke gi deg tilgangen.
Steg 1 — Legg ressursen på serveren din
Pakk ut pakken og kopier phone-ressursmappen, som inneholder fxmanifest.lua, til serverens resources-mappe. Ikke gi den nytt navn, og ikke legg den ytre ZIP-/pakkemappen i stedet.
På en hostet server, last opp i Binary-modus eller last opp zip-filen og pakk den ut der (hvorfor). Hurtigstarten (steg 2) viser antall filer og størrelse for hver mappe i denne builden, og oppstartssjekken navngir alle filer som mangler eller har feil størrelse.
Stopp den forrige telefonressursen din før du tester Pulse, så to telefoner ikke konkurrerer om samme tast og item. Ta backup av dataene hvis du planlegger å importere dem senere.
Steg 2 — Legg til inventory-itemene dine
Velg ditt eksisterende inventory; du trenger ikke erstatte det.
| Ditt inventory | Nødvendig handling |
|---|---|
| ox_inventory | Åpne den medfølgende config/items/ox_inventory.lua. Slå oppføringene sammen inn i ox_inventory/data/items.lua, inne i den eksisterende tabellen. Ikke erstatt hele filen til inventoryet. Behold ox_inventory sin egen phone-oppføring: bruker du den, åpnes Pulse Phone, og Phone item-linjen i oppstartssjekken bekrefter det. Erstatt den med den utskrevne oppføringen bare når den linjen sier at den åpner et annet script. Kopier bildene fra config/items/images/ til ox_inventory/web/images/. Start serveren på nytt etter redigeringen. |
| qb-inventory med QBCore | Manglende item-definisjoner registreres automatisk ved oppstart. Kopier config/items/images/ til qb-inventory/html/images/. Hvis inventoryet ditt krever permanente shared-oppføringer, er den medfølgende config/items/qb-core.lua klar til å slås sammen inn i qb-core/shared/items.lua. |
| Standard ESX-inventory | Manglende items legges til automatisk. Hvis konsollen ber om omstart, start på nytt én gang så ESX leser dem. Hvis databasekontoen din ikke kan legge dem til, bruk config/items/esx.sql. |
| qs-inventory eller et annet støttet inventory | Følg den korte raden for inventoryet ditt i Items og inventories. Bruk dets egen item-liste og bildemappe. |
| Standalone uten inventory | Ingen inventory-oppføringer trengs. La item-kravene være av. |
Oppstartssjekken finner manglende oppføringer og skriver bare ut definisjonene du fortsatt trenger. Et inventory som laster item-definisjoner ved oppstart, som ox_inventory, trenger oppføringene over; Pulse overskriver ikke filene til en annen ressurs.
Steg 3 — Sjekk hovedkonfigurasjonen
Åpne config/config.lua. Standardverdiene oppdager ditt eksisterende oppsett:
Config.Framework = 'auto'La inventory = 'auto' stå i den eksisterende Config.Providers-tabellen. Kjører du flere inventory-ressurser, sett den verdien til inventoryet du vil bruke, for eksempel 'ox_inventory'. Ikke legg til en ekstra Config.Providers- eller Config.Item-tabell nederst i filen.
I den eksisterende Config.Item-tabellen velger du hvordan telefoner fungerer:
| Innstilling | Hva den gjør |
|---|---|
required = false, unique = false |
Hver karakter har en telefon uten å bære et item. Nyttig for den første testen. |
required = true, unique = false |
Karakteren trenger et phone-item for å åpne sin egen telefon. Å gi bort det itemet overfører ikke dataene. |
unique = true |
Hvert telefon-item har sitt eget nummer og sine egne data. Å gi videre itemet overfører den telefonen. Krever ox_inventory, qb-inventory, qs-inventory, core_inventory eller codem-inventory. |
name = 'phone' |
Navnet på inventory-itemet. Behold dette med mindre du også endrer den medfølgende item-definisjonen. |
Unike telefoner følger den valgte inventory-bridgen. La Config.Item.inventory = 'auto' stå; denne eldre overstyringen er bare for eksisterende avanserte installasjoner. Config.Providers.inventory har forrang når den er satt eksplisitt.
Ikke endre Config.IdentityScope på en eksisterende server. Standardverdien, 'character', holder forskjellige karakterers telefoner adskilt.
Valgfritt: telefoner i inventory og betalt abonnement
For å kreve et eget telefon-item for hver telefon, sett required = true og unique = true inne i den eksisterende Config.Item-tabellen i config/config.lua, etter at du har lagt til inventory-oppføringene. Bruk et av inventoryene for unike telefoner som er listet over.
For å selge mobilabonnement, sett Config.Carrier.enabled = true i den samme filen. Dette aktiverer Carrier-appen, der spillerne kjøper abonnementet sitt. Nye telefoner trenger et abonnement før vanlige samtaler, meldinger og apper med mobildata er tilgjengelige. App Hub er der spillerne installerer apper, ikke abonnementsbutikken. Sett Config.Coverage.enabled = true hvis du også vil ha dekningssoner. Dekning og betalte abonnementer er separate valg; la hvilket som helst av dem være av hvis du ikke vil ha den funksjonen.
Rediger de eksisterende innstillingene i stedet for å legge til dupliserte tabeller. Start serveren på nytt etter at du har lagret. Hvis en innstilling i spillet tidligere er lagret, tilbakestill den i Settings → Server så verdien i filen gjelder.
Steg 4 — Start avhengighetene før Pulse
Behold den eksisterende databasetilkoblingen og framework-innstillingene. Legg bare til linjer som mangler; ikke start en ekstra kopi av noen avhengighet.
Bruk denne rekkefølgen med ressursene som allerede er installert på serveren din:
- Databaseressursen og dens eksisterende tilkoblingsinnstillinger.
- Frameworket og dets påkrevde biblioteker, identitets- og karakterressurser.
- Inventory, med inventoryets konfigurasjon for frameworket ditt.
- Én støttet voice-ressurs og
screenshot-basic. ensure phone.
Ikke installer ESX, QBCore eller et annet inventory bare for Pulse. Velg ditt eksisterende oppsett i Ditt framework for et eksempel på startrekkefølge for akkurat det. Qbox oppdages som Qbox selv når en annen ressurs bruker de QBCore-kompatible exportene.
For administratortilgang i Pulse, legg til add_ace group.admin phone.admin allow. Administratorkontoen din må allerede tilhøre group.admin for at den tillatelsen skal gjelde.
Steg 5 — Les sjekken ved første oppstart
Start serveren på nytt. Pulse skriver ut en oppstartsrapport og oppretter databasetabellene sine automatisk når SQL-tilkoblingen er tilgjengelig.
- FIX / FAIL: en påkrevd del kan ikke fungere. Følg rettelseslinjen før du lar spillerne bruke den.
- NOTE / WARN: les hvilken funksjon som er berørt; noen advarsler beskriver valgfrie funksjoner du ikke har konfigurert.
- Kjør
phone:healthi serverkonsollen for å gjenta sjekken. - Kjør
phone:diagfor å se valgt framework/inventory/leverandører. - Som admin, koble til, åpne F8 og kjør
phone:setupfor det eksisterende guidede oppsettet.
Innstillinger lagret i admin-oppsettet i spillet overstyrer tilsvarende innstillinger i filene. Virker det som en filendring ignoreres, sjekk Settings → Server og tilbakestill den lagrede overstyringen før du endrer flere filer.
Steg 6 — Test som spiller
- Last inn en karakter, trykk F1 og fullfør telefonoppsettet. Hvis item-krav er aktivert, kjøp en telefon i butikken eller gi karakteren det konfigurerte telefon-itemet først.
- Hvis du kjøpte en forseglet eske, bruk esken fra inventoryet for å pakke den ut, og fullfør så oppsettet. Telefonen kommer påslått; med
Config.Device.arrivesOn = falseholder du inne End eller O først. - Åpne Messages, Contacts og Phone. Gå tilbake til hjemskjermen, åpne app-switcheren og lukk hver app etter tur.
- Ta et bilde og en kort video. Åpne begge i Photos, lukk og åpne telefonen igjen, og bekreft at de fortsatt er der.
- Koble til på nytt og sjekk at den samme karakteren fortsatt har den samme telefonen. Test samtaler med en annen spiller med voice-ressursen du har installert.
Hvor du endrer ting
| Hva du vil endre | Fil eller sted |
|---|---|
| Framework, inventory-leverandør, telefon-item, butikk, modeller, tastebinding | config/config.lua |
| Voice-leverandør | config/config.lua |
| App- og tjeneste-/jobbinnstillinger | config/apps.lua |
| Inventory-oppføringer og bilder | config/items/ |
| Databasetilkobling, startrekkefølge for ressurser, påloggingsdata for mediehost | server.cfg (hold private påloggingsdata på serversiden) |
| Utviklerintegrasjoner | Avanserte integrasjoner, den valgfrie utviklerpakken (zerodevscripts.com/downloads/PulsePhone-developer-kit.zip) og de eksisterende bridge/-filene; en vanlig installasjon krever ikke at du redigerer disse |
| Spillerbilder/-videoer med innebygd lagring | media/; behold denne mappen ved oppdatering |
Delene nedenfor inneholder den detaljerte referansen. Du trenger ikke lese alle funksjonsinnstillinger for å fullføre den første installasjonen.