PhoneHub + Pulse Phone — návod k instalaci

Tato edice spojuje Pulse Phone, budovu PhoneHub, vlastní PhoneHub OS, 3D kiosek s telefony, opravářské pracoviště a systém skladu a dodávek pro personál. Je to samostatný produkt, oddělený od edice jen s telefonem. Telefon a resource obchodu instalujte společně. Nespouštějte dvě kopie phone ani dvě verze mapy PhoneHub.

1. Před instalací

• Zálohujte stávající telefonní resource, resource mapy, konfiguraci a databázi.
• Použijte OneSync a game build GTA 2699 nebo novější.
• Nejdřív spusťte databázi, framework, inventář, voice resource a screenshot-basic.
• Názvy resources ponechte přesně phone a zerodev_phonehub_mlo.
• Odstraňte předchozí resources PhoneHub z aktivního adresáře resources a odstraňte duplicitní řádky ensure. Zálohy ukládejte mimo tento adresář.
• Jakoukoli jinou mapu, která nahrazuje stejnou budovu na Portola Drive, nechte vypnutou.
• Před výměnou souborů mapy úplně zavřete FiveM a zastavte server. Spusťte server, pak znovu spusťte FiveM. Před výměnou nebo restartem tohoto streamovaného MLO odpojte klienty. Připojený klient si může mapu ponechat, i když je od budovy daleko; restart za běhu může tohoto klienta shodit.

Tento balíček neobsahuje licenční klíč serveru, framework, inventář ani placené scripty třetích stran. Po zpracování v Keymasteru musí klíč serveru patřit účtu, který má oprávnění k tomuto novému kombinovanému assetu. Oprávnění ke staré edici jen s telefonem tuto novou edici nezahrnuje.

2. Zkopírujte resources

Zkopírujte složky phone a zerodev_phonehub_mlo z tohoto stažení do adresáře resources svého serveru. Můžete je dát do libovolné složky kategorie; názvy složek ponechte přesně.

screenshot-basic. Fotoaparát potřebuje, aby screenshot-basic startoval před phone; standardní resource funguje. Stažení obsahuje i odlehčenou kopii (obraz hry kreslí jen během pořizování fotky, se stejným názvem, exporty a eventy). Přechod na ni je volitelný: starou složku si nechte jako zálohu mimo resources, otestujte scripty, které pořizují snímky obrazovky, a pokud se cokoli změní, vraťte starou složku. Postup je v rychlém startu Pulse Phone, krok 6; změněné soubory jsou uvedené v screenshot-basic/ZERODEV-CHANGES.md.

Přidejte tyto řádky za své stávající závislosti v server.cfg:

ensure phone
ensure zerodev_phonehub_mlo

Nekopírujte do nového balíčku staré jádro telefonu ani UI. Při upgradu přeneste potřebná nastavení do nových konfiguračních souborů. Ponechte si databázi, KVP úložiště resource a složky media a ownermedia. Nový phone/config/phonehub_business.lua obsahuje nastavení dodávek, která edice jen s telefonem nemá.

Nastavený pult obchodu je na -749.541, -216.952224, 36.256562, heading 210. Umístění obchodu je v čisté integrované edici už nastavené. PhoneHub je v této edici jediný obchod s telefony: obchod na Legion Square z balíčku jen s telefonem jeho součástí není. config.lua ponechaný z 1.4.4 nebo starší stále uvádí Legion Square; tento záznam se přeskočí a konzole to jednou oznámí. Stiskněte klávesu PhoneHub (ve výchozím stavu E), nebo použijte /phonehub, u kiosku v prodejně, opravářského pracoviště, servisního pultu nebo ovládacího bodu na střeše a otevře se terminál PhoneHub. Kiosek otevře Shop a opravářské pracoviště Repair. Klávesu lze změnit v přiřazení kláves FiveM. Příkaz vyžaduje stejnou blízkost jako klávesa; akce personálu stále vyžadují oprávnění serveru.

3. Framework, inventář a další scripty

Začněte s Config.Framework = 'auto' a automatickým nastavením poskytovatelů v phone/config/config.lua. Report stavu telefonu při startu uvede poskytovatele, které skutečně zvolil. Než začnete nakupovat, ten report zkontrolujte.

Inventářové adaptéry pokrývají ox_inventory, podporované inventářové funkce frameworků a uvedené poskytovatele třetích stran v phone/guides/integrations.md (nebo v návodu k integracím přiloženém k vašemu buildu telefonu). Každý poskytovatel potřebuje své skutečné definice předmětů a kompatibilní verzi API. Chybějící předměty hlásí kontroly stavu telefonu; tyto chyby nepotlačujte. Příklady nastavení předmětů jsou v phone/config/items/.

Upravitelné bridge telefonu pokrývají voice, firemní účty, bankovnictví, garáže, bydlení, dispatch a další integrace. Pro každou funkci ponechte právě jednoho zvoleného poskytovatele. Přejmenované resources zafixujte přes Config.ResourceNames; přes Config.Providers zvolíte poskytovatele výslovně. Libovolné exporty třetích stran nejsou automaticky kompatibilní: když váš script v seznamu není, implementujte zdokumentovaný custom bridge. Adaptéry frameworků a automatizované testy kontraktů neznamenají, že byla živě otestována každá verze každého scriptu třetí strany.

Živě otestovaná sestava pro toto vydání: ESX Legacy, ox_inventory, oxmysql a pma-voice. Na jiném frameworku spusťte kontroly prvního spuštění ze sekce 7, než obchod otevřete.

4. Veřejný obchod nebo firma vlastněná hráči

V konzoli serveru spusťte jeden z příkazů:

phonehubmode public
phonehubmode business

Zvolený režim přetrvá i po restartech. Veřejný režim ponechá běžné nakupování. Firemní režim uplatní na nákupy u pultu PhoneHub trvalé zásoby a rezervace. Firemní režim vypíná výkup telefonů na pultu. Stejná pokladna telefonu ověřuje ceny, platby a předání předmětů.

Název jobu a hodnosti nastavte v phone/config/phonehub_business.lua:

Joby přidělujte běžnými administrátorskými nástroji svého frameworku. Pro správu firmy otevřete v telefonu Services → My Work → PhoneHub → Staff and account. Používá podporované funkce personálu/society zvoleného frameworku. Kombinovaná edice podporuje i trvalé vlastnictví hráčem přes nákup ve hře v záložce Business, nebo přes administrátorský příkaz pro přidělení popsaný níže. Všechny ceny vlastnictví jsou částky v herní měně.

Pro ESX s esx_addonaccount importujte navíc zerodev_phonehub_mlo/setup/phonehub_esx_society.sql před spuštěním resource účtů a pak restartujte server. Tím se vytvoří firemní účet society_phonehub s nulovým zůstatkem, aniž by se nahradil existující zůstatek. Pokud jste job přejmenovali, upravte odpovídajícím způsobem příponu účtu. Ostatní bankovní poskytovatelé potřebují pro nastavený job své běžné nastavení firemního účtu. Před otevřením firmy si v Company ověřte malý vklad a výběr.

Provozní rozpočet je samostatná interní evidence pro nákup zásob. Prodeje do něj přispívají; objednávky od dodavatele z něj odečítají. Nejde automaticky o society bankovní účet a není to hotovost hráče, kterou lze vybrat.

5. Objednávky od dodavatele a dodávky zboží

U servisního pultu stiskněte E, otevřete terminál PhoneHub a pak Stock. Vyberte produkt, konfiguraci a množství. Server spočítá cenu od dodavatele a ověří hodnost zaměstnance, jeho blízkost a provozní rozpočet.

Výchozí dodávka trvá 120 sekund. Zůstává na cestě i přes restarty. Po doručení zaměstnanec u terminálu zvolí Receive delivery. Výchozí destination='stock' přidá zboží do skladové evidence obchodu, ze které čerpá pokladna, nezávisle na poskytovateli inventáře kupujícího hráče. Opakované žádosti o převzetí nemohou stejnou zásilku přidat dvakrát. Manažeři mohou nepřevzatou zásilku zrušit a jednou ji vrátit do rozpočtu.

Konfigurace:

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

Pro vlastní sklad/stash nastavte destination='custom' a uveďte serverový export. Ten dostane (shipment, source) a musí použít shipment.id jako trvalý klíč proti duplicitám. Vrátí true, jen když je každá položka úspěšně uložená. Mapování předmětů/SKU vašeho inventáře nastavte v tomto adaptéru. Vlastní doručení nepřidává předměty zároveň do interní evidence prodejů; tok prodeje ze skladu propojte výslovně, abyste se vyhnuli duplicitním zásobám. Žádný univerzální adaptér pro stash se nepředpokládá.

Nejisté předání do externího systému se pozdrží ke kontrole, nikdy se naslepo neopakuje. Po kontrole cílového inventáře použijte:

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

U nejisté rezervace zákaznického nákupu zkontrolujte záznamy plateb a inventáře, než použijete phonehubresolve <reservation-id> returned|delivered.

6. Ovládání obchodu

Stiskněte E u servisního ovládacího bodu nebo u ovládacího podstavce na střeše.

• Space: zámky předních dveří a dveří na střechu, osvětlení obchodu, displej v lounge, markýza terasy (automaticky při dešti nebo sněhu, nebo otevřeno/zavřeno), topidla nebo proudění vzduchu na terase, napájení terasy a 15sekundový test sprinklerů.
• Cameras: Entrance overview, Showroom overview a Service counter. Návrat na terminál kameru zavře; Escape odejde.
• Stock a Business: objednávky od dodavatele, dodávky, tržby, evidence prodejů a oprav a přístup týmu.

Ovládání budovy vyžaduje job PhoneHub nebo nastavené ACE personálu/admina. Veřejný přístup k ovládání terasy se nastavuje zvlášť v systems_config.lua. phonehub.admin udělte jen svému důvěryhodnému administrátorskému principalu; nikdy všem. V konfiguraci systémů MLO nastavte phoneResource='phone'.

Automatické dveře v odemčeném stavu používají senzory přiblížení. Jejich pohyblivá křídla musí zůstat pevná, i když jsou otevřená. Nábytek, sklo a osvětlení jsou navržené assety mapy; ne každý dekorativní objekt má herní interakci.

7. Kontrola prvního spuštění

1. Spusťte server a spusťte phone:health. Ověřte očekávané poskytovatele frameworku, inventáře, databáze a voice a že nechybí žádné povinné předměty.
2. Připojte se normálně a navštivte obchod. Projděte z chodníku oběma páry vchodových dveří, nahoru/dolů po schodech a dveřmi na střechu s vypnutým noclipem.
3. Otevřete a zavřete markýzu. Jejích osm panelů musí v každé poloze zůstat zarovnaných ve vodicích kolejnicích. Automatické zavření při dešti/sněhu otestujte zvlášť.
4. Otevřete každý pohled CCTV, přepněte mezi nimi a odejděte. Scéna musí být vidět a musí se vrátit běžný pohled a focus hráče.
5. Zamkněte obě skupiny dveří účtem personálu. Zkontrolujte kolize z obou stran. Odemkněte a znovu ověřte animaci otevírání při přiblížení.
6. Zkontrolujte denní/noční osvětlení, zapnutí/vypnutí displeje, sklo, značení, sedadla a všechny hrany. Jděte a jeďte směrem k budově a od ní a prohlédněte přechody streamování.
7. Ve veřejném režimu kupte telefon/příslušenství. Ve firemním režimu ověřte ubývání zásob, objednávky zaměstnanců, doručení/převzetí, nedostatek peněz a neoprávněný přístup.
8. Restartujte server a ověřte, že režim obchodu, zásoby a čekající dodávky přetrvaly. Zopakujte duplicitní pokus o převzetí/zrušení; nesmí se objevit žádné duplicitní zboží ani vrácení peněz. Ověřte, že více hráčů vidí stejný stav obchodu.

phonehubcheck v klientské konzoli F8 hlásí skutečné zarovnání markýzy; každý panel by měl hlásit zarovnání blízké 1. Jde o diagnostiku, ne o důkaz, že vizuální kvalita nebo kolize jsou správné. Automatické kontroly nemohou zaručit každý úhel kamery ani všechny kombinace serverů.

8. Řešení problémů a aktualizace

Port 30120 je obsazený: už běží jiná instance serveru. Zastavte ji přes svůj txAdmin (nebo panel hostingu), místo abyste spouštěli druhý FXServer.

Chybí ovládání: ověřte, že oba resources nastartovaly, jejich názvy jsou beze změny a hráč stojí u ovládacího bodu. Prohlédněte chyby v klientském F8 a na serveru.

Žádný přístup pro personál: zkontrolujte nastavený job, číselnou hodnost, blízkost servisního pultu a zvoleného poskytovatele jobů. Veřejný režim obchodu práva personálu neuděluje.

Zůstává stará mapa/staré rozhraní: odstraňte duplicitní resources/záznamy ensure. Úplně zavřete FiveM, zastavte server, vyměňte soubory, pak spusťte server a znovu FiveM. Samotné znovupřipojení může ponechat zastaralé streamované assety. Nenačítejte MLO znovu za běhu, když je připojený klient, ani daleko od budovy.

Návrat zpět: zastavte tyto resources, obnovte zálohované složky resources a konfiguraci a pak restartujte přes svůj stávající txAdmin. Zachovejte úložiště databáze/KVP, pokud záměrně neobnovujete konzistentní zálohu dat.

Dodané hashe vydání (SHA256.json) si ponechte pro žádosti o podporu.

PhoneHub OS a vlastnictví

Config.PhoneHubOS v phone/config/phonehub_business.lua řídí tuto edici. ownership='both' povoluje nákup ve hře i přidělení administrátorem. Nastavte 'admin' nebo 'purchase', pokud chcete povolit jen jednu cestu. purchasePrice je částka v herní měně. Administrátoři používají phonehubowner <online player id> z konzole serveru nebo s ACE phonehub.admin. Přidělení je zablokované, dokud čeká platba za nákup. Majitel se ukládá podle identifikátoru postavy ve frameworku, nikdy podle dočasného čísla source hráče. Vlastnictví aktivuje stávající systém trvalých zásob a provozního rozpočtu.

Majitelé přidávají personál nebo manažery v blízkosti v záložce Business. Tyto nezávislé role fungují přes bridge identity frameworku; nemění hlavní job hráče. Stávající role jobu PhoneHub a nastavený administrátorský přístup fungují dál. Manažeři mohou objednávat zásoby a personál může ve výchozím stavu přebírat doručené zásilky. Zásoby zůstávají rezervované, dokud se nepotvrdí nákup nebo dodávka od dodavatele.

service='hybrid' povoluje asistovaný i samoobslužný nákup a opravy. 'self' povoluje přímou obsluhu; 'staff' vyžaduje v tomto obchodě nabídku personálu schválenou zákazníkem. Samostatný produkt si ponechává svůj stávající nákupní OS.

U kiosku v prodejně přistupte blíž a stiskněte E. Záložka Shop načte skutečný chráněný model Pulse s otáčením tažením, prohlídkou zepředu/zezadu, zoomem a zvolenou povrchovou úpravou. Cenu určuje server telefonu. Platba vyžaduje potvrzení a používá nastavený inventář, peníze a doručení telefonu v krabici. Vypršení časového limitu není důkaz neúspěšné platby; než to zkusíte znovu, zkontrolujte inventář a záznam plateb.

Zákazníci žádají o pomoc s nákupem nebo opravou v záložce Help a dostanou pořadové číslo. Personál vybere zákazníka v blízkosti v záložce Counter a připraví nabídku; schválit a zaplatit ji může jen ten zákazník. Oba musí zůstat ve stejném obchodě ve stejném routing bucketu. Schválení opravy je vázané na zvolené unikátní zařízení a jeho nabídnutou cenu. Změna zařízení ho zneplatní.

U asistovaných oprav technik otevře terminál u volného opravářského pracoviště, připraví zákazníkovi nabídku opravy a zůstane tam až do přijetí. Pracoviště se rezervuje před platbou. Úspěšná zaplacená oprava spustí sekvenci sestavení s tímto hráčem jako technikem; samoobsluha používá technika obchodu. Opravu zařízení řídí jádro telefonu a zaplacenou práci obnoví i po přerušené relaci serveru. Klientské propy nikdy nevytvářejí ani nenahrazují telefon v inventáři.

Záložka Space na ovládacích bodech na střeše a u pultu ovládá markýzu, klima, zámky, osvětlení a displej. Geometrie, ochrana před počasím, podlahy a sezení z hotového MLO zůstávají zachovány.