PhoneHub + Pulse Phone — vodič za instalaciju

Ovo izdanje kombinuje Pulse Phone, PhoneHub zgradu, custom PhoneHub OS, 3D kiosk za telefone, radni sto za popravke i sistem zaliha/dostava za osoblje. To je proizvod odvojen od izdanja samo s telefonom. Instalirajte telefon i resurs prodavnice zajedno. Ne pokrećite dvije kopije phone niti dvije verzije PhoneHub mape.

1. Prije instalacije

• Napravite rezervnu kopiju postojećeg resursa telefona, resursa mape, konfiguracije i baze podataka.
• Koristite OneSync i GTA game build 2699 ili noviji.
• Prvo pokrenite bazu podataka, framework, inventar, voice resurs i screenshot-basic.
• Zadržite imena resursa tačno phone i zerodev_phonehub_mlo.
• Uklonite prethodne PhoneHub resurse iz aktivnog direktorija resursa i uklonite duple linije ensure. Rezervne kopije čuvajte izvan tog direktorija.
• Svaku drugu mapu koja zamjenjuje istu zgradu na Portola Drive držite isključenom.
• Potpuno zatvorite FiveM i zaustavite server prije zamjene fajlova mape. Pokrenite server, a zatim ponovo pokrenite FiveM. Odspojite klijente prije zamjene ili restartovanja ovog streamanog MLO-a. Povezani klijent može zadržati mapu čak i kad je daleko od zgrade; restartovanje u hodu može srušiti tog klijenta.

Ovaj paket ne uključuje licencni ključ servera, framework, inventar ni plaćene skripte trećih strana. Nakon obrade u Keymasteru, ključ servera mora pripadati računu koji ima pravo na ovaj novi kombinovani asset. Pravo na staro izdanje samo s telefonom ne daje ovo novo izdanje.

2. Kopirajte resurse

Kopirajte foldere phone i zerodev_phonehub_mlo iz ovog preuzimanja u direktorij resursa svog servera. Možete ih staviti u bilo koji folder kategorije; zadržite tačna imena foldera.

screenshot-basic. Kamera zahtijeva da screenshot-basic bude pokrenut prije phone; standardni resurs radi. Preuzimanje uključuje i lakšu kopiju (iscrtava sliku igre samo dok se pravi fotografija, s istim imenom, exportima i eventima). Prelazak na nju je opcionalan: stari folder čuvajte kao rezervnu kopiju izvan resources, testirajte skripte koje prave screenshotove i vratite stari folder ako se nešto promijeni. Brzi početak za Pulse Phone, korak 6, sadrži korake; izmijenjeni fajlovi navedeni su u screenshot-basic/ZERODEV-CHANGES.md.

Dodajte ove linije nakon postojećih zavisnosti u server.cfg:

ensure phone
ensure zerodev_phonehub_mlo

Ne kopirajte stari engine telefona ili UI u novi paket. Pri nadogradnji prenesite potrebne postavke u nove config fajlove. Zadržite bazu podataka, KVP skladište resursa i foldere media i ownermedia. Novi phone/config/phonehub_business.lua uključuje postavke dostave kojih nema u izdanju samo s telefonom.

Podešeni pult prodavnice je na -749.541, -216.952224, 36.256562, smjer 210. Lokacija prodavnice već je podešena u čistom integrisanom izdanju. PhoneHub je jedina prodavnica telefona u ovom izdanju: prodavnica na Legion Square iz paketa samo s telefonom nije dio njega. config.lua zadržan iz 1.4.4 ili ranije i dalje navodi Legion Square; taj unos se preskače, a konzola to javlja jednom. Pritisnite PhoneHub tipku (po zadanim postavkama E) ili koristite /phonehub kod kioska u prodavnici, stola za popravke, servisnog pulta ili kontrolne tačke na krovu da otvorite PhoneHub terminal. Kiosk otvara Shop, a sto za popravke otvara Repair. Tipka se može promijeniti u FiveM postavkama tipki. Komanda zahtijeva istu blizinu kao tipka; radnje osoblja i dalje zahtijevaju dozvolu servera.

3. Framework, inventar i ostale skripte

Počnite s Config.Framework = 'auto' i automatskim postavkama providera u phone/config/config.lua. Izvještaj o ispravnosti telefona pri pokretanju navodi stvarne providere koje je odabrao. Provjerite taj izvještaj prije kupovine.

Adapteri za inventar pokrivaju ox_inventory, podržane funkcije inventara frameworka i navedene providere trećih strana iz phone/guides/integrations.md (ili vodiča za integracije uključenog u vaš build telefona). Svaki provider treba svoje stvarne definicije predmeta i kompatibilnu verziju API-ja. Predmete koji nedostaju prijavljuju provjere ispravnosti telefona; ne potiskujte te greške. Primjeri postavljanja predmeta nalaze se u phone/config/items/.

Mostovi telefona koji se mogu uređivati pokrivaju voice, society račune, bankarstvo, garaže, stanovanje, dispatch i ostale integracije. Zadržite tačno jedan odabrani provider po funkciji. Preimenovane resurse fiksirajte kroz Config.ResourceNames; koristite Config.Providers da eksplicitno odaberete providera. Proizvoljni exporti trećih strana nisu automatski kompatibilni: implementirajte dokumentovani custom most kada vaša skripta nije na listi. Framework adapteri i automatizovani testovi ugovora ne znače da je svaka verzija trećih strana testirana uživo.

Kombinacija testirana uživo za ovo izdanje: ESX Legacy, ox_inventory, oxmysql i pma-voice. Na drugom frameworku pokrenite provjere pri prvom pokretanju iz odjeljka 7 prije otvaranja prodavnice.

4. Javna prodavnica ili firma u vlasništvu igrača

Pokrenite bilo koju komandu u konzoli servera:

phonehubmode public
phonehubmode business

Odabrani način rada ostaje sačuvan kroz restarte. Javni način zadržava običnu kupovinu. Poslovni način primjenjuje trajne zalihe i rezervacije na kupovine na PhoneHub pultu. Poslovni način isključuje zamjenu starog uređaja na pultu. Isto plaćanje u telefonu provjerava cijene, uplate i isporuku predmeta.

Postavite ime posla i činove u phone/config/phonehub_business.lua:

Dodjeljujte poslove običnim administratorskim alatima svog frameworka. Za upravljanje firmom otvorite Services → My Work → PhoneHub → Staff and account na telefonu. Koristi podržane funkcije za osoblje/society odabranog frameworka. Kombinovano izdanje podržava i trajno vlasništvo igrača kroz kupovinu u igri na kartici Business ili administratorsku komandu za dodjelu opisanu ispod. Sve cijene vlasništva su iznosi u valuti u igri.

Za ESX s esx_addonaccount uvezite i zerodev_phonehub_mlo/setup/phonehub_esx_society.sql prije pokretanja resursa za račune, a zatim restartujte server. To kreira račun firme society_phonehub s nultim stanjem bez zamjene postojećeg stanja. Ako ste preimenovali posao, uskladite sufiks računa. Ostali provideri bankarstva trebaju svoje uobičajeno postavljanje računa firme za podešeni posao. Provjerite malu uplatu i isplatu u Company prije otvaranja firme.

Operativni budžet je zasebna interna knjiga za nabavku robe. Prodaja ga povećava; narudžbe od dobavljača ga smanjuju. On nije automatski society bankovni račun niti gotovinsko stanje igrača koje se može podići.

5. Narudžbe od dobavljača i dostava robe

Na servisnom pultu pritisnite E da otvorite PhoneHub terminal, a zatim Stock. Odaberite proizvod, konfiguraciju i količinu. Server izračunava ponudu dobavljača i provjerava čin zaposlenog, blizinu i operativni budžet.

Zadana dostava traje 120 sekundi. Ostaje u transportu kroz restarte. Kad stigne, zaposleni na terminalu odabire Receive delivery. Zadana vrijednost destination='stock' dodaje robu u knjigu zaliha prodavnice koju troši naplata, nezavisno od providera inventara igrača kupca. Ponovljeni zahtjevi za preuzimanje ne mogu dodati istu pošiljku dvaput. Menadžeri mogu otkazati nepreuzetu pošiljku uz jedan povrat u budžet.

Konfiguracija:

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

Za custom skladište/stash postavite destination='custom' i navedite serverski export. On prima (shipment, source) i mora koristiti shipment.id kao trajni ključ za sprečavanje duplikata. Vratite true samo kada je svaka stavka uspješno pohranjena. Podesite mapiranje predmeta/SKU vašeg inventara u tom adapteru. Custom dostava ne dodaje predmete i u internu knjigu prodaje; eksplicitno povežite tok prodaje iz svog skladišta kako biste izbjegli duple zalihe. Ne pretpostavlja se nikakav univerzalni stash adapter.

Neizvjesna predaja vanjskom sistemu zadržava se na pregledu i nikad se ne ponavlja naslijepo. Nakon provjere odredišnog inventara koristite:

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

Za neizvjesnu rezervaciju pri naplati kupcu, pregledajte zapise o plaćanju i inventaru prije korištenja phonehubresolve <reservation-id> returned|delivered.

6. Upravljanje prodavnicom

Pritisnite E kod servisne kontrolne tačke ili kontrolnog postolja na krovu.

• Space: brave na ulaznim i krovnim vratima, svjetla u prodavnici, ekran u loungeu, nadstrešnica na terasi (automatska po kiši ili snijegu, ili otvorena/zatvorena), grijalice ili protok zraka na terasi, struja na terasi i test sprinklera od 15 sekundi.
• Cameras: Entrance overview, Showroom overview i Service counter. Back to the terminal zatvara kameru; Escape izlazi.
• Stock i Business: narudžbe od dobavljača, dostave, utržak, knjiga prodaje i popravki i pristup tima.

Upravljanje zgradom zahtijeva PhoneHub posao ili podešeni staff/admin ACE. Javni pristup kontrolama terase podešava se zasebno u systems_config.lua. phonehub.admin dodijelite samo svom pouzdanom administratorskom principalu; nikad svima. Postavite phoneResource='phone' u konfiguraciji sistema MLO-a.

Automatska vrata koriste senzore blizine kad su otključana. Njihova pokretna krila moraju ostati čvrsta, i dok su otvorena. Namještaj, staklo i osvjetljenje su izrađeni dijelovi mape; nema svaki ukrasni objekat interakciju u igri.

7. Prihvatna provjera pri prvom pokretanju

1. Pokrenite server i pokrenite phone:health. Potvrdite očekivane providere frameworka, inventara, baze podataka i voicea i da ne nedostaje nijedan obavezan predmet.
2. Uđite normalno i posjetite prodavnicu. Prošetajte od trotoara kroz oba para ulaznih vrata, gore/dolje stepenicama i kroz vrata na krov s isključenim noclipom.
3. Otvorite i zatvorite nadstrešnicu. Njenih osam panela mora ostati poravnato unutar vodilica u svakom položaju. Automatsko zatvaranje po kiši/snijegu testirajte zasebno.
4. Otvorite svaki CCTV prikaz, prebacujte se između njih i izađite. Scena mora biti vidljiva, a normalan pogled/fokus igrača mora se vratiti.
5. Zaključajte obje grupe vrata računom osoblja. Provjerite koliziju s obje strane. Otključajte i ponovo provjerite animaciju otvaranja na blizinu.
6. Provjerite dnevno/noćno osvjetljenje, ekran uključen/isključen, staklo, natpise, sjedišta i sve ivice. Hodajte i vozite prema zgradi i od nje da pregledate prijelaze pri streamanju.
7. Kupite telefon/dodatak u javnom načinu. U poslovnom načinu provjerite smanjenje zaliha, naručivanje zaposlenih, dolazak/preuzimanje, nedovoljna sredstva i neovlašten pristup.
8. Restartujte server i potvrdite da su način rada prodavnice, zalihe i dostave na čekanju sačuvani. Ponovite pokušaj duplog preuzimanja/otkazivanja; ne smije se pojaviti dupla roba ni povrat novca. Provjerite da više igrača vidi isto stanje prodavnice.

phonehubcheck u klijentskoj F8 konzoli prijavljuje stvarno poravnanje nadstrešnice; svaki panel treba prijaviti poravnanje blizu 1. To je dijagnostika, a ne dokaz da su vizuelni kvalitet ili kolizije ispravni. Automatizovane provjere ne mogu potvrditi svaki ugao kamere ni sve kombinacije servera.

8. Rješavanje problema i ažuriranja

Port 30120 zauzet: druga instanca servera već radi. Zaustavite je preko svog txAdmina (ili panela hostinga) umjesto da pokrećete drugi FXServer.

Kontrole nedostaju: provjerite da su oba resursa pokrenuta, da su im imena nepromijenjena i da je igrač kod kontrolne tačke. Pregledajte greške u klijentskom F8 i na serveru.

Nema pristupa za osoblje: provjerite podešeni posao, brojčani čin, blizinu servisnog pulta i odabrani job provider. Javni način prodavnice ne daje prava osoblja.

Stara mapa/stari interfejs ostaju: uklonite duple resurse/ensure unose. Potpuno zatvorite FiveM, zaustavite server, zamijenite fajlove, a zatim pokrenite server i ponovo pokrenite FiveM. Samo ponovno povezivanje može zadržati zastarjele streamane assete. Ne pokrećite ponovo MLO u hodu dok je klijent povezan, čak ni daleko od zgrade.

Vraćanje na staru verziju: zaustavite ove resurse, vratite rezervne kopije foldera resursa i konfiguracije, a zatim restartujte postojećim txAdminom. Sačuvajte bazu podataka/KVP skladište osim ako namjerno ne vraćate konzistentnu rezervnu kopiju podataka.

Sačuvajte isporučene hasheve izdanja (SHA256.json) za zahtjeve za podršku.

PhoneHub OS i vlasništvo

Config.PhoneHubOS u phone/config/phonehub_business.lua upravlja ovim izdanjem. ownership='both' dozvoljava kupovinu u igri i dodjelu od administratora. Postavite 'admin' ili 'purchase' da dozvolite samo jedan način. purchasePrice je iznos u valuti u igri. Administratori koriste phonehubowner <online player id> iz konzole servera ili uz ACE phonehub.admin. Dodjela je blokirana dok je plaćanje kupovine na čekanju. Vlasnik se pohranjuje uz identifikator lika iz frameworka, nikad uz privremeni broj igrača (source). Vlasništvo aktivira postojeći trajni sistem zaliha i operativnog budžeta.

Vlasnici dodaju obližnje osoblje ili menadžere na kartici Business. Ove nezavisne uloge rade preko mosta za identitet frameworka; ne mijenjaju glavni posao igrača. Postojeće uloge PhoneHub posla i podešeni administrativni pristup i dalje rade. Menadžeri po zadanim postavkama mogu naručivati robu, a osoblje može preuzimati pristigle pošiljke. Zalihe ostaju rezervisane dok se kupovina ili dostava od dobavljača ne potvrdi.

service='hybrid' dozvoljava i naplatu i popravke uz pomoć osoblja i samoposlužno. 'self' dozvoljava direktnu uslugu; 'staff' zahtijeva ponudu osoblja koju kupac odobri u ovoj prodavnici. Samostalni proizvod zadržava svoj postojeći OS za kupovinu.

Kod kioska u prodavnici priđite i pritisnite E. Kartica Shop učitava stvarni zaštićeni Pulse model, s rotacijom prevlačenjem, pregledom prednje/stražnje strane, zumom i odabranom završnom obradom. Cijena dolazi sa servera telefona. Plaćanje zahtijeva potvrdu i koristi podešeni inventar, novac i isporuku telefona u kutiji. Isteklo vrijeme nije dokaz neuspjele naplate; provjerite inventar i dnevnik plaćanja prije ponovnog pokušaja.

Kupci traže pomoć oko prodaje ili popravke na kartici Help i dobijaju broj u redu. Osoblje na kartici Counter odabire kupca u blizini i priprema ponudu; samo taj kupac može odobriti i platiti. Oboje moraju ostati u istoj prodavnici u istom routing bucketu. Odobrenje popravke vezano je za odabrani jedinstveni uređaj i njegovu navedenu cijenu. Promjena uređaja ga poništava.

Za popravke uz pomoć osoblja, tehničar otvara terminal na slobodnom stolu za popravke, priprema ponudu za popravku kupcu i ostaje tu do prihvatanja. Sto se rezerviše prije plaćanja. Uspješna plaćena popravka pokreće sekvencu sklapanja s tim igračem kao tehničarem; samoposluga koristi tehničara prodavnice. Engine telefona upravlja popravkom uređaja i vraća plaćeni posao nakon prekinute sesije servera. Klijentski propovi nikad ne kreiraju niti zamjenjuju telefon u inventaru.

Kartica Space, na kontrolnim tačkama na krovu i kod pulta, upravlja nadstrešnicom, klimom, bravama, osvjetljenjem i ekranom. Geometrija, zaštita od vremenskih uslova, podovi i sjedišta iz završenog MLO-a su zadržani.