PhoneHub + Pulse Phone — telepítési útmutató

Ez a kiadás egyesíti a Pulse Phone-t, a PhoneHub épületet, az egyedi PhoneHub OS-t, a 3D-s készülékkioszkot, a javítópadot és a személyzeti készlet-/szállítási rendszert. Ez a csak telefonos kiadástól külön termék. A telefont és az üzlet resource-ot együtt telepítsd. Ne futtass két phone példányt vagy a PhoneHub map két verzióját.

1. Telepítés előtt

• Készíts mentést a meglévő telefon resource-odról, map resource-odról, konfigurációdról és adatbázisodról.
• Használj OneSyncet és 2699-es vagy újabb GTA game buildet.
• Előbb az adatbázist, a frameworköt, az inventoryt, a voice resource-ot és a screenshot-basicet indítsd.
• A resource-ok neve maradjon pontosan phone és zerodev_phonehub_mlo.
• Távolítsd el a korábbi PhoneHub resource-okat az aktív resources könyvtárból, és töröld a duplikált ensure sorokat. A mentéseket ezen a könyvtáron kívül tárold.
• Minden más mapot, amely ugyanazt a Portola Drive-i épületet cseréli le, tarts kikapcsolva.
• A map fájlok cseréje előtt zárd be teljesen a FiveM-et, és állítsd le a szervert. Indítsd el a szervert, majd indítsd újra a FiveM-et. Ennek a streamelt MLO-nak a cseréje vagy újraindítása előtt bontsd a kliensek kapcsolatát. Egy csatlakozott kliens akkor is megtarthatja a mapot, ha távol van az épülettől; a futás közbeni újraindítás összeomlaszthatja azt a klienst.

Ez a csomag nem tartalmaz szerver licenckulcsot, frameworköt, inventoryt vagy fizetős külső scripteket. A Keymaster feldolgozása után a szerverkulcsnak ahhoz a fiókhoz kell tartoznia, amely jogosult erre az új, kombinált assetre. A régi, csak telefonos kiadásra szóló jogosultság nem ad jogot erre az új kiadásra.

2. A resource-ok bemásolása

Másold a phone és a zerodev_phonehub_mlo mappát ebből a letöltésből a szervered resources könyvtárába. Bármelyik kategóriamappába teheted őket; a mappák neve pontosan maradjon meg.

screenshot-basic. A kamerához a screenshot-basicnek a phone előtt el kell indulnia; a szabványos resource is működik. A letöltés egy könnyebb példányt is tartalmaz (csak fotózás közben rajzolja a játékképet, ugyanazzal a névvel, exportokkal és eventekkel). Az átváltás opcionális: tartsd meg a régi mappádat mentésként a resources mappán kívül, teszteld a képernyőképet készítő scripteket, és tedd vissza a régi mappát, ha bármi megváltozik. A lépések a Pulse Phone gyors kezdés 6. lépésében vannak; a módosított fájlok a screenshot-basic/ZERODEV-CHANGES.md fájlban vannak felsorolva.

Add hozzá ezeket a sorokat a meglévő függőségeid után a server.cfg fájlban:

ensure phone
ensure zerodev_phonehub_mlo

Ne másolj régi telefonmotort vagy felületet az új csomagba. Frissítéskor vidd át a szükséges beállításokat az új konfigurációs fájlokba. Tartsd meg az adatbázisodat, a resource KVP tárolót, a media és az ownermedia mappákat. Az új phone/config/phonehub_business.lua olyan szállítási beállításokat tartalmaz, amelyek a csak telefonos kiadásból hiányoznak.

A beállított boltpult helye -749.541, -216.952224, 36.256562, iránya 210. Az üzlet helye a tiszta integrált kiadásban már be van állítva. Ebben a kiadásban a PhoneHub az egyetlen telefonbolt: a csak telefonos csomag Legion Square-i üzlete nem része. Egy 1.4.4-es vagy korábbi verzióból megtartott config.lua még felsorolja a Legion Square-t; ezt a bejegyzést kihagyja, és a konzol egyszer jelzi is. A PhoneHub terminál megnyitásához nyomd meg a PhoneHub gombot (alapból E), vagy használd a /phonehub parancsot a kioszknál, egy javítópadnál, a szervizpultnál vagy a tetőn lévő vezérlőpontnál. A kioszk a Shopot, egy javítópad a Repairt nyitja meg. A gomb a FiveM gombkiosztásában módosítható. A parancshoz ugyanaz a közelség kell, mint a gombhoz; a személyzeti műveletekhez továbbra is szerverjogosultság szükséges.

3. Framework, inventory és egyéb scriptek

Kezdd a Config.Framework = 'auto' beállítással és az automatikus provider beállításokkal a phone/config/config.lua fájlban. A telefon indítási állapotjelentése megnevezi a ténylegesen kiválasztott providereket. Vásárlások előtt ellenőrizd ezt a jelentést.

Az inventory adapterek lefedik az ox_inventoryt, a támogatott framework inventory függvényeket és a phone/guides/integrations.md fájlban (vagy a telefon buildedhez mellékelt integrációs útmutatóban) felsorolt külső providereket. Minden providerhez a valódi tárgydefiníciói és kompatibilis API-verzió kell. A hiányzó tárgyakat a telefon állapotellenőrzései jelzik; ezeket a hibákat ne nyomd el. A tárgybeállítási példák a phone/config/items/ mappában találhatók.

A telefon szerkeszthető bridge-ei lefedik a voice-ot, a society számlákat, a bankot, a garázsokat, a housingot, a diszpécsert és egyéb integrációkat. Funkciónként pontosan egy kiválasztott providert tarts meg. Az átnevezett resource-okat a Config.ResourceNames beállításban rögzítsd; providert kifejezetten a Config.Providers beállítással választhatsz. A tetszőleges külső exportok nem automatikusan kompatibilisek: ha a scripted nincs a listán, valósítsd meg a dokumentált custom bridge-et. A framework adapterek és az automatizált szerződéses tesztek nem jelentik azt, hogy minden külső verziót élesben teszteltünk.

Ennek a kiadásnak az élesben tesztelt környezete: ESX Legacy, ox_inventory, oxmysql és pma-voice. Más frameworkön futtasd le a 7. fejezet első indítási ellenőrzéseit, mielőtt megnyitod az üzletet.

4. Nyilvános bolt vagy játékos tulajdonú vállalkozás

Futtasd valamelyik parancsot a szerverkonzolban:

phonehubmode public
phonehubmode business

A kiválasztott mód újraindítások után is megmarad. A public mód megtartja a normál vásárlást. A business mód tartós készletet és foglalásokat alkalmaz a PhoneHub pultnál történő vásárlásokra. A business mód kikapcsolja a pultnál történő beszámítást (trade-in). Ugyanaz a telefonos fizetés ellenőrzi az árakat, a fizetéseket és a tárgyak kézbesítését.

Állítsd be a munka nevét és a rangokat a phone/config/phonehub_business.lua fájlban:

A munkákat a frameworköd szokásos adminisztrációs eszközeivel oszd ki. A cégkezeléshez nyisd meg a telefonon a Services → My Work → PhoneHub → Staff and account menüt. A kiválasztott framework támogatott személyzeti/society függvényeit használja. A kombinált kiadás tartós játékos tulajdont is támogat, akár a Business fülön történő játékon belüli vásárlással, akár az alább leírt adminisztrátori kiosztó paranccsal. Minden tulajdonosi ár játékon belüli pénznemben értendő.

ESX és esx_addonaccount esetén a számla resource indítása előtt importáld a zerodev_phonehub_mlo/setup/phonehub_esx_society.sql fájlt is, majd indítsd újra a szervert. Ez létrehozza a nulla egyenlegű society_phonehub céges számlát anélkül, hogy egy meglévő egyenleget felülírna. Ha átnevezted a munkát, a számla utótagját is igazítsd hozzá. Más banki providereknek a beállított munkához a szokásos céges számla beállításuk kell. A vállalkozás megnyitása előtt ellenőrizz egy kis befizetést és kivételt a Company alatt.

A működési keret egy külön belső készletbeszerzési főkönyv. Az eladások növelik; a beszállítói rendelések csökkentik. Nem automatikusan egy society bankszámla, és nem kivehető játékos készpénzegyenleg.

5. Beszállítói rendelések és készletszállítás

A szervizpultnál nyomd meg az E-t a PhoneHub terminál megnyitásához, majd válaszd a Stockot. Válassz egy terméket, konfigurációt és mennyiséget. A szerver kiszámolja a beszállítói árajánlatot, és ellenőrzi az alkalmazott rangját, közelségét és a működési keretet.

Az alapértelmezett szállítás 120 másodpercig tart. Újraindításokon át is úton marad. Megérkezése után egy alkalmazott a terminálon a Receive delivery lehetőséget választja. Az alapértelmezett destination='stock' az árut az üzlet készletnyilvántartásába teszi, amelyből a fizetés fogyaszt, függetlenül a vásárló inventory providerétől. Az ismételt átvételi kérések nem adhatják hozzá kétszer ugyanazt a szállítmányt. A menedzserek egy át nem vett szállítmányt lemondhatnak, egyszeri keretvisszatérítéssel.

Konfiguráció:

delivery = {
    seconds = 120,
    autoReceive = false,
    destination = 'stock',
    resource = '',
    export = '',
}

Egyedi raktárhoz/stash-hez állítsd be a destination='custom' értéket, és adj meg egy szerverexportot. Ez megkapja a (shipment, source) paramétereket, és a shipment.id értéket tartós duplikációszűrő kulcsként kell használnia. Csak akkor adjon vissza true értéket, ha minden sor sikeresen tárolódott. Az inventoryd tárgy/SKU megfeleltetését ebben az adapterben állítsd be. Az egyedi szállítás nem adja hozzá a tárgyakat a belső eladási főkönyvhöz is; a duplikált készlet elkerülése érdekében a raktári eladási folyamatodat kifejezetten kösd be. Nem feltételezünk univerzális stash adaptert.

Egy bizonytalan külső átadás felülvizsgálatra félre lesz téve, sosem próbálja újra vakon. A cél inventory ellenőrzése után használd ezt:

phonehubdelivery <shipment-id> delivered
phonehubdelivery <shipment-id> retry

Egy bizonytalan vásárlói fizetési foglalásnál nézd át a fizetési és inventory nyilvántartásokat, mielőtt ezt használnád: phonehubresolve <reservation-id> returned|delivered.

6. Üzletvezérlés

Nyomd meg az E-t a szervizvezérlő pont vagy a tetőn lévő vezérlőoszlop közelében.

• Space: a bejárati és a tetőajtó zárjai, az üzletvilágítás, a lounge kijelzője, a terasz üvegteteje (esőben vagy hóban automatikus, vagy nyitva/zárva), a teraszfűtők vagy a légáramlás, a terasz áramellátása és egy 15 másodperces sprinklerteszt.
• Cameras: Entrance overview, Showroom overview és Service counter. A terminálra visszalépés bezárja a kamerát; az Escape kilép.
• Stock és Business: beszállítói rendelések, szállítások, bevételek, az eladási és javítási főkönyv, valamint a csapat hozzáférése.

Az épületvezérléshez a PhoneHub munka vagy a beállított személyzeti/admin ACE kell. A terasz nyilvános vezérlési hozzáférése külön van beállítva a systems_config.lua fájlban. A phonehub.admin jogot csak a megbízható adminisztrátori principalodnak add meg; soha ne mindenkinek. Állítsd be a phoneResource='phone' értéket az MLO rendszerkonfigurációjában.

Az automata ajtók zárolatlan állapotban közelségérzékelőket használnak. A mozgó szárnyaiknak szilárdnak kell maradniuk, nyitott állapotban is. A bútorok, az üveg és a világítás a map részeként készült assetek; nem minden dekorációs tárgynak van játékbeli interakciója.

7. Első indítási átvétel

1. Indítsd el a szervert, és futtasd a phone:health parancsot. Erősítsd meg a várt framework, inventory, adatbázis és voice providereket, és hogy nem hiányzik kötelező tárgy.
2. Csatlakozz normálisan, és látogasd meg az üzletet. Kikapcsolt noclippel sétálj be a járdáról mindkét bejárati ajtópáron, menj fel/le a lépcsőn, és át a tetőre vezető ajtón.
3. Nyisd ki és zárd be az üvegtetőt. A nyolc panelnek minden helyzetben a vezetősínekben kell maradnia. Az automatikus eső/hó miatti zárást külön teszteld.
4. Nyiss meg minden CCTV nézetet, válts közöttük, és lépj ki. A jelenetnek láthatónak kell lennie, és a normál játékosnézetnek/fókusznak vissza kell térnie.
5. Zárd be mindkét ajtócsoportot egy személyzeti fiókkal. Ellenőrizd az ütközést mindkét oldalról. Nyisd ki, és ellenőrizd újra a közelségre nyíló animációt.
6. Ellenőrizd a nappali/éjszakai világítást, a kijelző be/ki állapotát, az üveget, a feliratokat, az üléseket és minden élt. Sétálj és vezess az épület felé/elől, hogy megnézd a streamelési átmeneteket.
7. Vegyél egy telefont/kiegészítőt public módban. Business módban ellenőrizd a készletcsökkenést, az alkalmazotti rendelést, a megérkezést/átvételt, a fedezethiányt és a jogosulatlan hozzáférést.
8. Indítsd újra a szervert, és erősítsd meg, hogy a bolt módja, a készlet és a függő szállítások megmaradnak. Ismételj meg egy duplikált átvételi/lemondási kísérletet; nem jelenhet meg duplikált áru vagy visszatérítés. Ellenőrizd, hogy több játékos ugyanazt az üzletállapotot látja.

A kliens F8 konzoljában a phonehubcheck jelzi a tényleges tetőpanel-illeszkedést; minden panelnek 1-hez közeli illeszkedést kell mutatnia. Ez diagnosztika, nem bizonyíték arra, hogy a vizuális minőség vagy az ütközések helyesek. Az automatizált ellenőrzések nem tudnak minden kameraszöget vagy minden szerverkombinációt igazolni.

8. Hibaelhárítás és frissítések

A 30120-as port foglalt: már fut egy másik szerverpéldány. Állítsd le a txAdminodon (vagy a host paneljén) keresztül, ahelyett, hogy egy második FXServert indítanál.

Hiányzó vezérlők: ellenőrizd, hogy mindkét resource elindult, a nevük változatlan, és a játékos a vezérlőpontnál van. Nézd meg a kliens F8 és a szerver hibáit.

Nincs személyzeti hozzáférés: ellenőrizd a beállított munkát, a numerikus rangot, a szervizpult közelségét és a kiválasztott job providert. A public bolt mód nem ad személyzeti jogokat.

A régi map/régi felület megmarad: töröld a duplikált resource/ensure bejegyzéseket. Zárd be teljesen a FiveM-et, állítsd le a szervert, cseréld le a fájlokat, majd indítsd el a szervert, és indítsd újra a FiveM-et. Egy egyszerű újracsatlakozás megtarthatja az elavult streamelt asseteket. Ne töltsd újra futás közben az MLO-t, amíg egy kliens csatlakozva van, még akkor sem, ha messze van az épülettől.

Visszaállás: állítsd le ezeket a resource-okat, állítsd vissza a mentett resource mappákat és konfigurációt, majd indíts újra a meglévő txAdminoddal. Az adatbázist/KVP tárolót őrizd meg, hacsak nem szándékosan egy konzisztens adatmentést állítasz vissza.

A támogatási kérésekhez őrizd meg a mellékelt kiadási hasheket (SHA256.json).

PhoneHub OS és tulajdonjog

A Config.PhoneHubOS a phone/config/phonehub_business.lua fájlban vezérli ezt a kiadást. Az ownership='both' engedélyezi a játékon belüli vásárlást és az adminisztrátori kiosztást is. Állítsd 'admin' vagy 'purchase' értékre, ha csak az egyik utat engedélyeznéd. A purchasePrice egy játékon belüli pénzösszeg. Az adminisztrátorok a phonehubowner <online player id> parancsot használják a szerverkonzolból vagy a phonehub.admin ACE birtokában. A kiosztás le van tiltva, amíg egy vásárlási fizetés függőben van. A tulajdonos a framework karakterazonosítójához kötve tárolódik, sosem egy ideiglenes játékos source számhoz. A tulajdonjog aktiválja a meglévő tartós készlet- és működési keret rendszert.

A tulajdonosok a Business fülön adhatnak hozzá közeli személyzetet vagy menedzsereket. Ezek a független szerepek a framework identitás bridge-én keresztül működnek; nem változtatják meg a játékos fő munkáját. A meglévő PhoneHub munkaszerepek és a beállított adminisztratív hozzáférés továbbra is működnek. Alapból a menedzserek rendelhetnek árut, a személyzet pedig átveheti a megérkezett szállítmányokat. A készlet foglalt marad, amíg egy vásárlás vagy beszállítói szállítás meg nem erősítésre kerül.

A service='hybrid' engedélyezi a személyzet által segített és az önkiszolgáló fizetést és javítást is. A 'self' közvetlen kiszolgálást enged; a 'staff' ebben az üzletben a vásárló által jóváhagyott személyzeti ajánlatot követel meg. Az önálló termék megtartja a meglévő vásárlási OS-ét.

A kioszknál menj oda, és nyomd meg az E-t. A Shop fül a tényleges, védett Pulse modellt tölti be, húzással forgatható, elöl/hátul megtekinthető, nagyítható, és a kiválasztott kivitelben látszik. Az ár a telefon szerveréből jön. A fizetéshez megerősítés kell, és a beállított inventoryt, pénzt és dobozos telefonkézbesítést használja. Egy időtúllépés nem bizonyítja, hogy a terhelés sikertelen volt; újrapróbálás előtt ellenőrizd az inventoryt és a fizetési naplót.

A vásárlók a Help fülön kérnek értékesítési vagy javítási segítséget, és sorszámot kapnak. A személyzet a Counter fülön kiválaszt egy közeli vásárlót, és ajánlatot készít; csak az a vásárló hagyhatja jóvá és fizetheti ki. Mindkettőjüknek ugyanabban az üzletben, ugyanabban a routing bucketben kell maradnia. A javítás jóváhagyása a kiválasztott egyedi készülékhez és annak ajánlott árához kötődik. A készülék cseréje érvényteleníti.

Segített javításnál a technikus egy szabad javítópadnál nyitja meg a terminált, elkészíti a vásárló javítási ajánlatát, és ott marad az elfogadásig. A pad a fizetés előtt foglalásra kerül. Egy sikeres, kifizetett javítás lefuttatja az összeszerelési folyamatot, technikusként azzal a játékossal; önkiszolgálásnál az üzlet technikusa végzi. A készülék javítását a telefonmotor kezeli, és egy megszakadt szerver-munkamenet után helyreállítja a kifizetett munkát. A kliens propok soha nem hoznak létre vagy cserélnek le inventoryban lévő telefont.

A Space fül a tetőn és a pultnál lévő vezérlőpontokon vezérli az üvegtetőt, a klímát, a zárakat, a világítást és a kijelzőt. A kész MLO geometriája, időjárás elleni védelme, padlózata és ülőhelyei megmaradnak.