PhoneHub + Pulse Phone — vodnik za namestitev

Ta izdaja združuje Pulse Phone, stavbo PhoneHub, PhoneHub OS po meri, 3D kiosk s telefoni, servisno delovno mizo in sistem zaloge/dostave za osebje. To je ločen izdelek od izdaje samo s telefonom. Telefon in resource trgovine namestite skupaj. Ne poganjajte dveh kopij phone ali dveh različic mapa PhoneHub.

1. Pred namestitvijo

• Varnostno kopirajte obstoječi resource za telefon, resource mapa, konfiguracijo in bazo podatkov.
• Uporabite OneSync in GTA game build 2699 ali novejši.
• Najprej zaženite bazo podatkov, framework, inventar, glasovni resource in screenshot-basic.
• Imena resourcov ohranite točno phone in zerodev_phonehub_mlo.
• Prejšnje resource PhoneHub odstranite iz aktivne mape resourcov in odstranite podvojene vrstice ensure. Varnostne kopije hranite zunaj te mape.
• Vsak drug map, ki nadomešča isto stavbo na Portola Drive, naj ostane onemogočen.
• Pred zamenjavo datotek mapa popolnoma zaprite FiveM in ustavite strežnik. Zaženite strežnik, nato znova zaženite FiveM. Pred zamenjavo ali ponovnim zagonom tega streamanega MLO odklopite odjemalce. Povezan odjemalec lahko map obdrži, tudi ko je daleč od stavbe; ponovni zagon med delovanjem lahko ta odjemalec sesuje.

Ta paket ne vključuje licenčnega ključa strežnika, frameworka, inventarja ali plačljivih skript tretjih oseb. Po obdelavi v Keymaster mora ključ strežnika pripadati računu, ki je upravičen do tega novega kombiniranega asseta. Upravičenje do stare izdaje samo s telefonom te nove izdaje ne zagotavlja.

2. Kopirajte resource

Mapi phone in zerodev_phonehub_mlo iz tega prenosa kopirajte v mapo resourcov svojega strežnika. Postavite ju lahko v katerokoli mapo kategorije; imena map ohranite točno takšna.

screenshot-basic. Kamera potrebuje screenshot-basic, zagnan pred phone; standardni resource deluje. Prenos vsebuje tudi lažjo kopijo (sliko igre riše samo med fotografiranjem, z istim imenom, exporti in dogodki). Prehod nanjo je neobvezen: staro mapo hranite kot varnostno kopijo zunaj resources, preizkusite skripte, ki delajo zaslonske slike, in vrnite staro mapo, če se karkoli spremeni. Hitri začetek Pulse Phone, korak 6, vsebuje korake; spremenjene datoteke so navedene v screenshot-basic/ZERODEV-CHANGES.md.

Te vrstice dodajte za obstoječimi odvisnostmi v server.cfg:

ensure phone
ensure zerodev_phonehub_mlo

V nov paket ne kopirajte starega pogona telefona ali vmesnika. Pri nadgradnji prenesite potrebne nastavitve v nove konfiguracijske datoteke. Obdržite bazo podatkov, shrambo KVP resourca ter mapi media in ownermedia. Novi phone/config/phonehub_business.lua vsebuje nastavitve dostave, ki jih izdaja samo s telefonom nima.

Nastavljeni prodajni pult je na -749.541, -216.952224, 36.256562, smer 210. Lokacija trgovine je v čisti integrirani izdaji že nastavljena. PhoneHub je edina trgovina s telefoni v tej izdaji: trgovina na Legion Square iz paketa samo s telefonom ni del nje. config.lua iz 1.4.4 ali starejše še navaja Legion Square; ta vnos se preskoči, konzola pa to enkrat pove. Za odprtje terminala PhoneHub pritisnite tipko PhoneHub (privzeto E) ali uporabite /phonehub pri kiosku v trgovini, servisni mizi, servisnem pultu ali nadzorni točki na strehi. Kiosk odpre Shop, servisna miza pa Repair. Tipko je mogoče spremeniti v vezavah tipk FiveM. Ukaz zahteva enako bližino kot tipka; dejanja osebja še vedno zahtevajo dovoljenje strežnika.

3. Framework, inventar in druge skripte

Začnite z Config.Framework = 'auto' in samodejnimi nastavitvami ponudnikov v phone/config/config.lua. Poročilo o stanju telefona ob zagonu navede ponudnike, ki jih je dejansko izbral. Preden izvajate nakupe, preverite to poročilo.

Adapterji za inventar pokrivajo ox_inventory, podprte funkcije inventarja frameworkov in imenovane ponudnike tretjih oseb, navedene v phone/guides/integrations.md (ali v vodniku za integracije, priloženem vašemu buildu telefona). Vsak ponudnik potrebuje svoje prave definicije predmetov in združljivo različico API-ja. Manjkajoče predmete sporočijo preverjanja stanja telefona; teh napak ne zatirajte. Primeri nastavitve predmetov so v phone/config/items/.

Urejljivi mostovi telefona pokrivajo glas, račune podjetij, bančništvo, garaže, nepremičnine, dispečing in druge integracije. Ohranite natanko enega izbranega ponudnika na funkcijo. Preimenovane resource določite prek Config.ResourceNames; za izrecno izbiro ponudnika uporabite Config.Providers. Poljubni exporti tretjih oseb niso samodejno združljivi: ko vaše skripte ni na seznamu, implementirajte dokumentirani most po meri. Adapterji frameworkov in avtomatski pogodbeni testi niso trditev, da je bila vsaka različica tretjih oseb testirana v živo.

Sklop, testiran v živo za to izdajo: ESX Legacy, ox_inventory, oxmysql in pma-voice. Na drugem frameworku pred odprtjem trgovine izvedite preverjanja ob prvem zagonu iz razdelka 7.

4. Javna trgovina ali podjetje v lasti igralcev

V konzoli strežnika zaženite katerikoli ukaz:

phonehubmode public
phonehubmode business

Izbrani način se ohrani čez ponovne zagone. Javni način ohrani običajno nakupovanje. Poslovni način za nakupe na pultu PhoneHub uporabi trajno zalogo in rezervacije. Poslovni način onemogoči zamenjave staro za novo na pultu. Isto plačilo v telefonu preveri cene, plačila in dostavo predmetov.

Ime službe in stopnje nastavite v phone/config/phonehub_business.lua:

Službe dodelite z običajnimi administracijskimi orodji svojega frameworka. Za upravljanje podjetja na telefonu odprite Services → My Work → PhoneHub → Staff and account. Uporablja podprte funkcije osebja/society izbranega frameworka. Kombinirana izdaja podpira tudi trajno lastništvo igralca prek nakupa v igri na zavihku Business ali prek spodaj opisanega administratorskega ukaza za dodelitev. Vse cene lastništva so zneski v valuti igre.

Za ESX z esx_addonaccount pred zagonom resourca računov uvozite tudi zerodev_phonehub_mlo/setup/phonehub_esx_society.sql, nato ponovno zaženite strežnik. To ustvari račun podjetja society_phonehub z ničelnim stanjem, ne da bi nadomestilo obstoječe stanje. Če ste službo preimenovali, temu ustrezno posodobite pripono računa. Drugi bančni ponudniki potrebujejo svojo običajno nastavitev računa podjetja za nastavljeno službo. Pred odprtjem podjetja v Company preverite majhen polog in dvig.

Obratovalni proračun je ločena interna knjiga za nakup zaloge. Prodaja ga povečuje; naročila pri dobavitelju ga zmanjšujejo. Ni samodejno bančni račun society in ni gotovinsko stanje igralca, ki bi ga bilo mogoče dvigniti.

5. Naročila pri dobavitelju in dostava zaloge

Pri servisnem pultu pritisnite E, da odprete terminal PhoneHub, nato Stock. Izberite izdelek, konfiguracijo in količino. Strežnik izračuna ponudbo dobavitelja ter preveri stopnjo zaposlenega, bližino in obratovalni proračun.

Privzeta dostava traja 120 sekund. Na poti ostane tudi čez ponovne zagone. Ko prispe, zaposleni na terminalu izbere Receive delivery. Privzeti destination='stock' blago doda v knjigo zaloge trgovine, ki jo porablja blagajna, neodvisno od ponudnika inventarja kupca. Ponovljene zahteve za prevzem iste pošiljke ne morejo dodati dvakrat. Vodje lahko neprevzeto pošiljko prekličejo za enkratno vračilo v proračun.

Konfiguracija:

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

Za skladišče/stash po meri nastavite destination='custom' in navedite strežniški export. Ta prejme (shipment, source) in mora uporabiti shipment.id kot trajni ključ za odstranjevanje dvojnikov. True vrnite samo, ko je vsaka vrstica uspešno shranjena. Preslikavo predmetov/SKU vašega inventarja nastavite v tem adapterju. Dostava po meri predmetov ne doda tudi v interno knjigo prodaje; prodajni tok svojega skladišča povežite izrecno, da se izognete podvojeni zalogi. Univerzalni adapter za stash ni predviden.

Negotova zunanja predaja se zadrži za pregled, nikoli se ne ponovi na slepo. Ko preverite ciljni inventar, uporabite:

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

Pri negotovi rezervaciji ob plačilu stranke preglejte zapise plačila in inventarja, preden uporabite phonehubresolve <reservation-id> returned|delivered.

6. Upravljanje trgovine

Pritisnite E ob servisni nadzorni točki ali nadzornem podstavku na strehi.

• Space: ključavnice vhodnih in strešnih vrat, luči v trgovini, zaslon v salonu, nadstrešnica terase (samodejno ob dežju ali snegu ali odprto/zaprto), grelniki ali zračenje terase, elektrika na terasi in 15-sekundni test škropilnikov.
• Kamere: Entrance overview, Showroom overview in Service counter. Back to the terminal zapre kamero; Escape izstopi.
• Stock in Business: naročila pri dobavitelju, dostave, izkupiček, knjiga prodaje in popravil ter dostop ekipe.

Upravljanje stavbe zahteva službo PhoneHub ali nastavljeni ACE za osebje/admina. Javni dostop do upravljanja terase se nastavi ločeno v systems_config.lua. phonehub.admin dodelite samo svojemu zaupanja vrednemu administratorskemu principalu; nikoli vsem. V konfiguraciji sistemov MLO nastavite phoneResource='phone'.

Avtomatska vrata, ko so odklenjena, uporabljajo senzorje bližine. Njihova gibljiva krila morajo ostati trdna, tudi ko so odprta. Pohištvo, steklo in razsvetljava so izdelani map asseti; vsak okrasni predmet nima interakcije v igri.

7. Prevzem ob prvem zagonu

1. Zaženite strežnik in izvedite phone:health. Potrdite pričakovane ponudnike frameworka, inventarja, baze podatkov in glasu ter da ne manjka noben obvezen predmet.
2. Pridružite se normalno in obiščite trgovino. Z izklopljenim noclipom hodite s pločnika skozi oba para vhodnih vrat, gor/dol po stopnicah in skozi vrata na streho.
3. Odprite in zaprite nadstrešnico. Njenih osem plošč mora v vsakem položaju ostati poravnanih v vodilih. Samodejno zapiranje ob dežju/snegu preizkusite ločeno.
4. Odprite vsak pogled CCTV, preklapljajte med njimi in izstopite. Prizor mora biti viden, običajen pogled/fokus igralca pa se mora vrniti.
5. Z računom osebja zaklenite obe skupini vrat. Preverite kolizijo z obeh strani. Odklenite in znova preverite animacijo odpiranja ob bližini.
6. Preverite dnevno/nočno osvetlitev, zaslon vklopljen/izklopljen, steklo, napise, sedeže in vse robove. Hodite in vozite proti stavbi in stran od nje, da pregledate prehode streaminga.
7. V javnem načinu kupite telefon/dodatek. V poslovnem načinu preverite zmanjšanje zaloge, naročanje zaposlenih, prispetje/prevzem, nezadostna sredstva in nepooblaščen dostop.
8. Ponovno zaženite strežnik in potrdite, da se način trgovine, zaloga in čakajoče dostave ohranijo. Ponovite podvojen poskus prevzema/preklica; ne sme se pojaviti podvojeno blago ali vračilo. Preverite, da več igralcev vidi isto stanje trgovine.

phonehubcheck v odjemalčevi konzoli F8 poroča dejansko poravnavo pokrova; vsaka plošča bi morala poročati poravnavo blizu 1. To je diagnostika, ne dokaz, da sta vizualna kakovost ali kolizija pravilni. Avtomatska preverjanja ne morejo potrditi vsakega kota kamere ali vseh kombinacij strežnikov.

8. Odpravljanje težav in posodobitve

Vrata 30120 zasedena: drugi primerek strežnika že teče. Ustavite ga prek svojega txAdmin (ali plošče gostitelja), namesto da zaženete drug FXServer.

Kontrolniki manjkajo: preverite, da sta se oba resourca zagnala, da njuni imeni nista spremenjeni in da je igralec pri nadzorni točki. Preglejte napake v odjemalčevem F8 in na strežniku.

Ni dostopa za osebje: preverite nastavljeno službo, številsko stopnjo, bližino servisnega pulta in izbranega ponudnika služb. Javni način trgovine ne daje pravic osebja.

Star map/star vmesnik ostaja: odstranite podvojene resource/vnose ensure. Popolnoma zaprite FiveM, ustavite strežnik, zamenjajte datoteke, nato zaženite strežnik in znova FiveM. Samo ponovna povezava lahko ohrani zastarele streamane assete. MLO ne nalagajte znova med delovanjem, ko je odjemalec povezan, tudi daleč od stavbe.

Vrnitev: ustavite te resource, obnovite varnostno kopirane mape resourcov in konfiguracijo, nato ponovno zaženite z obstoječim txAdmin. Shrambo baze podatkov/KVP ohranite, razen če namenoma obnavljate dosledno varnostno kopijo podatkov.

Priložene zgoščene vrednosti izdaje (SHA256.json) shranite za zahteve za podporo.

PhoneHub OS in lastništvo

Config.PhoneHubOS v phone/config/phonehub_business.lua upravlja to izdajo. ownership='both' dovoli nakup v igri in dodelitev s strani administratorja. Nastavite 'admin' ali 'purchase', da dovolite samo eno pot. purchasePrice je znesek v valuti igre. Administratorji uporabljajo phonehubowner <online player id> iz konzole strežnika ali z ACE phonehub.admin. Dodelitev je blokirana, dokler čaka plačilo nakupa. Lastnik se shrani glede na identifikator lika v frameworku, nikoli glede na začasno številko vira igralca. Lastništvo aktivira obstoječi trajni sistem zaloge in obratovalnega proračuna.

Lastniki na zavihku Business dodajo bližnje osebje ali vodje. Te neodvisne vloge delujejo prek mostu za identiteto frameworka; ne spremenijo glavne službe igralca. Obstoječe vloge služb PhoneHub in nastavljen administratorski dostop še vedno delujejo. Vodje lahko privzeto naročajo zaloge, osebje pa lahko prevzema prispele pošiljke. Zaloga ostane rezervirana, dokler nakup ali dostava dobavitelja ni potrjena.

service='hybrid' dovoli tako asistirano kot samopostrežno plačilo in popravila. 'self' dovoli neposredno storitev; 'staff' v tej trgovini zahteva ponudbo osebja, ki jo stranka odobri. Samostojni izdelek ohrani svoj obstoječi nakupovalni OS.

Pri kiosku v trgovini pristopite in pritisnite E. Zavihek Shop naloži dejanski zaščiteni model Pulse, z vrtenjem z vlečenjem, ogledom spredaj/zadaj, povečavo in izbrano izvedbo. Cena pride s strežnika telefona. Plačilo zahteva potrditev in uporablja nastavljeni inventar, denar in dostavo telefona v škatli. Potek časa ni dokaz neuspele bremenitve; pred ponovnim poskusom preverite inventar in dnevnik plačil.

Stranke na zavihku Help zaprosijo za pomoč pri prodaji ali popravilu in dobijo številko v vrsti. Osebje na zavihku Counter izbere bližnjo stranko in pripravi ponudbo; odobri in plača jo lahko samo ta stranka. Oba morata ostati v isti trgovini v istem routing bucketu. Odobritev popravila je vezana na izbrano unikatno napravo in njeno ponujeno ceno. Zamenjava naprave jo razveljavi.

Pri asistiranih popravilih tehnik odpre terminal pri prosti servisni mizi, pripravi ponudbo za popravilo stranke in tam ostane do sprejetja. Miza je rezervirana pred plačilom. Uspešno plačano popravilo izvede zaporedje sestavljanja s tem igralcem kot tehnikom; samopostrežba uporabi tehnika trgovine. Popravilo naprave izvaja pogon telefona, ki po prekinjeni seji strežnika obnovi plačano delo. Odjemalčevi propi nikoli ne ustvarijo ali nadomestijo telefona v inventarju.

Zavihek Space na nadzornih točkah na strehi in pri pultu upravlja nadstrešnico, klimo, ključavnice, razsvetljavo in zaslon. Geometrija, zaščita pred vremenom, tla in sedeži iz dokončanega MLO so ohranjeni.