Docs van Pulse Phone
Installatiedetails
1. Snelle installatie
Voordat je iets kopieert
Gebruik een server-artifact dat aan de vereisten hieronder voldoet, met OneSync aan en game build 2699 of nieuwer. Zorg op een normale roleplayserver eerst dat je framework, inventory, oxmysql, voice-resource en screenshot-basic werken. Standalone werkt ook zonder framework; inventory-items zijn daar optioneel.
Download de resource via je Cfx.re-account nadat je de aankoop hebt geclaimd. Gebruik de serversleutel die hoort bij het account dat eigenaar is van de asset. Meldt Cfx.re een entitlement-fout, herstel dan de koppeling tussen account en sleutel; telefooninstellingen aanpassen kan het entitlement niet toekennen.
Stap 1 — Zet de resource op je server
Pak het pakket uit en kopieer de resourcemap phone, met daarin fxmanifest.lua, naar de map resources van je server. Hernoem hem niet en zet niet de buitenste ZIP-/pakketmap op die plek.
Upload op een gehoste server in Binary-modus of upload de zip en pak hem daar uit (waarom). De snelstart (stap 2) vermeldt het aantal bestanden en de grootte van elke map voor deze build, en de opstartcontrole noemt elk bestand dat ontbreekt of de verkeerde grootte heeft.
Stop je vorige telefoonresource voordat je Pulse test, zodat twee telefoons niet strijden om dezelfde toets en hetzelfde item. Maak een back-up van de data als je die later wilt importeren.
Stap 2 — Voeg je inventory-items toe
Kies je bestaande inventory; je hoeft hem niet te vervangen.
| Je inventory | Wat je moet doen |
|---|---|
| ox_inventory | Open de meegeleverde config/items/ox_inventory.lua. Voeg de entries samen in ox_inventory/data/items.lua, binnen de bestaande tabel. Vervang niet het hele bestand van de inventory. Houd de eigen phone-entry van ox_inventory: als je hem gebruikt, opent Pulse Phone, en de regel Phone item van de opstartcontrole bevestigt dat. Vervang hem alleen door de geprinte entry als die regel zegt dat hij een ander script opent. Kopieer de afbeeldingen van config/items/images/ naar ox_inventory/web/images/. Herstart de server na het aanpassen. |
| qb-inventory met QBCore | Ontbrekende itemdefinities worden bij het opstarten automatisch geregistreerd. Kopieer config/items/images/ naar qb-inventory/html/images/. Vereist je inventory permanente shared entries, dan is de meegeleverde config/items/qb-core.lua klaar om samen te voegen in qb-core/shared/items.lua. |
| Standaard ESX-inventory | Ontbrekende items worden automatisch toegevoegd. Vraagt de console om een herstart, herstart dan één keer zodat ESX ze inleest. Kan je databaseaccount ze niet toevoegen, gebruik dan config/items/esx.sql. |
| qs-inventory of een andere ondersteunde inventory | Volg de korte regel voor jouw inventory in Items en inventories. Gebruik de eigen itemlijst en afbeeldingenmap. |
| Standalone zonder inventory | Geen inventory-entries nodig. Laat de itemvereisten uit. |
De opstartcontrole spoort ontbrekende entries op en print alleen de definities die je nog nodig hebt. Een inventory die itemdefinities bij het opstarten laadt, zoals ox_inventory, heeft de entries hierboven nodig; Pulse overschrijft geen bestanden van een andere resource.
Stap 3 — Controleer de hoofdconfiguratie
Open config/config.lua. De standaardwaarden herkennen je bestaande setup:
Config.Framework = 'auto'Laat inventory = 'auto' staan in de bestaande Config.Providers-tabel. Draai je meerdere inventory-resources, zet die waarde dan op de inventory die je wilt gebruiken, zoals 'ox_inventory'. Voeg onderaan het bestand geen tweede Config.Providers- of Config.Item-tabel toe.
Kies in de bestaande Config.Item-tabel hoe telefoons werken:
| Instelling | Wat het doet |
|---|---|
required = false, unique = false |
Elk personage heeft een telefoon zonder een item bij zich te hebben. Handig voor je eerste test. |
required = true, unique = false |
Het personage heeft een phone-item nodig om zijn eigen telefoon te openen. Dat item weggeven draagt de data niet over. |
unique = true |
Elk telefoonitem heeft een eigen nummer en eigen data. Het item doorgeven draagt dat toestel over. Vereist ox_inventory, qb-inventory, qs-inventory, core_inventory of codem-inventory. |
name = 'phone' |
Naam van het inventory-item. Laat dit staan, tenzij je ook de meegeleverde itemdefinitie aanpast. |
Unieke telefoons volgen de gekozen inventory-bridge. Laat Config.Item.inventory = 'auto' staan; deze oudere override is alleen voor bestaande geavanceerde installaties. Config.Providers.inventory heeft voorrang als die expliciet is ingesteld.
Verander Config.IdentityScope niet op een bestaande server. De standaard, 'character', houdt de telefoons van verschillende personages gescheiden.
Optioneel: telefoons als inventory-item en betaalde service
Wil je voor elke telefoon een apart toestelitem verplicht maken, stel dan required = true en unique = true in binnen de bestaande Config.Item-tabel in config/config.lua, nadat je de inventory-entries hebt toegevoegd. Gebruik een van de inventories voor unieke telefoons die hierboven staan.
Wil je telefoonservice verkopen, stel dan Config.Carrier.enabled = true in in hetzelfde bestand. Dat zet de Carrier-app aan, waar spelers hun abonnement kopen. Nieuwe telefoons hebben een abonnement nodig voordat gewone gesprekken, berichten en apps met mobiele data beschikbaar zijn. App Hub is waar spelers apps installeren, niet de servicewinkel. Stel Config.Coverage.enabled = true in als je ook dekkingszones wilt. Dekking en betaalde abonnementen zijn aparte opties; laat er een uit als je die feature niet wilt.
Pas de bestaande instellingen aan in plaats van dubbele tabellen toe te voegen. Herstart de server na het opslaan. Is een instelling eerder in game opgeslagen, reset die instelling dan in Settings → Server zodat de waarde uit je bestand geldt.
Stap 4 — Start dependencies vóór Pulse
Houd je bestaande databaseverbinding en frameworkinstellingen. Voeg alleen ontbrekende regels toe; start geen tweede exemplaar van een dependency.
Gebruik deze volgorde met de resources die al op je server staan:
- De databaseresource en de bestaande verbindingsinstellingen.
- Het framework en de bijbehorende libraries, identity- en character-resources.
- De inventory, met de configuratie van die inventory voor jouw framework.
- Eén ondersteunde voice-resource en
screenshot-basic. ensure phone.
Installeer geen ESX, QBCore of andere inventory alleen voor Pulse. Kies je bestaande setup in Je framework voor een voorbeeld van de startvolgorde. Qbox wordt herkend als Qbox, ook als een andere resource de QBCore-compatibele exports ervan gebruikt.
Voor admintoegang tot Pulse voeg je add_ace group.admin phone.admin allow toe. Je adminaccount moet al in group.admin zitten om die permissie te laten gelden.
Stap 5 — Lees de controle bij de eerste start
Herstart de server. Pulse print een opstartrapport en maakt automatisch zijn databasetabellen aan zodra de SQL-verbinding beschikbaar is.
- FIX / FAIL: een vereist onderdeel kan niet werken. Volg de regel met de correctie voordat je spelers het laat gebruiken.
- NOTE / WARN: lees welke feature het betreft; sommige waarschuwingen gaan over optionele features die je niet hebt ingesteld.
- Draai
phone:healthin de serverconsole om de controle te herhalen. - Draai
phone:diagom het gekozen framework, de inventory en providers te zien. - Join als admin, open F8 en draai
phone:setupvoor de bestaande begeleide setup.
Instellingen die in de admin-setup in game zijn opgeslagen, overschrijven de bijbehorende instellingen in de bestanden. Lijkt een wijziging in een bestand genegeerd te worden, check dan Settings → Server en reset die opgeslagen overschrijving voordat je meer bestanden aanpast.
Stap 6 — Test als speler
- Laad een personage, druk op F1 en doorloop de telefoonsetup. Staan de itemvereisten aan, koop dan eerst een telefoon in de winkel of geef het personage het ingestelde telefoonitem.
- Heb je een verzegelde doos gekocht, gebruik dan de doos uit je inventory om hem uit te pakken en maak daarna de setup af. Het toestel komt aangezet binnen; met
Config.Device.arrivesOn = falsehoud je eerst End of O ingedrukt. - Open Messages, Contacts en Phone. Ga terug naar Home, open de app switcher en sluit elke app een voor een.
- Maak een foto en een korte video. Open ze allebei in Photos, sluit de telefoon en open hem opnieuw, en controleer of ze er nog zijn.
- Maak opnieuw verbinding en controleer of hetzelfde personage nog steeds dezelfde telefoon heeft. Test gesprekken met een tweede speler via je geïnstalleerde voice-resource.
Waar je dingen aanpast
| Wat je wilt aanpassen | Bestand of plek |
|---|---|
| Framework, inventory-provider, telefoonitem, winkel, modellen, toetsbinding | config/config.lua |
| Voice-provider | config/config.lua |
| Instellingen voor apps en services/jobs | config/apps.lua |
| Inventory-entries en afbeeldingen | config/items/ |
| Databaseverbinding, startvolgorde van resources, inloggegevens voor de mediahost | server.cfg (houd privé-inloggegevens server-side) |
| Developer-integraties | Geavanceerde integraties, de optionele Developer Kit (zerodevscripts.com/downloads/PulsePhone-developer-kit.zip) en de bestaande bridge/-bestanden; bij een normale installatie hoef je die niet aan te passen |
| Foto's/video's van spelers in de ingebouwde opslag | media/; bewaar deze map bij het updaten |
De secties hieronder bevatten de uitgebreide naslag. Je hoeft niet elke feature-instelling te lezen om de eerste installatie af te ronden.