Documentația Pulse Phone

Detalii de instalare

Pentru Pulse Phone 1.4.26 min de cititActualizat

1. Instalare rapidă

Înainte să copiezi ceva

Folosește un artifact de server care îndeplinește cerințele de mai jos, cu OneSync activat și game build 2699 sau mai nou. Pentru un server de roleplay obișnuit, asigură-te mai întâi că framework-ul, inventarul, oxmysql, resursa de voce și screenshot-basic funcționează. Standalone merge și fără framework; acolo itemele de inventar sunt opționale.

Descarcă resursa din contul tău Cfx.re după ce revendici achiziția. Folosește cheia de server care aparține contului ce deține asset-ul. Dacă Cfx.re raportează o eroare de entitlement, corectează asocierea cont/cheie; schimbarea setărilor telefonului nu poate acorda entitlement-ul.

Pasul 1 — Pune resursa pe server

Extrage pachetul și copiază folderul resursei phone, care conține fxmanifest.lua, în directorul resources al serverului. Nu-l redenumi și nu pune în locul lui folderul exterior al arhivei ZIP/pachetului.

Pe un server găzduit, urcă fișierele în modul Binary sau urcă arhiva zip și extrage-o acolo (de ce). Ghidul rapid (pasul 2) listează numărul de fișiere și dimensiunea fiecărui folder pentru acest build, iar verificarea de la pornire numește orice fișier lipsă sau cu dimensiunea greșită.

Oprește resursa de telefon anterioară înainte să testezi Pulse, ca două telefoane să nu-și dispute aceeași tastă și același item. Fă backup la datele ei dacă vrei să le imporți mai târziu.

Pasul 2 — Adaugă itemele în inventar

Alege inventarul existent; nu trebuie să-l înlocuiești.

Inventarul tău Acțiunea necesară
ox_inventory Deschide fișierul livrat config/items/ox_inventory.lua. Adaugă intrările lui în ox_inventory/data/items.lua, în interiorul tabelului existent. Nu înlocui tot fișierul inventarului. Păstrează intrarea phone proprie a ox_inventory: folosirea ei deschide Pulse Phone, iar linia Phone item din verificarea de la pornire confirmă asta. Înlocuiește-o cu intrarea afișată doar când acea linie spune că deschide alt script. Copiază imaginile din config/items/images/ în ox_inventory/web/images/. Repornește serverul după editare.
qb-inventory cu QBCore Definițiile de iteme lipsă sunt înregistrate automat la pornire. Copiază config/items/images/ în qb-inventory/html/images/. Dacă inventarul tău cere intrări shared permanente, fișierul livrat config/items/qb-core.lua este gata de adăugat în qb-core/shared/items.lua.
Inventarul implicit ESX Itemele lipsă sunt adăugate automat. Dacă consola cere un restart, repornește o dată ca ESX să le citească. Dacă contul bazei de date nu le poate adăuga, folosește config/items/esx.sql.
qs-inventory sau alt inventar suportat Urmează rândul scurt pentru inventarul tău din Iteme și inventare. Folosește lista de iteme și folderul de imagini ale lui.
Standalone fără inventar Nu e nevoie de intrări în inventar. Lasă cerințele de item dezactivate.

Verificarea de la pornire identifică intrările lipsă și afișează doar definițiile de care mai ai nevoie. Un inventar care încarcă definițiile de iteme la pornire, cum ar fi ox_inventory, are nevoie de intrările de mai sus; Pulse nu suprascrie fișierele altei resurse.

Pasul 3 — Verifică configurarea principală

Deschide config/config.lua. Valorile implicite detectează configurația pe care o ai deja:

Lua
Config.Framework = 'auto'

Lasă inventory = 'auto' în tabelul Config.Providers existent. Dacă rulezi mai multe resurse de inventar, setează valoarea la inventarul pe care vrei să-l folosești, de exemplu 'ox_inventory'. Nu adăuga un al doilea tabel Config.Providers sau Config.Item la finalul fișierului.

În tabelul Config.Item existent, alege cum funcționează telefoanele:

Setare Ce face
required = false, unique = false Fiecare personaj are un telefon fără să poarte un item. Util pentru primul test.
required = true, unique = false Personajul are nevoie de un item phone ca să-și deschidă propriul telefon. Dacă dă itemul altcuiva, datele lui nu se transferă.
unique = true Fiecare item de telefon are propriul număr și propriile date. Dacă dai itemul, transferi acel telefon. Necesită ox_inventory, qb-inventory, qs-inventory, core_inventory sau codem-inventory.
name = 'phone' Numele itemului din inventar. Păstrează-l, dacă nu schimbi și definiția livrată a itemului.

Telefoanele unice urmează bridge-ul de inventar selectat. Lasă Config.Item.inventory = 'auto'; această suprascriere mai veche este doar pentru instalările avansate existente. Config.Providers.inventory are prioritate când este setat explicit.

Nu schimba Config.IdentityScope pe un server existent. Valoarea implicită, 'character', păstrează separat telefoanele personajelor diferite.

Opțional: telefoane ca iteme în inventar și serviciu plătit

Ca să ceri un item de telefon separat pentru fiecare telefon, setează required = true și unique = true în tabelul Config.Item existent din config/config.lua, după ce adaugi intrările în inventar. Folosește unul dintre inventarele pentru telefoane unice listate mai sus.

Ca să vinzi serviciu de telefonie, setează Config.Carrier.enabled = true în același fișier. Asta activează aplicația Carrier, din care jucătorii își cumpără planul. Telefoanele noi au nevoie de un plan înainte ca apelurile normale, mesajele și aplicațiile cu date mobile să fie disponibile. App Hub este locul de unde jucătorii instalează aplicații, nu magazinul de servicii. Setează Config.Coverage.enabled = true dacă vrei și zone de acoperire. Acoperirea și planurile plătite sunt opțiuni separate; lasă oricare dintre ele dezactivată dacă nu vrei acea funcție.

Editează setările existente în loc să adaugi tabele duplicate. Repornește serverul după salvare. Dacă o setare din joc a fost salvată anterior, reseteaz-o în Settings → Server, ca să se aplice valoarea din fișier.

Pasul 4 — Pornește dependențele înainte de Pulse

Păstrează conexiunea existentă la baza de date și setările framework-ului. Adaugă doar liniile lipsă; nu porni o a doua copie a vreunei dependențe.

Folosește această ordine cu resursele deja instalate pe serverul tău:

  1. Resursa bazei de date și setările ei de conexiune existente.
  2. Framework-ul și bibliotecile lui necesare, resursele de identitate și de personaje.
  3. Inventarul, folosind configurația acelui inventar pentru framework-ul tău.
  4. O resursă de voce suportată și screenshot-basic.
  5. ensure phone.

Nu instala ESX, QBCore sau alt inventar doar pentru Pulse. Alege configurația ta existentă în Framework-ul tău pentru exemplul ei specific de ordine de pornire. Qbox este detectat ca Qbox chiar și când altă resursă folosește exporturile lui compatibile cu QBCore.

Pentru acces de administrator în Pulse, adaugă add_ace group.admin phone.admin allow. Contul tău de administrator trebuie să aparțină deja group.admin ca permisiunea să se aplice.

Pasul 5 — Citește verificarea de la prima pornire

Repornește serverul. Pulse afișează un raport de pornire și își creează automat tabelele în baza de date când conexiunea SQL este disponibilă.

  • FIX / FAIL: o parte obligatorie nu poate funcționa. Urmează linia de corectare înainte să-i lași pe jucători să-l folosească.
  • NOTE / WARN: citește ce funcție este afectată; unele avertismente descriu funcții opționale pe care nu le-ai configurat.
  • Rulează phone:health în consola serverului ca să repeți verificarea.
  • Rulează phone:diag ca să vezi framework-ul/inventarul/providerii aleși.
  • Ca admin, intră pe server, deschide F8 și rulează phone:setup pentru configurarea ghidată existentă.

Setările salvate în configurarea de admin din joc au prioritate față de setările corespunzătoare din fișiere. Dacă o modificare din fișier pare ignorată, verifică Settings → Server și resetează acea setare salvată înainte să mai schimbi alte fișiere.

Pasul 6 — Testează ca jucător

  1. Încarcă un personaj, apasă F1 și finalizează configurarea telefonului. Dacă cerințele de item sunt activate, cumpără mai întâi un telefon din magazin sau dă-i personajului itemul de telefon configurat.
  2. Dacă ai cumpărat o cutie sigilată, folosește cutia din inventar ca s-o despachetezi, apoi finalizează configurarea. Telefonul vine pornit; cu Config.Device.arrivesOn = false ține mai întâi apăsat End sau O.
  3. Deschide Messages, Contacts și Phone. Întoarce-te la Home, deschide app switcher-ul și închide aplicațiile pe rând.
  4. Fă o poză și un videoclip scurt. Deschide-le pe amândouă în Photos, închide și redeschide telefonul și confirmă că au rămas.
  5. Reconectează-te și verifică dacă același personaj are în continuare același telefon. Testează apelurile cu un al doilea jucător, folosind resursa de voce instalată.

Unde schimbi lucrurile

Ce vrei să schimbi Fișier sau loc
Framework, provider de inventar, item de telefon, magazin, modele, tastă config/config.lua
Provider de voce config/config.lua
Setări pentru aplicații și servicii/joburi config/apps.lua
Intrări de inventar și imagini config/items/
Conexiunea la baza de date, ordinea de pornire a resurselor, datele de acces pentru hostul media server.cfg (păstrează datele de acces private pe server)
Integrări pentru dezvoltatori Integrări avansate, Developer Kit-ul opțional (zerodevscripts.com/downloads/PulsePhone-developer-kit.zip) și fișierele existente din bridge/; instalarea normală nu necesită editarea lor
Pozele/videoclipurile jucătorilor cu stocarea integrată media/; păstrează acest folder la actualizare

Secțiunile de mai jos conțin referința detaliată. Nu trebuie să citești fiecare setare de funcție ca să termini prima instalare.

Tradus din engleză. Dacă ceva de aici nu se potrivește cu pagina în engleză, pagina în engleză are dreptate. English