Dokumentation för Pulse Phone
Installationsdetaljer
1. Snabbinstallation
Innan du kopierar något
Använd en server-artifact som uppfyller kraven nedan, med OneSync aktiverat och game build 2699 eller nyare. För en vanlig roleplay-server, se till att ditt framework, inventory, oxmysql, röstresurs och screenshot-basic fungerar först. Standalone fungerar också utan framework; inventory-items är valfria där.
Ladda ner resursen från ditt Cfx.re-konto efter att du har tagit emot köpet. Använd servernyckeln som tillhör kontot som äger asseten. Om Cfx.re rapporterar ett behörighetsfel (entitlement), rätta kopplingen mellan konto och nyckel; att ändra telefonens inställningar kan inte ge behörigheten.
Steg 1 — Lägg resursen på din server
Packa upp paketet och kopiera resursmappen phone, som innehåller fxmanifest.lua, till din servers katalog resources. Döp inte om den och lägg inte den yttre ZIP-/paketmappen på dess plats.
På en hostad server, ladda upp i binärläge eller ladda upp zip-filen och packa upp den där (varför). Snabbstarten (steg 2) listar antal filer och storlek för varje mapp i den här builden, och startkontrollen pekar ut varje fil som saknas eller har fel storlek.
Stoppa din tidigare telefonresurs innan du testar Pulse så att två telefoner inte tävlar om samma tangent och item. Säkerhetskopiera dess data om du planerar att importera den senare.
Steg 2 — Lägg till dina inventory-items
Välj ditt befintliga inventory; du behöver inte byta ut det.
| Ditt inventory | Åtgärd som krävs |
|---|---|
| ox_inventory | Öppna den medföljande config/items/ox_inventory.lua. Slå ihop dess poster med ox_inventory/data/items.lua, inuti den befintliga tabellen. Ersätt inte inventoryts hela fil. Behåll ox_inventorys egen post phone: att använda den öppnar Pulse Phone, och startkontrollens rad Phone item bekräftar det. Ersätt den med den utskrivna posten bara när den raden säger att den öppnar ett annat script. Kopiera bilderna från config/items/images/ till ox_inventory/web/images/. Starta om servern efter ändringen. |
| qb-inventory med QBCore | Saknade item-definitioner registreras automatiskt vid start. Kopiera config/items/images/ till qb-inventory/html/images/. Om ditt inventory kräver permanenta shared-poster är den medföljande config/items/qb-core.lua redo att slås ihop med qb-core/shared/items.lua. |
| ESX standard-inventory | Saknade items läggs till automatiskt. Om konsolen ber om en omstart, starta om en gång så att ESX läser in dem. Om ditt databaskonto inte kan lägga till dem, använd config/items/esx.sql. |
| qs-inventory eller ett annat inventory som stöds | Följ den korta raden för ditt inventory i Items och inventories. Använd dess egen item-lista och bildmapp. |
| Standalone utan inventory | Inga inventory-poster behövs. Låt item-kraven vara avstängda. |
Startkontrollen identifierar saknade poster och skriver bara ut de definitioner du fortfarande behöver. Ett inventory som laddar item-definitioner vid start, som ox_inventory, behöver posterna ovan; Pulse skriver inte över en annan resurs filer.
Steg 3 — Kontrollera huvudkonfigurationen
Öppna config/config.lua. Standardvärdena identifierar din befintliga uppsättning:
Config.Framework = 'auto'Låt inventory = 'auto' stå kvar i den befintliga tabellen Config.Providers. Om du kör flera inventory-resurser, sätt värdet till det inventory du tänker använda, till exempel 'ox_inventory'. Lägg inte till en andra tabell Config.Providers eller Config.Item längst ner i filen.
I den befintliga tabellen Config.Item väljer du hur telefoner fungerar:
| Inställning | Vad den gör |
|---|---|
required = false, unique = false |
Varje karaktär har en telefon utan att bära ett item. Bra för ditt första test. |
required = true, unique = false |
Karaktären behöver ett item phone för att öppna sin egen telefon. Att ge bort det itemet för inte över deras data. |
unique = true |
Varje telefon-item har sitt eget nummer och sin egen data. Att lämna över itemet för över den telefonen. Kräver ox_inventory, qb-inventory, qs-inventory, core_inventory eller codem-inventory. |
name = 'phone' |
Itemets namn i inventoryt. Behåll det om du inte också ändrar den medföljande item-definitionen. |
Unika telefoner följer den valda inventory-bryggan. Låt Config.Item.inventory = 'auto' stå; den här äldre inställningen är bara för befintliga avancerade installationer. Config.Providers.inventory går före när den är uttryckligen satt.
Ändra inte Config.IdentityScope på en befintlig server. Standardvärdet, 'character', håller olika karaktärers telefoner åtskilda.
Valfritt: telefoner i inventoryt och betald tjänst
För att kräva ett separat telefon-item för varje telefon, sätt required = true och unique = true inuti den befintliga tabellen Config.Item i config/config.lua, efter att du lagt till inventory-posterna. Använd ett av inventories för unika telefoner som listas ovan.
För att sälja telefontjänst, sätt Config.Carrier.enabled = true i samma fil. Det aktiverar appen Carrier, där spelarna köper sitt abonnemang. Nya telefoner behöver ett abonnemang innan vanliga samtal, meddelanden och appar med mobildata blir tillgängliga. App Hub är där spelarna installerar appar, inte tjänstebutiken. Sätt Config.Coverage.enabled = true om du också vill ha täckningszoner. Täckning och betalda abonnemang är separata alternativ; låt någon av dem vara avstängd om du inte vill ha den funktionen.
Ändra de befintliga inställningarna i stället för att lägga till dubbla tabeller. Starta om servern efter att du sparat. Om en inställning i spelet har sparats tidigare, återställ den i Settings → Server så att värdet i din fil gäller.
Steg 4 — Starta beroenden före Pulse
Behåll din befintliga databasanslutning och dina framework-inställningar. Lägg bara till rader som saknas; starta inte en andra kopia av något beroende.
Använd den här ordningen med de resurser som redan är installerade på din server:
- Databasresursen och dess befintliga anslutningsinställningar.
- Frameworket och dess nödvändiga bibliotek, identitets- och karaktärsresurser.
- Inventory, med det inventoryts konfiguration för ditt framework.
- En röstresurs som stöds och
screenshot-basic. ensure phone.
Installera inte ESX, QBCore eller ett annat inventory bara för Pulse. Välj din befintliga uppsättning i Ditt framework för dess specifika exempel på startordning. Qbox identifieras som Qbox även när en annan resurs använder dess QBCore-kompatibla exports.
För administratörsåtkomst i Pulse, lägg till add_ace group.admin phone.admin allow. Ditt administratörskonto måste redan tillhöra group.admin för att behörigheten ska gälla.
Steg 5 — Läs kontrollen vid första starten
Starta om servern. Pulse skriver ut en startrapport och skapar sina databastabeller automatiskt när SQL-anslutningen är tillgänglig.
- FIX / FAIL: en nödvändig del kan inte fungera. Följ åtgärdsraden innan du låter spelare använda den.
- NOTE / WARN: läs vilken funktion som påverkas; vissa varningar gäller valfria funktioner som du inte har konfigurerat.
- Kör
phone:healthi serverkonsolen för att upprepa kontrollen. - Kör
phone:diagför att se valt framework/inventory/providers. - Som admin, gå in, öppna F8 och kör
phone:setupför den befintliga guidade installationen.
Inställningar som sparas i adminuppsättningen i spelet går före motsvarande inställningar i filerna. Om en ändring i en fil verkar ignoreras, kolla Settings → Server och återställ den sparade inställningen innan du ändrar fler filer.
Steg 6 — Testa som spelare
- Ladda en karaktär, tryck F1 och slutför telefonens installation. Om item-krav är aktiverade, köp en telefon i butiken eller ge karaktären det konfigurerade telefon-itemet först.
- Om du köpte en förseglad kartong, använd kartongen från inventoryt för att packa upp den, och slutför sedan installationen. Telefonen kommer påslagen; med
Config.Device.arrivesOn = false, håll in End eller O först. - Öppna Messages, Contacts och Phone. Gå tillbaka till hemskärmen, öppna appväxlaren och stäng varje app i tur och ordning.
- Ta ett foto och en kort video. Öppna båda i Photos, stäng och öppna telefonen igen, och bekräfta att de finns kvar.
- Anslut igen och kontrollera att samma karaktär fortfarande har samma telefon. Testa samtal med en andra spelare med din installerade röstresurs.
Var du ändrar saker
| Det du vill ändra | Fil eller plats |
|---|---|
| Framework, inventory-provider, telefon-item, butik, modeller, tangentbindning | config/config.lua |
| Röst-provider | config/config.lua |
| Inställningar för appar och tjänster/jobb | config/apps.lua |
| Inventory-poster och bilder | config/items/ |
| Databasanslutning, startordning för resurser, inloggningsuppgifter för mediehost | server.cfg (håll privata inloggningsuppgifter på serversidan) |
| Utvecklarintegrationer | Avancerade integrationer, det valfria Developer Kit (zerodevscripts.com/downloads/PulsePhone-developer-kit.zip) och de befintliga filerna i bridge/; en vanlig installation kräver inga ändringar i dessa |
| Spelarnas foton/videor med inbyggd lagring | media/; behåll den här mappen vid uppdatering |
Avsnitten nedan innehåller den detaljerade referensen. Du behöver inte läsa varje funktionsinställning för att slutföra den första installationen.