Pulse Phone dokumentáció
Telepítési részletek
1. Gyors telepítés
Mielőtt bármit bemásolnál
Használj olyan szerver artifactot, amely megfelel az alábbi követelményeknek, bekapcsolt OneSynccel és 2699-es vagy újabb game builddel. Egy normál roleplay szerveren előbb a frameworköd, az inventoryd, az oxmysql, a voice resource és a screenshot-basic működjön. A standalone framework nélkül is működik; ott az inventory tárgyak opcionálisak.
A vásárlás igénylése után töltsd le a resource-ot a Cfx.re fiókodból. Azt a szerverkulcsot használd, amely az assetet birtokló fiókhoz tartozik. Ha a Cfx.re entitlement hibát jelez, javítsd a fiók és a kulcs összerendelését; a telefon beállításainak módosítása nem adhat jogosultságot.
1. lépés — Tedd a resource-ot a szerveredre
Csomagold ki a csomagot, és másold a phone resource mappát, amely az fxmanifest.lua fájlt tartalmazza, a szervered resources könyvtárába. Ne nevezd át, és ne a külső ZIP/csomag mappát tedd a helyére.
Bérelt szerveren Binary módban tölts fel, vagy töltsd fel a zipet, és ott csomagold ki (miért). A gyors kezdés (2. lépés) felsorolja ennek a buildnek minden mappájára a fájlszámot és a méretet, az indítási ellenőrzés pedig megnevez minden hiányzó vagy rossz méretű fájlt.
A Pulse tesztelése előtt állítsd le az előző telefon resource-odat, hogy két telefon ne versengjen ugyanazért a gombért és tárgyért. Mentsd el az adatait, ha később importálni szeretnéd őket.
2. lépés — Add hozzá az inventory tárgyakat
Válaszd ki a meglévő inventorydat; nem kell lecserélned.
| Az inventoryd | Szükséges teendő |
|---|---|
| ox_inventory | Nyisd meg a mellékelt config/items/ox_inventory.lua fájlt. Olvaszd be a bejegyzéseit az ox_inventory/data/items.lua fájlba, a meglévő táblázaton belül. Ne cseréld le az inventory teljes fájlját. Tartsd meg az ox_inventory saját phone bejegyzését: használata a Pulse Phone-t nyitja meg, és az indítási ellenőrzés Phone item sora ezt meg is erősíti. Csak akkor cseréld le a kiírt bejegyzésre, ha ez a sor szerint egy másik scriptet nyit meg. Másold a képeket a config/items/images/ mappából az ox_inventory/web/images/ mappába. A szerkesztés után indítsd újra a szervert. |
| qb-inventory QBCore-ral | A hiányzó tárgydefiníciók induláskor automatikusan regisztrálódnak. Másold a config/items/images/ mappát a qb-inventory/html/images/ mappába. Ha az inventoryd állandó shared bejegyzéseket igényel, a mellékelt config/items/qb-core.lua beolvasztásra készen áll a qb-core/shared/items.lua fájlba. |
| ESX alapértelmezett inventory | A hiányzó tárgyak automatikusan hozzáadódnak. Ha a konzol újraindítást kér, indítsd újra egyszer, hogy az ESX beolvassa őket. Ha az adatbázis-fiókod nem tudja hozzáadni őket, használd a config/items/esx.sql fájlt. |
| qs-inventory vagy más támogatott inventory | Kövesd az inventorydra vonatkozó rövid sort a Tárgyak és inventoryk oldalon. Az inventory saját tárgylistáját és képmappáját használd. |
| Standalone inventory nélkül | Nincs szükség inventory bejegyzésekre. Hagyd kikapcsolva a tárgykövetelményeket. |
Az indítási ellenőrzés azonosítja a hiányzó bejegyzéseket, és csak azokat a definíciókat írja ki, amelyekre még szükséged van. Egy induláskor tárgydefiníciókat betöltő inventorynak, mint az ox_inventory, szüksége van a fenti bejegyzésekre; a Pulse nem írja felül más resource-ok fájljait.
3. lépés — Ellenőrizd a fő konfigurációt
Nyisd meg a config/config.lua fájlt. Az alapértelmezések felismerik a meglévő környezetedet:
Config.Framework = 'auto'Hagyd az inventory = 'auto' értéket a meglévő Config.Providers táblában. Ha több inventory resource-ot futtatsz, állítsd ezt az értéket arra az inventoryra, amelyet használni szeretnél, például 'ox_inventory'. Ne adj hozzá második Config.Providers vagy Config.Item táblát a fájl végén.
A meglévő Config.Item táblában válaszd ki, hogyan működjenek a telefonok:
| Beállítás | Mit csinál |
|---|---|
required = false, unique = false |
Minden karakternek van telefonja tárgy hordása nélkül. Az első teszthez hasznos. |
required = true, unique = false |
A karakternek phone tárgy kell a saját telefonja megnyitásához. A tárgy odaadása nem viszi át az adatait. |
unique = true |
Minden telefontárgynak saját száma és adatai vannak. A tárgy átadása az adott készüléket adja át. ox_inventory, qb-inventory, qs-inventory, core_inventory vagy codem-inventory szükséges hozzá. |
name = 'phone' |
Az inventory tárgy neve. Hagyd így, hacsak nem módosítod a mellékelt tárgydefiníciót is. |
Az egyedi telefonok a kiválasztott inventory bridge-et követik. Hagyd a Config.Item.inventory = 'auto' beállítást; ez a régebbi felülírás csak a meglévő haladó telepítésekhez kell. A Config.Providers.inventory elsőbbséget élvez, ha kifejezetten be van állítva.
Meglévő szerveren ne módosítsd a Config.IdentityScope értéket. Az alapértelmezett 'character' külön tartja a különböző karakterek telefonjait.
Opcionális: inventorys telefonok és fizetős szolgáltatás
Ha minden telefonhoz külön készüléktárgyat akarsz megkövetelni, az inventory bejegyzések hozzáadása után állítsd be a required = true és az unique = true értéket a meglévő Config.Item táblában a config/config.lua fájlban. A fent felsorolt, egyedi telefonokat támogató inventoryk egyikét használd.
Telefonszolgáltatás árusításához állítsd be a Config.Carrier.enabled = true értéket ugyanebben a fájlban. Ez bekapcsolja a Carrier alkalmazást, ahol a játékosok megveszik a csomagjukat. Az új telefonoknak csomag kell, mielőtt a normál hívások, üzenetek és mobiladatos alkalmazások elérhetővé válnak. Az App Hub az a hely, ahol a játékosok alkalmazásokat telepítenek, nem a szolgáltatási bolt. Állítsd be a Config.Coverage.enabled = true értéket is, ha lefedettségi zónákat is szeretnél. A lefedettség és a fizetős csomagok külön opciók; bármelyiket kikapcsolva hagyhatod, ha nem kéred az adott funkciót.
A meglévő beállításokat szerkeszd ahelyett, hogy duplikált táblákat adnál hozzá. Mentés után indítsd újra a szervert. Ha egy játékon belüli beállítás korábban mentve lett, állítsd vissza azt a beállítást a Settings → Server alatt, hogy a fájlban lévő érték érvényesüljön.
4. lépés — A függőségeket a Pulse előtt indítsd
Tartsd meg a meglévő adatbázis-kapcsolatodat és framework beállításaidat. Csak a hiányzó sorokat add hozzá; egyetlen függőségből se indíts második példányt.
Ezt a sorrendet használd a szervereden már telepített resource-okkal:
- Az adatbázis resource és a meglévő kapcsolódási beállításai.
- A framework és a szükséges könyvtárai, identitás- és karakter resource-ai.
- Az inventory, az adott inventory frameworködhöz tartozó konfigurációjával.
- Egy támogatott voice resource és a
screenshot-basic. ensure phone.
Ne telepíts ESX-et, QBCore-t vagy másik inventoryt csak a Pulse kedvéért. A konkrét indítási sorrend példájáért válaszd ki a meglévő környezetedet a A frameworköd oldalon. A Qboxot akkor is Qboxként ismeri fel, ha egy másik resource a QBCore-kompatibilis exportjait használja.
A Pulse adminisztrátori hozzáféréshez add hozzá: add_ace group.admin phone.admin allow. Az adminisztrátori fiókodnak már a group.admin tagjának kell lennie, hogy ez a jogosultság érvényesüljön.
5. lépés — Olvasd el az első indítási ellenőrzést
Indítsd újra a szervert. A Pulse kiír egy indítási jelentést, és automatikusan létrehozza az adatbázistábláit, amint az SQL kapcsolat elérhető.
- FIX / FAIL: egy szükséges rész nem tud működni. Kövesd a javító sort, mielőtt a játékosok használnák.
- NOTE / WARN: nézd meg, melyik funkciót érinti; egyes figyelmeztetések olyan opcionális funkciókról szólnak, amelyeket nem állítottál be.
- Az ellenőrzés megismétléséhez futtasd a
phone:healthparancsot a szerverkonzolban. - A kiválasztott framework/inventory/providerek megtekintéséhez futtasd a
phone:diagparancsot. - Adminként lépj be, nyisd meg az F8-at, és futtasd a
phone:setupparancsot a meglévő vezetett beállításhoz.
A játékon belüli admin beállításban mentett beállítások felülírják a megfelelő fájlbeállításokat. Ha egy fájlmódosítás hatástalannak tűnik, nézd meg a Settings → Server alatt, és állítsd vissza a mentett felülírást, mielőtt további fájlokat módosítanál.
6. lépés — Tesztelj játékosként
- Tölts be egy karaktert, nyomd meg az F1-et, és fejezd be a telefon beállítását. Ha a tárgykövetelmények be vannak kapcsolva, előbb vegyél egy telefont a boltban, vagy add oda a karakternek a beállított telefontárgyat.
- Ha lezárt dobozt vettél, a kicsomagoláshoz használd a dobozt az inventoryból, majd fejezd be a beállítást. A készülék bekapcsolva érkezik;
Config.Device.arrivesOn = falseesetén előbb tartsd lenyomva az End vagy az O gombot. - Nyisd meg a Messages, a Contacts és a Phone alkalmazást. Térj vissza a kezdőképernyőre, nyisd meg az alkalmazásváltót, és sorban zárd be az egyes alkalmazásokat.
- Készíts egy fotót és egy rövid videót. Nyisd meg mindkettőt a Photosban, zárd be és nyisd meg újra a telefont, és ellenőrizd, hogy megmaradtak.
- Csatlakozz újra, és ellenőrizd, hogy ugyanannak a karakternek továbbra is ugyanaz a telefonja. Tesztelj hívásokat egy második játékossal a telepített voice resource-oddal.
Hol mit módosíthatsz
| Amit módosítani szeretnél | Fájl vagy hely |
|---|---|
| Framework, inventory provider, telefontárgy, bolt, modellek, gombkiosztás | config/config.lua |
| Voice provider | config/config.lua |
| Alkalmazás- és szolgáltatás-/munkabeállítások | config/apps.lua |
| Inventory bejegyzések és képek | config/items/ |
| Adatbázis-kapcsolat, resource indítási sorrend, médiaszolgáltató hitelesítő adatai | server.cfg (a privát hitelesítő adatokat tartsd szerveroldalon) |
| Fejlesztői integrációk | Haladó integrációk, az opcionális Developer Kit (zerodevscripts.com/downloads/PulsePhone-developer-kit.zip) és a meglévő bridge/ fájlok; a normál telepítéshez ezeket nem kell szerkeszteni |
| Játékosfotók/-videók a beépített tárhellyel | media/; frissítéskor őrizd meg ezt a mappát |
Az alábbi fejezetek tartalmazzák a részletes referenciát. Az első telepítés befejezéséhez nem kell minden funkcióbeállítást elolvasnod.