PhoneHub + Pulse Phone — installationsguide

Denne udgave samler Pulse Phone, PhoneHub-bygningen, det særlige PhoneHub OS, 3D-telefonkiosken, reparationsbænken og personalets lager-/leveringssystem. Det er et separat produkt fra udgaven med kun telefonen. Installer telefonen og butiksressourcen sammen. Kør ikke to kopier af phone eller to versioner af PhoneHub-mappet.

1. Før installationen

• Tag backup af din eksisterende telefonressource, map-ressource, konfiguration og database.
• Brug OneSync og GTA game build 2699 eller nyere.
• Start din database, dit framework, dit inventory, din voice-ressource og screenshot-basic først.
• Behold ressourcenavnene præcis som phone og zerodev_phonehub_mlo.
• Fjern tidligere PhoneHub-ressourcer fra den aktive resources-mappe, og fjern dublerede ensure-linjer. Gem backups uden for den mappe.
• Hold ethvert andet map, der erstatter den samme bygning på Portola Drive, slået fra.
• Luk FiveM helt, og stop serveren, før du erstatter map-filer. Start serveren, og start derefter FiveM igen. Afbryd klienter, før du erstatter eller genstarter denne streamede MLO. En forbundet klient kan beholde mappet, selv når den er væk fra bygningen; en hot-restart kan få den klient til at crashe.

Denne pakke indeholder ikke en serverlicensnøgle, et framework, et inventory eller betalte tredjepartsscripts. Efter Keymaster-behandlingen skal servernøglen tilhøre den konto, der har entitlement til dette nye kombinerede asset. En entitlement til den gamle udgave med kun telefonen giver ikke denne nye udgave.

2. Kopiér ressourcerne

Kopiér mapperne phone og zerodev_phonehub_mlo fra denne download ind i din servers resources-mappe. Du kan lægge dem i en hvilken som helst kategorimappe; behold mappenavnene præcis.

screenshot-basic. Kameraet kræver, at screenshot-basic er startet før phone; standardressourcen virker. Downloaden indeholder også en lettere kopi (den tegner kun spilbilledet, mens et billede tages, med samme navn, exports og events). Det er valgfrit at skifte til den: behold din gamle mappe som backup uden for resources, test de scripts, der tager skærmbilleder, og læg den gamle mappe tilbage, hvis noget ændrer sig. Pulse Phones kvikstart, trin 6, har trinene; de ændrede filer står i screenshot-basic/ZERODEV-CHANGES.md.

Tilføj disse linjer efter dine eksisterende afhængigheder i server.cfg:

ensure phone
ensure zerodev_phonehub_mlo

Kopiér ikke en gammel telefonmotor eller et gammelt UI ind i den nye pakke. Ved en opgradering skal du flytte de indstillinger, du har brug for, over i de nye konfigurationsfiler. Behold din database, ressourcens KVP-lager og media- og ownermedia-mapperne. Den nye phone/config/phonehub_business.lua indeholder leveringsindstillinger, som udgaven med kun telefonen ikke har.

Den konfigurerede butiksdisk er -749.541, -216.952224, 36.256562, heading 210. Butikkens placering er allerede konfigureret i den rene integrerede udgave. PhoneHub er den eneste telefonbutik i denne udgave: butikken på Legion Square fra pakken med kun telefonen er ikke en del af den. En config.lua, der er beholdt fra 1.4.4 eller tidligere, nævner stadig Legion Square; den indgang springes over, og konsollen siger det én gang. Tryk på PhoneHub-tasten (E som standard), eller brug /phonehub, ved kiosken på gulvet, en reparationsbænk, servicedisken eller kontrolpunktet på taget for at åbne PhoneHub-terminalen. Kiosken åbner Shop, og en reparationsbænk åbner Repair. Tasten kan ændres i FiveM's tastbindinger. Kommandoen kræver samme nærhed som tasten; personalehandlinger kræver stadig serverens tilladelse.

3. Framework, inventory og andre scripts

Start med Config.Framework = 'auto' og de automatiske provider-indstillinger i phone/config/config.lua. Telefonens sundhedsrapport ved opstart viser de providers, den faktisk har valgt. Tjek den rapport, før der foretages køb.

Inventory-adapterne dækker ox_inventory, understøttede inventory-funktioner i frameworks og de navngivne tredjeparts-providers, der står i phone/guides/integrations.md (eller integrationsguiden, der følger med dit telefonbuild). Hver provider skal have sine rigtige item-definitioner og en kompatibel API-version. Manglende items rapporteres af telefonens sundhedstjek; undertryk ikke de fejl. Eksempler på item-opsætning følger med under phone/config/items/.

Telefonens redigerbare bridges dækker voice, society-konti, bank, garager, housing, dispatch og andre integrationer. Behold præcis én valgt provider pr. funktion. Fastlås omdøbte ressourcer via Config.ResourceNames; brug Config.Providers til at vælge en provider eksplicit. Vilkårlige tredjeparts-exports er ikke automatisk kompatible: implementér den dokumenterede custom bridge, når dit script ikke er på listen. Framework-adaptere og automatiske kontrakttests er ikke en påstand om, at alle tredjepartsversioner er testet live.

Live-testet opsætning for denne udgivelse: ESX Legacy, ox_inventory, oxmysql og pma-voice. På et andet framework skal du køre tjekkene ved første kørsel i afsnit 7, før du åbner butikken.

4. Offentlig butik eller spillerejet forretning

Kør en af kommandoerne i serverkonsollen:

phonehubmode public
phonehubmode business

Den valgte tilstand bevares gennem genstarter. Offentlig tilstand beholder almindelig shopping. Forretningstilstand anvender vedvarende lager og reservationer på køb foretaget ved PhoneHub-disken. Forretningstilstand slår indbytning ved disken fra. Den samme betaling på telefonen validerer priser, betalinger og levering af items.

Sæt jobnavnet og graderne i phone/config/phonehub_business.lua:

Tildel jobs med dit frameworks normale administrationsværktøjer. Åbn Services → My Work → PhoneHub → Staff and account på telefonen for firmastyring. Den bruger det valgte frameworks understøttede personale-/society-funktioner. Den kombinerede udgave understøtter også varigt spillerejerskab via et køb i spillet på Business-fanen eller via administratorens tildelingskommando, der er beskrevet nedenfor. Alle ejerskabspriser er beløb i spillets valuta.

Til ESX med esx_addonaccount skal du også importere zerodev_phonehub_mlo/setup/phonehub_esx_society.sql, før du starter konto-ressourcen, og derefter genstarte din server. Det opretter firmakontoen society_phonehub med saldo nul uden at erstatte en eksisterende saldo. Hvis du har omdøbt jobbet, så opdater kontoens suffiks, så det passer. Andre bank-providers kræver deres normale opsætning af firmakonti for det konfigurerede job. Bekræft en lille indbetaling og hævning i Company, før du åbner forretningen.

Driftsbudgettet er et separat internt regnskab til indkøb af varer. Salg lægges til det; leverandørordrer trækkes fra det. Det er ikke automatisk en society-bankkonto og er ikke en kontantsaldo, som spillere kan hæve.

5. Leverandørordrer og levering af varer

Ved servicedisken skal du trykke E for at åbne PhoneHub-terminalen og derefter Stock. Vælg et produkt, en konfiguration og et antal. Serveren beregner leverandørens tilbud og tjekker medarbejderens grad, nærhed og driftsbudget.

Standardleveringen tager 120 sekunder. Den forbliver undervejs gennem genstarter. Når den er ankommet, vælger en medarbejder Receive delivery ved terminalen. Standarden destination='stock' lægger varerne i butikkens lagerregnskab, som betalingen trækker fra, uafhængigt af køberens inventory-provider. Gentagne anmodninger om modtagelse kan ikke tilføje den samme forsendelse to gange. Managere kan annullere en forsendelse, der ikke er modtaget, for én enkelt refusion til budgettet.

Konfiguration:

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

Til et custom lager/stash skal du sætte destination='custom' og angive en server-export. Den modtager (shipment, source) og skal bruge shipment.id som en varig nøgle mod dubletter. Returnér kun true, når hver linje er gemt korrekt. Konfigurér dit inventorys item/SKU-mapping i den adapter. Custom-levering tilføjer ikke også items til det interne salgsregnskab; forbind dit lagers salgsflow eksplicit for at undgå dobbelt lager. Der antages ingen universel stash-adapter.

En usikker ekstern overdragelse holdes tilbage til gennemgang og prøves aldrig blindt igen. Når du har tjekket destinationens inventory, så brug:

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

Ved en usikker reservation fra en kundes betaling skal du gennemgå betalings- og inventory-registreringerne, før du bruger phonehubresolve <reservation-id> returned|delivered.

6. Butiksstyring

Tryk E ved servicekontrolpunktet eller kontrolsøjlen på taget.

• Space: låse på hoveddøren og tagdøren, butikslys, loungens skærm, terrassens overdækning (automatisk i regn eller sne, eller åben/lukket), terrassevarmere eller luftstrøm, strøm på terrassen og en sprinklertest på 15 sekunder.
• Cameras: Entrance overview, Showroom overview og Service counter. Tilbage til terminalen lukker kameraet; Escape afslutter.
• Stock og Business: leverandørordrer, leveringer, omsætning, regnskabet for salg og reparationer og teamets adgang.

Bygningsstyring kræver PhoneHub-jobbet eller den konfigurerede personale-/admin-ACE. Offentlig adgang til terrassens styring konfigureres separat i systems_config.lua. Giv kun phonehub.admin til din betroede administrator-principal; aldrig til alle. Sæt phoneResource='phone' i MLO'ens systemkonfiguration.

Automatiske døre bruger nærhedssensorer, når de er låst op. Deres bevægelige fløje skal forblive solide, også mens de er åbne. Møbler, glas og belysning er færdige map-assets; ikke alle dekorative objekter har en interaktion i spillet.

7. Godkendelse ved første kørsel

1. Start serveren, og kør phone:health. Bekræft de forventede providers for framework, inventory, database og voice, og at der ikke mangler påkrævede items.
2. Join normalt, og besøg butikken. Gå fra fortovet gennem begge indgangspar, op og ned ad trapperne og gennem døråbningen på taget med noclip slået fra.
3. Åbn og luk overdækningen. Dens otte paneler skal forblive på linje i styreskinnerne i alle positioner. Test den automatiske lukning ved regn/sne separat.
4. Åbn hver CCTV-visning, skift mellem dem, og gå ud. Scenen skal være synlig, og spillerens normale visning/fokus skal komme tilbage.
5. Lås begge dørgrupper med en personalekonto. Tjek kollision fra begge sider. Lås op, og bekræft nærhedsanimationen for åbning igen.
6. Tjek belysning dag og nat, skærm til/fra, glas, skilte, sæder og alle kanter. Gå og kør hen mod og væk fra bygningen for at se overgangene i streaming.
7. Køb en telefon/et tilbehør i offentlig tilstand. I forretningstilstand skal du tjekke nedtælling af lager, medarbejderbestilling, ankomst/modtagelse, utilstrækkelige midler og uautoriseret adgang.
8. Genstart serveren, og bekræft, at butikstilstand, lager og afventende leveringer bevares. Gentag et forsøg på dobbelt modtagelse/annullering; der må ikke dukke dublerede varer eller refusioner op. Bekræft, at flere spillere ser den samme butikstilstand.

phonehubcheck i klientens F8-konsol rapporterer overdækningens faktiske justering; hvert panel bør rapportere en justering tæt på 1. Det er et diagnoseværktøj, ikke et bevis på, at den visuelle kvalitet eller kollisionerne er korrekte. Automatiske tjek kan ikke garantere alle kameravinkler eller alle serverkombinationer.

8. Fejlfinding og opdateringer

Port 30120 optaget: en anden serverinstans kører allerede. Stop den via din txAdmin (eller hostens panel) i stedet for at starte en ekstra FXServer.

Styring mangler: bekræft, at begge ressourcer er startet, at deres navne er uændrede, og at spilleren er ved kontrolpunktet. Undersøg fejlene i klientens F8 og på serveren.

Ingen personaleadgang: tjek det konfigurerede job, den numeriske grad, nærheden til servicedisken og den valgte job-provider. Offentlig butikstilstand giver ikke personalerettigheder.

Gammelt map/gammelt interface bliver ved: fjern dublerede ressourcer/ensure-linjer. Luk FiveM helt, stop serveren, erstat filerne, og start derefter serveren og FiveM igen. En genforbindelse alene kan beholde forældede streamede assets. Hot-reload ikke MLO'en, mens en klient er forbundet, heller ikke langt fra bygningen.

Rulle tilbage: stop disse ressourcer, gendan de backede ressourcemapper og konfigurationen, og genstart derefter med din eksisterende txAdmin. Bevar database/KVP-lager, medmindre du bevidst gendanner en konsistent databackup.

Behold de medfølgende release-hashes (SHA256.json) til supporthenvendelser.

PhoneHub OS og ejerskab

Config.PhoneHubOS i phone/config/phonehub_business.lua styrer denne udgave. ownership='both' tillader køb i spillet og tildeling af en administrator. Sæt 'admin' eller 'purchase' for kun at tillade én vej. purchasePrice er et beløb i spillets valuta. Administratorer bruger phonehubowner <online player id> fra serverkonsollen eller med ACE'en phonehub.admin. Tildeling er blokeret, mens en købsbetaling afventer. En ejer gemmes på frameworkets karakter-identifier, aldrig på et midlertidigt source-nummer for spilleren. Ejerskab aktiverer det eksisterende varige system til lager og driftsbudget.

Ejere tilføjer personale eller managere i nærheden på Business-fanen. Disse uafhængige roller virker via frameworkets identitets-bridge; de ændrer ikke en spillers hovedjob. Eksisterende PhoneHub-jobroller og konfigureret administrativ adgang virker stadig. Managere kan bestille varer, og personalet kan som standard modtage ankomne forsendelser. Lageret forbliver reserveret, indtil et køb eller en leverandørlevering er bekræftet.

service='hybrid' tillader både betjent betaling og selvbetjening samt reparationer. 'self' tillader direkte betjening; 'staff' kræver et tilbud fra personalet, som kunden har godkendt, i denne butik. Standalone-produktet beholder sit eksisterende shopping-OS.

Gå hen til kiosken på gulvet, og tryk E. Shop-fanen indlæser den faktiske beskyttede Pulse-model, med rotation ved træk, inspektion af for- og bagside, zoom og den valgte finish. Prisen kommer fra telefonens server. Betaling kræver bekræftelse og bruger det konfigurerede inventory, penge og levering af telefonen i æske. En timeout er ikke bevis på en fejlet betaling; tjek inventory og betalingsjournalen, før du prøver igen.

Kunder beder om hjælp til salg eller reparation på Help-fanen og får et kønummer. Personalet vælger en kunde i nærheden på Counter-fanen og forbereder et tilbud; kun den kunde kan godkende og betale. Begge skal blive i den samme butik i den samme routing bucket. Godkendelse af en reparation er bundet til den valgte unikke enhed og den tilbudte pris. Skift af enhed ugyldiggør den.

Ved betjente reparationer åbner teknikeren terminalen ved en ledig reparationsbænk, forbereder kundens reparationstilbud og bliver der, indtil det accepteres. Bænken reserveres før betaling. En gennemført betalt reparation kører samlesekvensen med den spiller som tekniker; selvbetjening bruger butikkens tekniker. Telefonmotoren står for reparationen af enheden og genopretter betalt arbejde efter en afbrudt serversession. Klientens props opretter eller erstatter aldrig en telefon i inventory.

Space-fanen, ved kontrolpunkterne på taget og ved disken, styrer overdækningen, klima, låse, belysning og skærm. Geometri, vejrbeskyttelse, gulve og siddepladser fra den færdige MLO bevares.