PhoneHub + Pulse Phone — installatiegids

Deze editie combineert Pulse Phone, het PhoneHub-gebouw, het eigen PhoneHub OS, de 3D-kiosk voor toestellen, de reparatiewerkbank en het systeem voor voorraad en leveringen door personeel. Het is een ander product dan de editie met alleen de telefoon. Installeer de telefoon en de winkelresource samen. Draai geen twee exemplaren van phone of twee versies van de PhoneHub-map.

1. Vóór de installatie

• Maak een back-up van je bestaande telefoonresource, mapresource, configuratie en database.
• Gebruik OneSync en GTA game build 2699 of nieuwer.
• Start eerst je database, framework, inventory, voice-resource en screenshot-basic.
• Houd de resourcenamen precies phone en zerodev_phonehub_mlo.
• Haal eerdere PhoneHub-resources uit de map met actieve resources en verwijder dubbele ensure-regels. Bewaar back-ups buiten die map.
• Houd elke andere map die hetzelfde pand aan Portola Drive vervangt uitgeschakeld.
• Sluit FiveM volledig af en stop de server voordat je mapbestanden vervangt. Start de server en start daarna FiveM opnieuw. Verbreek de verbinding van clients voordat je deze gestreamde MLO vervangt of herstart. Een verbonden client kan de map vasthouden, ook als hij niet bij het gebouw is; hem live herstarten kan die client laten crashen.

Dit pakket bevat geen serverlicentiesleutel, framework, inventory of betaalde scripts van derden. Na de verwerking door Keymaster moet de serversleutel horen bij het account dat recht heeft op deze nieuwe gecombineerde asset. Een recht op de oude editie met alleen de telefoon geeft geen recht op deze nieuwe editie.

2. Kopieer de resources

Kopieer de mappen phone en zerodev_phonehub_mlo uit deze download naar de resourcemap van je server. Je mag ze in elke categoriemap zetten; houd de mapnamen precies zoals ze zijn.

screenshot-basic. De camera heeft screenshot-basic nodig, gestart vóór phone; de standaard resource werkt. De download bevat ook een lichtere versie (die tekent het spelbeeld alleen terwijl er een foto wordt gemaakt, met dezelfde naam, exports en events). Overstappen is optioneel: bewaar je oude map als back-up buiten resources, test de scripts die screenshots maken, en zet de oude map terug als er iets verandert. Stap 6 van de snelstart van Pulse Phone heeft de stappen; de gewijzigde bestanden staan in screenshot-basic/ZERODEV-CHANGES.md.

Voeg deze regels toe na je bestaande dependencies in server.cfg:

ensure phone
ensure zerodev_phonehub_mlo

Kopieer geen oude telefoonengine of UI naar het nieuwe pakket. Zet bij een upgrade de instellingen die je nodig hebt over naar de nieuwe configbestanden. Behoud je database, de KVP-opslag van de resource en de mappen media en ownermedia. De nieuwe phone/config/phonehub_business.lua bevat leveringsinstellingen die de editie met alleen de telefoon niet heeft.

De ingestelde winkelbalie staat op -749.541, -216.952224, 36.256562, richting 210. De winkellocatie is in de schone geïntegreerde editie al ingesteld. PhoneHub is de enige telefoonwinkel in deze editie: de winkel op Legion Square uit het pakket met alleen de telefoon hoort er niet bij. Een config.lua uit 1.4.4 of eerder noemt Legion Square nog; die entry wordt overgeslagen en de console meldt dat één keer. Druk op de PhoneHub-toets (standaard E), of gebruik /phonehub, bij de kiosk op de winkelvloer, een reparatiewerkbank, de servicebalie of het bedieningspunt op het dak om de PhoneHub-terminal te openen. De kiosk opent Shop en een reparatiewerkbank opent Repair. De toets kun je aanpassen in de toetsbindingen van FiveM. Het commando vereist dezelfde nabijheid als de toets; acties van personeel vereisen nog steeds toestemming van de server.

3. Framework, inventory en andere scripts

Begin met Config.Framework = 'auto' en de automatische providerinstellingen in phone/config/config.lua. Het health-rapport van de telefoon bij het opstarten noemt de providers die hij echt gekozen heeft. Controleer dat rapport voordat je aankopen doet.

Inventory-adapters dekken ox_inventory, ondersteunde inventoryfuncties van frameworks, en de genoemde providers van derden in phone/guides/integrations.md (of de integratiegids bij je telefoonbuild). Elke provider heeft zijn echte itemdefinities en een compatibele API-versie nodig. Ontbrekende items worden gemeld door de health checks van de telefoon; onderdruk die fouten niet. Voorbeelden voor de itemsetup zitten in phone/config/items/.

De aanpasbare bridges van de telefoon dekken voice, society-rekeningen, bankieren, garages, housing, dispatch en andere integraties. Houd precies één gekozen provider per functie. Leg hernoemde resources vast via Config.ResourceNames; gebruik Config.Providers om een provider expliciet te kiezen. Willekeurige exports van derden zijn niet automatisch compatibel: implementeer de gedocumenteerde custom bridge als je script niet in de lijst staat. Framework-adapters en geautomatiseerde contracttests betekenen niet dat elke versie van derden live getest is.

Live geteste stack voor deze release: ESX Legacy, ox_inventory, oxmysql en pma-voice. Draai op een ander framework de controles voor de eerste start in sectie 7 voordat je de winkel opent.

4. Openbare winkel of bedrijf in handen van spelers

Draai een van beide commando's in de serverconsole:

phonehubmode public
phonehubmode business

De gekozen modus blijft behouden na herstarts. De openbare modus houdt het gewone winkelen aan. De bedrijfsmodus past blijvende voorraad en reserveringen toe op aankopen aan de PhoneHub-balie. De bedrijfsmodus zet inruilen aan de balie uit. Dezelfde checkout van de telefoon valideert prijzen, betalingen en de levering van items.

Stel de jobnaam en rangen in in phone/config/phonehub_business.lua:

Wijs jobs toe met de normale beheertools van je framework. Open op de telefoon Services → My Work → PhoneHub → Staff and account voor bedrijfsbeheer. Het gebruikt de ondersteunde personeels-/society-functies van het gekozen framework. De gecombineerde editie ondersteunt ook blijvend eigendom door spelers via een aankoop in game in het tabblad Business of via het admincommando voor toewijzing dat hieronder beschreven staat. Alle eigendomsprijzen zijn bedragen in de valuta van de game.

Voor ESX met esx_addonaccount importeer je ook zerodev_phonehub_mlo/setup/phonehub_esx_society.sql voordat je de account-resource start, en herstart je daarna je server. Dit maakt de bedrijfsrekening society_phonehub met een saldo van nul aan, zonder een bestaand saldo te vervangen. Heb je de job hernoemd, pas dan het achtervoegsel van de rekening aan. Andere bankproviders hebben hun normale setup voor bedrijfsrekeningen nodig voor de ingestelde job. Controleer een kleine storting en opname in Company voordat je het bedrijf opent.

Het werkbudget is een apart intern grootboek voor voorraadinkoop. Verkopen vullen het aan; bestellingen bij leveranciers worden ervan afgetrokken. Het is niet automatisch een society-bankrekening en geen contant saldo dat een speler kan opnemen.

5. Bestellingen bij leveranciers en levering van voorraad

Druk aan de servicebalie op E om de PhoneHub-terminal te openen, en daarna op Stock. Kies een product, configuratie en aantal. De server berekent de offerte van de leverancier en controleert de rang van de medewerker, de nabijheid en het werkbudget.

Een levering duurt standaard 120 seconden. Ze blijft onderweg na herstarts. Na aankomst kiest een medewerker Receive delivery bij de terminal. De standaard destination='stock' voegt goederen toe aan het voorraadboek van de winkel dat de checkout gebruikt, los van de inventory-provider van de koper. Herhaalde ontvangstverzoeken kunnen dezelfde zending niet twee keer toevoegen. Managers kunnen een niet-ontvangen zending annuleren voor één terugbetaling op het budget.

Configuratie:

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

Voor een eigen magazijn/stash stel je destination='custom' in en geef je een server-export op. Die ontvangt (shipment, source) en moet shipment.id gebruiken als blijvende sleutel tegen duplicaten. Geef alleen true terug als elke regel succesvol is opgeslagen. Stel de item/SKU-koppeling van je inventory in die adapter in. Een custom levering voegt geen items toe aan het interne verkoopgrootboek; koppel de verkoopflow van je magazijn expliciet om dubbele voorraad te voorkomen. Er wordt geen universele stash-adapter verondersteld.

Een onzekere externe overdracht wordt vastgehouden voor controle, nooit blind opnieuw geprobeerd. Gebruik na het controleren van de bestemmingsinventory:

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

Bij een onzekere checkoutreservering van een klant controleer je de betalings- en inventorygegevens voordat je phonehubresolve <reservation-id> returned|delivered gebruikt.

6. Winkelbediening

Druk op E bij het servicebedieningspunt of de bedieningszuil op het dak.

• Space: sloten van de voordeur en de dakdeur, winkelverlichting, het scherm in de lounge, de overkapping van het terras (automatisch bij regen of sneeuw, of open/dicht), terrasverwarming of ventilatie, stroom op het terras en een sprinklertest van 15 seconden.
• Cameras: Entrance overview, Showroom overview en Service counter. Terug naar de terminal sluit de camera; Escape verlaat het scherm.
• Stock en Business: bestellingen bij leveranciers, leveringen, omzet, het grootboek voor verkopen en reparaties, en teamtoegang.

Gebouwbediening vereist de PhoneHub-job of de ingestelde staff-/admin-ACE. Openbare toegang tot de terrasbediening stel je apart in in systems_config.lua. Geef phonehub.admin alleen aan je vertrouwde administrator-principal; nooit aan iedereen. Stel phoneResource='phone' in in de systeemconfiguratie van de MLO.

Automatische deuren gebruiken nabijheidssensoren als ze ontgrendeld zijn. De bewegende deurvleugels moeten solide blijven, ook als ze open staan. Meubels, glas en verlichting zijn gemaakte map-assets; niet elk decoratief object heeft een interactie in de gameplay.

7. Acceptatie bij de eerste start

1. Start de server en draai phone:health. Bevestig de verwachte providers voor framework, inventory, database en voice, en dat er geen vereiste items ontbreken.
2. Join gewoon en ga naar de winkel. Loop vanaf de stoep door beide ingangsparen, de trap op en af en door de deuropening op het dak, met noclip uit.
3. Open en sluit de overkapping. De acht panelen moeten in elke positie uitgelijnd blijven binnen de geleiderails. Test het automatisch sluiten bij regen/sneeuw apart.
4. Open elk CCTV-beeld, wissel ertussen en sluit af. Het beeld moet zichtbaar zijn en het normale zicht en de focus van de speler moeten terugkomen.
5. Vergrendel beide deurgroepen met een personeelsaccount. Controleer de collision van beide kanten. Ontgrendel en controleer de openingsanimatie bij nadering opnieuw.
6. Controleer de verlichting bij dag en nacht, het scherm aan/uit, glas, bewegwijzering, stoelen en alle randen. Loop en rij naar het gebouw toe en ervan weg om de streamingovergangen te controleren.
7. Koop een telefoon/accessoire in de openbare modus. Controleer in de bedrijfsmodus de voorraadafname, het bestellen door medewerkers, aankomst/ontvangst, onvoldoende saldo en toegang zonder bevoegdheid.
8. Herstart de server en bevestig dat de winkelmodus, de voorraad en openstaande leveringen behouden blijven. Herhaal een dubbele poging tot ontvangst/annulering; er mogen geen dubbele goederen of terugbetalingen verschijnen. Controleer dat meerdere spelers dezelfde winkelstatus zien.

phonehubcheck in de F8-console van de client meldt de werkelijke uitlijning van de overkapping; elk paneel zou een uitlijning dicht bij 1 moeten melden. Het is een diagnose, geen bewijs dat de visuele kwaliteit of collisions kloppen. Geautomatiseerde controles kunnen niet elke camerahoek of alle servercombinaties certificeren.

8. Troubleshooting en updates

Poort 30120 bezet: er draait al een andere serverinstantie. Stop die via je txAdmin (of hostpaneel) in plaats van een tweede FXServer te starten.

Bediening ontbreekt: controleer of beide resources gestart zijn, hun namen ongewijzigd zijn en de speler bij het bedieningspunt staat. Bekijk de fouten in F8 van de client en op de server.

Geen toegang voor personeel: controleer de ingestelde job, de numerieke rang, de nabijheid van de servicebalie en de gekozen job-provider. De openbare winkelmodus geeft geen personeelsrechten.

Oude map/oude interface blijft hangen: verwijder dubbele resources/ensure-regels. Sluit FiveM volledig af, stop de server, vervang de bestanden, start daarna de server en start FiveM opnieuw. Alleen opnieuw verbinden kan verouderde gestreamde assets vasthouden. Herlaad de MLO niet live terwijl er een client verbonden is, zelfs niet ver van het gebouw.

Terugdraaien: stop deze resources, zet de geback-upte resourcemappen en configuratie terug, en herstart daarna met je bestaande txAdmin. Behoud de database/KVP-opslag, tenzij je bewust een consistente databack-up terugzet.

Bewaar de meegeleverde release-hashes (SHA256.json) voor supportverzoeken.

PhoneHub OS en eigendom

Config.PhoneHubOS in phone/config/phonehub_business.lua bepaalt deze editie. ownership='both' staat aankoop in game en toewijzing door een administrator toe. Stel 'admin' of 'purchase' in om maar één route toe te staan. purchasePrice is een bedrag in de valuta van de game. Administrators gebruiken phonehubowner <online player id> vanuit de serverconsole of met de ACE phonehub.admin. Toewijzen is geblokkeerd zolang er een aankoopbetaling openstaat. Een eigenaar wordt opgeslagen op de character-identifier van het framework, nooit op een tijdelijk source-nummer van een speler. Eigendom activeert het bestaande blijvende systeem voor voorraad en werkbudget.

Eigenaren voegen personeel of managers in de buurt toe in het tabblad Business. Deze losse rollen werken via de identity-bridge van het framework; ze veranderen de hoofdjob van een speler niet. Bestaande PhoneHub-jobrollen en ingestelde beheertoegang werken nog steeds. Managers kunnen standaard voorraad bestellen, en personeel kan aangekomen zendingen ontvangen. Voorraad blijft gereserveerd tot een aankoop of levering van een leverancier bevestigd is.

service='hybrid' staat zowel begeleid afrekenen en repareren als zelfbediening toe. 'self' staat directe service toe; 'staff' vereist bij deze winkel een aanbod van personeel dat de klant goedkeurt. Het losse product houdt zijn bestaande shopping-OS.

Loop naar de kiosk op de winkelvloer en druk op E. Het tabblad Shop laadt het echte beveiligde Pulse-model, met draaien door te slepen, voor-/achterkant bekijken, zoomen en de gekozen afwerking. De prijs komt van de telefoonserver. Betalen vereist een bevestiging en gebruikt de ingestelde inventory, het geld en de levering van de telefoon in een doos. Een time-out is geen bewijs van een mislukte afschrijving; controleer de inventory en het betalingsjournaal voordat je het opnieuw probeert.

Klanten vragen om hulp bij verkoop of reparatie in het tabblad Help en krijgen een wachtnummer. Personeel kiest in het tabblad Counter een klant in de buurt en stelt een aanbod op; alleen die klant kan goedkeuren en betalen. Beiden moeten bij dezelfde winkel in dezelfde routing bucket blijven. Een reparatiegoedkeuring is gekoppeld aan het gekozen unieke apparaat en de geoffreerde prijs. Een ander apparaat kiezen maakt hem ongeldig.

Bij begeleide reparaties opent de technicus de terminal bij een vrije reparatiewerkbank, stelt hij het reparatieaanbod voor de klant op en blijft hij daar tot het geaccepteerd is. De werkbank wordt gereserveerd vóór de betaling. Een geslaagde betaalde reparatie speelt de montagereeks af met die speler als technicus; bij zelfbediening is het de technicus van de winkel. De telefoonengine is verantwoordelijk voor de reparatie van het apparaat en herstelt betaald werk na een onderbroken serversessie. De props op de client maken nooit een inventorytelefoon aan en vervangen er ook nooit een.

Het tabblad Space, bij de bedieningspunten op het dak en aan de balie, bedient de overkapping, het klimaat, de sloten, verlichting en het scherm. Geometrie, weerbescherming, vloeren en zitplaatsen van de voltooide MLO blijven behouden.