PhoneHub + Pulse Phone — installationsguide

Den här utgåvan kombinerar Pulse Phone, PhoneHub-byggnaden, det egna PhoneHub OS, 3D-kiosken för telefoner, reparationsbänken och personalens system för lager och leveranser. Det är en separat produkt från utgåvan med bara telefonen. Installera telefonen och butiksresursen tillsammans. Kör inte två kopior av phone eller två versioner av PhoneHub-mappen.

1. Före installationen

• Säkerhetskopiera din befintliga telefonresurs, map-resurs, konfiguration och databas.
• Använd OneSync och GTA game build 2699 eller nyare.
• Starta din databas, ditt framework, inventory, röstresurs och screenshot-basic först.
• Behåll resursnamnen exakt phone och zerodev_phonehub_mlo.
• Ta bort tidigare PhoneHub-resurser från den aktiva resurskatalogen och ta bort dubbla rader ensure. Spara säkerhetskopior utanför den katalogen.
• Håll alla andra maps som ersätter samma byggnad på Portola Drive avstängda.
• Stäng FiveM helt och stoppa servern innan du ersätter map-filer. Starta servern, och starta sedan FiveM igen. Koppla från klienter innan du ersätter eller startar om den här streamade MLO:n. En ansluten klient kan behålla mappen även när den är borta från byggnaden; att starta om den i farten kan krascha den klienten.

Det här paketet innehåller ingen serverlicensnyckel, inget framework, inventory eller betalda tredjepartsscripts. Efter Keymaster-hanteringen måste servernyckeln tillhöra det konto som har behörighet till den här nya kombinerade asseten. En behörighet till den gamla utgåvan med bara telefonen ger inte den här nya utgåvan.

2. Kopiera resurserna

Kopiera mapparna phone och zerodev_phonehub_mlo från den här nedladdningen till din servers resurskatalog. Du kan lägga dem i vilken kategorimapp som helst; behåll mappnamnen exakt.

screenshot-basic. Kameran kräver att screenshot-basic startas före phone; standardresursen fungerar. Nedladdningen innehåller också en lättare kopia (den ritar spelbilden bara medan ett foto tas, med samma namn, exports och events). Att byta till den är valfritt: behåll din gamla mapp som säkerhetskopia utanför resources, testa de scripts som tar skärmbilder, och lägg tillbaka den gamla mappen om något ändras. Snabbstarten för Pulse Phone, steg 6, har stegen; de ändrade filerna listas i screenshot-basic/ZERODEV-CHANGES.md.

Lägg till dessa rader efter dina befintliga beroenden i server.cfg:

ensure phone
ensure zerodev_phonehub_mlo

Kopiera inte in en gammal telefonmotor eller ett gammalt gränssnitt i det nya paketet. Vid en uppgradering, flytta över de inställningar du behöver till de nya konfigurationsfilerna. Behåll din databas, resursens KVP-lagring, mapparna media och ownermedia. Den nya phone/config/phonehub_business.lua innehåller leveransinställningar som saknas i utgåvan med bara telefonen.

Den konfigurerade butiksdisken är -749.541, -216.952224, 36.256562, riktning 210. Butikens plats är redan konfigurerad i den rena integrerade utgåvan. PhoneHub är den enda mobilbutiken i den här utgåvan: butiken på Legion Square från paketet med bara telefonen ingår inte. En config.lua som behållits från 1.4.4 eller tidigare listar fortfarande Legion Square; den posten hoppas över och konsolen säger det en gång. Tryck på PhoneHub-tangenten (E som standard), eller använd /phonehub, vid kiosken på golvet, en reparationsbänk, servicedisken eller kontrollpunkten på taket för att öppna PhoneHub-terminalen. Kiosken öppnar Shop och en reparationsbänk öppnar Repair. Tangenten kan ändras i FiveM:s tangentbindningar. Kommandot kräver samma närhet som tangenten; personalåtgärder kräver fortfarande behörighet från servern.

3. Framework, inventory och andra scripts

Börja med Config.Framework = 'auto' och de automatiska provider-inställningarna i phone/config/config.lua. Telefonens hälsorapport vid start visar vilka providers den faktiskt valde. Kontrollera den rapporten innan du gör köp.

Inventory-adaptrarna täcker ox_inventory, frameworkens inventory-funktioner som stöds, och de namngivna tredjepartsproviders som listas i phone/guides/integrations.md (eller integrationsguiden som följer med din telefonbuild). Varje provider behöver sina riktiga item-definitioner och en kompatibel API-version. Saknade items rapporteras av telefonens hälsokontroller; dölj inte de felen. Exempel på item-inställning följer med under phone/config/items/.

Telefonens redigerbara bryggor täcker röst, society-konton, bank, garage, housing, dispatch och andra integrationer. Behåll exakt en vald provider per funktion. Lås omdöpta resurser via Config.ResourceNames; använd Config.Providers för att uttryckligen välja en provider. Godtyckliga tredjeparts-exports är inte automatiskt kompatibla: implementera den dokumenterade custom-bryggan när ditt script inte finns med i listan. Framework-adaptrar och automatiska kontraktstester är inget påstående om att varje tredjepartsversion har testats live.

Live-testad stack för den här versionen: ESX Legacy, ox_inventory, oxmysql och pma-voice. På ett annat framework, kör kontrollerna för första starten i avsnitt 7 innan du öppnar butiken.

4. Öppen butik eller spelarägt företag

Kör något av kommandona i serverkonsolen:

phonehubmode public
phonehubmode business

Det valda läget finns kvar genom omstarter. Öppet läge behåller vanlig shopping. Företagsläget tillämpar beständigt lager och reservationer på köp vid PhoneHub-disken. Företagsläget stänger av inbyten vid disken. Samma kassa i telefonen validerar priser, betalningar och leverans av items.

Sätt jobbnamn och grader i phone/config/phonehub_business.lua:

Tilldela jobb med ditt frameworks vanliga administrationsverktyg. Öppna Services → My Work → PhoneHub → Staff and account på telefonen för företagshantering. Den använder det valda frameworkets personal-/society-funktioner som stöds. Den kombinerade utgåvan stöder också beständigt spelarägande via ett köp i spelet under fliken Business eller administratörens tilldelningskommando som beskrivs nedan. Alla priser för ägande är belopp i spelets valuta.

För ESX med esx_addonaccount, importera också zerodev_phonehub_mlo/setup/phonehub_esx_society.sql innan du startar kontoresursen, och starta sedan om din server. Det skapar företagskontot society_phonehub med saldo noll utan att ersätta ett befintligt saldo. Om du döpte om jobbet, uppdatera kontots suffix så att det matchar. Andra bankleverantörer behöver sin vanliga uppsättning av företagskonto för det konfigurerade jobbet. Verifiera en liten insättning och ett litet uttag i Company innan du öppnar företaget.

Driftsbudgeten är en separat intern liggare för lagerinköp. Försäljning läggs till den; leverantörsbeställningar dras från den. Den är inte automatiskt ett society-bankkonto och är inget kontantsaldo som spelare kan ta ut.

5. Leverantörsbeställningar och leverans till lager

Vid servicedisken, tryck E för att öppna PhoneHub-terminalen, sedan Stock. Välj en produkt, konfiguration och antal. Servern räknar ut leverantörens offert och kontrollerar den anställdas grad, närhet och driftsbudget.

Standardleveransen tar 120 sekunder. Den förblir under transport genom omstarter. När den har kommit väljer en anställd Receive delivery vid terminalen. Standardvärdet destination='stock' lägger varorna i butikens lagerliggare som används av kassan, oberoende av köparens inventory-provider. Upprepade mottagningsförfrågningar kan inte lägga till samma leverans två gånger. Chefer kan avboka en leverans som inte tagits emot för en enda återbetalning till budgeten.

Konfiguration:

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

För ett eget lager/stash, sätt destination='custom' och ange en server-export. Den tar emot (shipment, source) och måste använda shipment.id som beständig nyckel mot dubbletter. Returnera true bara när varje rad har sparats. Konfigurera ditt inventorys mappning av item/SKU i den adaptern. Egen leverans lägger inte också till items i den interna försäljningsliggaren; koppla ditt lagers försäljningsflöde uttryckligen för att undvika dubbelt lager. Ingen universell stash-adapter förutsätts.

En osäker extern överlämning hålls kvar för granskning, och försöks aldrig igen i blindo. Efter att du kontrollerat mottagarens inventory, använd:

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

För en osäker reservation i kundens kassa, granska betalnings- och inventory-posterna innan du använder phonehubresolve <reservation-id> returned|delivered.

6. Butiksstyrning

Tryck E nära servicekontrollpunkten eller kontrollpelaren på taket.

• Space: lås för huvuddörren och takdörren, butiksbelysning, loungens skärm, terrassens tak (automatiskt vid regn eller snö, eller öppet/stängt), terrassvärmare eller luftflöde, ström på terrassen och ett sprinklertest på 15 sekunder.
• Cameras: Entrance overview, Showroom overview och Service counter. Tillbaka till terminalen stänger kameran; Escape avslutar.
• Stock och Business: leverantörsbeställningar, leveranser, intäkter, liggaren för försäljning och reparationer, och teamets åtkomst.

Byggnadsstyrningen kräver PhoneHub-jobbet eller den konfigurerade personal-/admin-ACE:n. Allmänhetens åtkomst till terrassstyrningen konfigureras separat i systems_config.lua. Ge phonehub.admin bara till din betrodda administratörs-principal; aldrig till alla. Sätt phoneResource='phone' i MLO:ns systemkonfiguration.

Automatiska dörrar använder närhetssensorer när de är upplåsta. Deras rörliga dörrblad måste förbli solida, även när de är öppna. Möbler, glas och belysning är skapade map-assets; inte varje dekorativt objekt har en interaktion i spelet.

7. Godkännande vid första starten

1. Starta servern och kör phone:health. Bekräfta förväntade providers för framework, inventory, databas och röst, och att inga obligatoriska items saknas.
2. Gå in som vanligt och besök butiken. Gå från trottoaren genom båda entrédörrparen, upp/ner för trapporna och genom takdörren med noclip avstängt.
3. Öppna och stäng taket. Dess åtta paneler måste hålla sig i linje inom styrskenorna i varje läge. Testa automatisk stängning vid regn/snö separat.
4. Öppna varje CCTV-vy, växla mellan dem och avsluta. Scenen måste synas och spelarens normala vy/fokus måste komma tillbaka.
5. Lås båda dörrgrupperna med ett personalkonto. Kontrollera kollisionen från båda sidor. Lås upp och verifiera öppningsanimationen vid närhet igen.
6. Kontrollera belysningen dag/natt, skärmen på/av, glas, skyltar, sittplatser och alla kanter. Gå och kör mot/från byggnaden för att granska övergångarna i streamingen.
7. Köp en telefon/ett tillbehör i öppet läge. I företagsläget, kontrollera att lagret minskar, beställning av anställda, ankomst/mottagning, otillräckliga medel och obehörig åtkomst.
8. Starta om servern och bekräfta att butiksläget, lagret och väntande leveranser finns kvar. Upprepa ett försök till dubbel mottagning/avbokning; inga dubbla varor eller återbetalningar ska dyka upp. Verifiera att flera spelare ser samma butiksstatus.

phonehubcheck i klientens F8-konsol rapporterar takets faktiska inriktning; varje panel bör rapportera en inriktning nära 1. Det är en diagnos, inte ett bevis på att den visuella kvaliteten eller kollisionerna är korrekta. Automatiska kontroller kan inte intyga varje kameravinkel eller alla serverkombinationer.

8. Felsökning och uppdateringar

Port 30120 upptagen: en annan serverinstans körs redan. Stoppa den via din txAdmin (eller hostens panel) i stället för att starta en andra FXServer.

Kontroller saknas: verifiera att båda resurserna har startat, att deras namn är oförändrade, och att spelaren är vid kontrollpunkten. Granska klientens F8 och serverns fel.

Ingen personalåtkomst: kontrollera det konfigurerade jobbet, den numeriska graden, närheten till servicedisken och vald job provider. Öppet butiksläge ger inga personalrättigheter.

Gammal map/gammalt gränssnitt finns kvar: ta bort dubbla resurser/ensure-poster. Stäng FiveM helt, stoppa servern, ersätt filerna, starta sedan servern och starta FiveM igen. Bara en återanslutning kan behålla gamla streamade assets. Ladda inte om MLO:n i farten medan en klient är ansluten, inte ens långt från byggnaden.

Återställning: stoppa dessa resurser, återställ de säkerhetskopierade resursmapparna och konfigurationen, och starta sedan om med din befintliga txAdmin. Behåll databasen/KVP-lagringen om du inte medvetet återställer en konsekvent datasäkerhetskopia.

Spara de medföljande release-hashvärdena (SHA256.json) för supportärenden.

PhoneHub OS och ägande

Config.PhoneHubOS i phone/config/phonehub_business.lua styr den här utgåvan. ownership='both' tillåter köp i spelet och tilldelning av administratör. Sätt 'admin' eller 'purchase' för att bara tillåta ett av sätten. purchasePrice är ett belopp i spelets valuta. Administratörer använder phonehubowner <online player id> från serverkonsolen eller med ACE-behörigheten phonehub.admin. Tilldelning blockeras medan en köpbetalning väntar. En ägare sparas mot frameworkets karaktärsidentifierare, aldrig ett tillfälligt source-nummer för spelaren. Ägande aktiverar det befintliga beständiga systemet för lager och driftsbudget.

Ägare lägger till personal eller chefer i närheten under fliken Business. Dessa fristående roller fungerar via frameworkets identitetsbrygga; de ändrar inte en spelares huvudjobb. Befintliga jobbroller för PhoneHub och konfigurerad administrativ åtkomst fungerar fortfarande. Chefer kan beställa varor, och personal kan ta emot ankomna leveranser som standard. Lagret förblir reserverat tills ett köp eller en leverantörsleverans har bekräftats.

service='hybrid' tillåter både assisterad kassa och självbetjäning, samt reparationer. 'self' tillåter direkt service; 'staff' kräver ett erbjudande från personalen som kunden godkänner i den här butiken. Den fristående produkten behåller sitt befintliga shopping-OS.

Gå fram till kiosken på golvet och tryck E. Fliken Shop laddar den faktiska skyddade Pulse-modellen, med rotation genom att dra, granskning fram/bak, zoom och vald finish. Priset kommer från telefonservern. Betalningen kräver bekräftelse och använder det konfigurerade inventoryt, pengarna och leveransen av telefon i kartong. En timeout är inget bevis på en misslyckad debitering; kontrollera inventoryt och betalningsjournalen innan du försöker igen.

Kunder ber om hjälp med köp eller reparation under fliken Help och får en könummer. Personalen väljer en kund i närheten under fliken Counter och förbereder ett erbjudande; bara den kunden kan godkänna och betala. Båda måste stanna i samma butik i samma routing bucket. Godkännandet av en reparation är bundet till den valda unika enheten och dess offererade pris. Att byta enhet gör det ogiltigt.

Vid assisterade reparationer öppnar teknikern terminalen vid en ledig reparationsbänk, förbereder kundens reparationserbjudande och stannar kvar där tills det accepteras. Bänken reserveras före betalning. En lyckad betald reparation kör monteringssekvensen med den spelaren som tekniker; självbetjäning använder butikens tekniker. Telefonmotorn äger reparationen av enheten och återställer betalt arbete efter en avbruten serversession. Klientens props skapar eller ersätter aldrig en telefon i inventoryt.

Fliken Space, vid kontrollpunkterna på taket och vid disken, styr taket, klimat, lås, belysning och skärm. Geometri, väderskydd, golv och sittplatser från den färdiga MLO:n behålls.