PhoneHub + Pulse Phone — installasjonsguide

Denne utgaven kombinerer Pulse Phone, PhoneHub-bygget, det egne PhoneHub OS, 3D-kiosken for telefoner, reparasjonsbenken og lager-/leveransesystemet for ansatte. Det er et separat produkt fra utgaven med bare telefonen. Installer telefonen og butikkressursen sammen. Ikke kjør to kopier av phone eller to versjoner av PhoneHub-mapen.

1. Før installasjon

• Ta backup av den eksisterende telefonressursen, map-ressursen, konfigurasjonen og databasen.
• Bruk OneSync og GTA game build 2699 eller nyere.
• Start databasen, frameworket, inventoryet, voice-ressursen og screenshot-basic først.
• Behold ressursnavnene nøyaktig phone og zerodev_phonehub_mlo.
• Fjern tidligere PhoneHub-ressurser fra den aktive resources-mappen og fjern dupliserte ensure-linjer. Lagre backuper utenfor den mappen.
• Hold enhver annen map som erstatter det samme bygget på Portola Drive deaktivert.
• Lukk FiveM helt og stopp serveren før du erstatter map-filer. Start serveren, og start så FiveM igjen. Koble fra klienter før du erstatter eller starter denne streamede MLO-en på nytt. En tilkoblet klient kan beholde mapen selv når den er langt unna bygget; en hot-restart kan krasje den klienten.

Denne pakken inkluderer ikke serverlisensnøkkel, framework, inventory eller betalte tredjepartsscripts. Etter behandling i Keymaster må servernøkkelen tilhøre kontoen som har rettighet til denne nye kombinerte asseten. En rettighet til den gamle utgaven med bare telefonen gir ikke denne nye utgaven.

2. Kopier ressursene

Kopier mappene phone og zerodev_phonehub_mlo fra denne nedlastingen til serverens resources-mappe. Du kan legge dem i en hvilken som helst kategorimappe; behold mappenavnene nøyaktig.

screenshot-basic. Kameraet trenger at screenshot-basic er startet før phone; standardressursen fungerer. Nedlastingen inkluderer også en lettere kopi (den tegner spillbildet bare mens et bilde tas, med samme navn, exports og events). Å bytte til den er valgfritt: behold den gamle mappen som backup utenfor resources, test scriptene som tar skjermbilder, og legg den gamle mappen tilbake hvis noe endrer seg. Hurtigstarten for Pulse Phone, steg 6, har stegene; de endrede filene er listet i screenshot-basic/ZERODEV-CHANGES.md.

Legg til disse linjene etter de eksisterende avhengighetene dine i server.cfg:

ensure phone
ensure zerodev_phonehub_mlo

Ikke kopier en gammel telefonmotor eller et gammelt UI inn i den nye pakken. Ved oppgradering flytter du innstillingene du trenger over i de nye config-filene. Behold databasen, ressursens KVP-lagring, media- og ownermedia-mappene. Den nye phone/config/phonehub_business.lua inkluderer leveringsinnstillinger som ikke finnes i utgaven med bare telefonen.

Den konfigurerte butikkdisken er -749.541, -216.952224, 36.256562, retning 210. Butikkens plassering er allerede konfigurert i den rene integrerte utgaven. PhoneHub er den eneste telefonbutikken i denne utgaven: butikken ved Legion Square fra pakken med bare telefonen er ikke en del av den. En config.lua beholdt fra 1.4.4 eller tidligere lister fortsatt Legion Square; den oppføringen hoppes over, og konsollen sier fra om det én gang. Trykk PhoneHub-tasten (E som standard), eller bruk /phonehub, ved gulvkiosken, en reparasjonsbenk, servicedisken eller kontrollpunktet på taket for å åpne PhoneHub-terminalen. Kiosken åpner Shop, og en reparasjonsbenk åpner Repair. Tasten kan endres i tastebindingene i FiveM. Kommandoen krever samme nærhet som tasten; handlinger for ansatte krever fortsatt tillatelse på serveren.

3. Framework, inventory og andre scripts

Start med Config.Framework = 'auto' og de automatiske leverandørinnstillingene i phone/config/config.lua. Telefonens helserapport ved oppstart viser hvilke leverandører den faktisk valgte. Sjekk den rapporten før kjøp gjøres.

Inventory-adapterne dekker ox_inventory, støttede inventory-funksjoner i frameworks, og de navngitte tredjepartsleverandørene listet i phone/guides/integrations.md (eller integrasjonsguiden som følger med telefon-builden din). Hver leverandør trenger sine ekte item-definisjoner og en kompatibel API-versjon. Manglende items rapporteres av telefonens helsesjekker; ikke skjul de feilene. Eksempler på item-oppsett følger med under phone/config/items/.

Telefonens redigerbare bridges dekker voice, society-kontoer, bank, garasjer, housing, dispatch og andre integrasjoner. Hold nøyaktig én valgt leverandør per funksjon. Fest omdøpte ressurser via Config.ResourceNames; bruk Config.Providers for å velge en leverandør eksplisitt. Vilkårlige tredjeparts-exports er ikke automatisk kompatible: implementer den dokumenterte custom-bridgen når scriptet ditt ikke er listet. Framework-adaptere og automatiserte kontrakttester betyr ikke at hver tredjepartsversjon er testet live.

Live-testet oppsett for denne versjonen: ESX Legacy, ox_inventory, oxmysql og pma-voice. På et annet framework, kjør sjekkene for første oppstart i del 7 før du åpner butikken.

4. Offentlig butikk eller spillereid bedrift

Kjør en av kommandoene i serverkonsollen:

phonehubmode public
phonehubmode business

Den valgte modusen beholdes gjennom omstarter. Offentlig modus beholder vanlig handel. Bedriftsmodus bruker varig lager og reservasjoner for kjøp gjort ved PhoneHub-disken. Bedriftsmodus deaktiverer innbytte ved disken. Den samme telefonkassen validerer priser, betalinger og levering av items.

Sett jobbnavnet og gradene i phone/config/phonehub_business.lua:

Tildel jobber med frameworkets vanlige administrasjonsverktøy. Åpne Services → My Work → PhoneHub → Staff and account på telefonen for bedriftsstyring. Det bruker de støttede ansatt-/society-funksjonene i det valgte frameworket. Den kombinerte utgaven støtter også varig spillereierskap via et kjøp i spillet i Business-fanen eller via administratorkommandoen for tildeling beskrevet nedenfor. Alle eierskapspriser er beløp i spillvaluta.

For ESX med esx_addonaccount, importer også zerodev_phonehub_mlo/setup/phonehub_esx_society.sql før du starter kontoressursen, og start så serveren på nytt. Dette oppretter bedriftskontoen society_phonehub med null i saldo uten å erstatte en eksisterende saldo. Har du gitt jobben nytt navn, oppdater kontosuffikset tilsvarende. Andre bankleverandører trenger sitt vanlige oppsett av bedriftskonto for den konfigurerte jobben. Verifiser et lite innskudd og uttak i Company før du åpner bedriften.

Driftsbudsjettet er en separat intern hovedbok for innkjøp av varer. Salg legger til i den; leverandørordrer trekker fra den. Det er ikke automatisk en society-bankkonto og er ikke en kontantsaldo spillere kan ta ut.

5. Leverandørordrer og varelevering

Ved servicedisken, trykk E for å åpne PhoneHub-terminalen, og deretter Stock. Velg et produkt, en konfigurasjon og et antall. Serveren beregner leverandørtilbudet og sjekker den ansattes grad, nærhet og driftsbudsjett.

Standard levering tar 120 sekunder. Den forblir underveis gjennom omstarter. Etter at den har kommet, velger en ansatt Receive delivery ved terminalen. Standardverdien destination='stock' legger varene til i butikkens lagerbok som kassen bruker, uavhengig av kjøperens inventory-leverandør. Gjentatte mottaksforespørsler kan ikke legge til samme sending to ganger. Ledere kan kansellere en sending som ikke er mottatt for én refusjon til budsjettet.

Konfigurasjon:

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

For et eget lager/stash, sett destination='custom' og angi en server-export. Den mottar (shipment, source) og må bruke shipment.id som en varig nøkkel mot duplikater. Returner true bare når hver linje er lagret. Konfigurer inventoryets item/SKU-kobling i den adapteren. Custom-levering legger ikke også items til i den interne salgsboken; koble salgsflyten for lageret ditt eksplisitt for å unngå duplisert lager. Ingen universell stash-adapter forutsettes.

En usikker ekstern overlevering holdes tilbake for gjennomgang, og prøves aldri på nytt i blinde. Etter at du har sjekket mottakerinventoryet, bruk:

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

For en usikker reservasjon i kundekassen, undersøk betalings- og inventory-oppføringene før du bruker phonehubresolve <reservation-id> returned|delivered.

6. Butikkstyring

Trykk E nær servicekontrollpunktet eller kontrollsøylen på taket.

• Space: låser på inngangsdøren og takdøren, butikklys, loungeskjermen, terrassetaket (automatisk ved regn eller snø, eller åpent/lukket), terassevarmere eller luftstrøm, strøm på terrassen og en 15-sekunders sprinklertest.
• Cameras: Entrance overview, Showroom overview og Service counter. Back to the terminal lukker kameraet; Escape avslutter.
• Stock og Business: leverandørordrer, leveranser, inntekter, salgs- og reparasjonsboken, og tilgang for teamet.

Byggstyring krever PhoneHub-jobben eller den konfigurerte ansatt-/admin-ACE-en. Offentlig tilgang til terrassestyringen konfigureres separat i systems_config.lua. Gi phonehub.admin bare til din betrodde administrator-principal; aldri til alle. Sett phoneResource='phone' i systemkonfigurasjonen til MLO-en.

Automatiske dører bruker nærhetssensorer når de er ulåst. Dørbladene i bevegelse må forbli solide, også mens de er åpne. Møbler, glass og belysning er laget som map-filer; ikke alle dekorative objekter har en interaksjon i spillet.

7. Godkjenning ved første oppstart

1. Start serveren og kjør phone:health. Bekreft forventet framework, inventory, database og voice-leverandører, og at ingen påkrevde items mangler.
2. Koble til som vanlig og besøk butikken. Gå fra fortauet gjennom begge inngangsparene, opp/ned trappene og gjennom døråpningen på taket med noclip deaktivert.
3. Åpne og lukk taket. De åtte panelene må holde seg på linje i føringsskinnene i hver posisjon. Test automatisk lukking ved regn/snø separat.
4. Åpne hver CCTV-visning, bytt mellom dem og avslutt. Scenen må være synlig, og vanlig spillervisning/fokus må komme tilbake.
5. Lås begge dørgruppene med en ansattkonto. Sjekk kollisjon fra begge sider. Lås opp og verifiser åpningsanimasjonen ved nærhet igjen.
6. Sjekk belysning dag/natt, skjerm av/på, glass, skilting, seter og alle kanter. Gå og kjør mot/fra bygget for å se på overgangene i streamingen.
7. Kjøp en telefon/et tilbehør i offentlig modus. I bedriftsmodus, sjekk lagernedtrekk, bestilling av ansatte, ankomst/mottak, utilstrekkelige midler og uautorisert tilgang.
8. Start serveren på nytt og bekreft at butikkmodus, lager og ventende leveranser blir beholdt. Gjenta et forsøk på duplisert mottak/kansellering; ingen dupliserte varer eller refusjoner skal dukke opp. Verifiser at flere spillere ser samme butikktilstand.

phonehubcheck i F8-konsollen på klienten rapporterer faktisk innretting av taket; hvert panel bør rapportere innretting nær 1. Det er en diagnose, ikke bevis på at visuell kvalitet eller kollisjoner er riktige. Automatiserte sjekker kan ikke sertifisere hver kameravinkel eller alle serverkombinasjoner.

8. Feilsøking og oppdateringer

Port 30120 opptatt: en annen serverinstans kjører allerede. Stopp den via txAdmin (eller hostpanelet) i stedet for å starte en ekstra FXServer.

Kontroller mangler: verifiser at begge ressursene startet, at navnene er uendret, og at spilleren står ved kontrollpunktet. Se på F8 på klienten og feil på serveren.

Ingen tilgang for ansatte: sjekk den konfigurerte jobben, numerisk grad, nærhet til servicedisken og valgt jobbleverandør. Offentlig butikkmodus gir ikke ansattrettigheter.

Gammel map/gammelt grensesnitt henger igjen: fjern dupliserte ressurser/ensure-oppføringer. Lukk FiveM helt, stopp serveren, erstatt filene, start så serveren og start FiveM igjen. En ny tilkobling alene kan beholde utdaterte streamede filer. Ikke hot-reload MLO-en mens en klient er tilkoblet, selv langt fra bygget.

Tilbakerulling: stopp disse ressursene, gjenopprett ressursmappene og konfigurasjonen du tok backup av, og start så på nytt med din eksisterende txAdmin. Behold database-/KVP-lagringen med mindre du bevisst gjenoppretter en konsistent databackup.

Ta vare på de medfølgende release-hashene (SHA256.json) til supporthenvendelser.

PhoneHub OS og eierskap

Config.PhoneHubOS i phone/config/phonehub_business.lua styrer denne utgaven. ownership='both' tillater kjøp i spillet og tildeling fra administrator. Sett 'admin' eller 'purchase' for å tillate bare én vei. purchasePrice er et beløp i spillvaluta. Administratorer bruker phonehubowner <online player id> fra serverkonsollen eller med phonehub.admin-ACE-en. Tildeling er blokkert mens en kjøpsbetaling venter. En eier lagres mot frameworkets karakter-identifier, aldri et midlertidig source-nummer for spilleren. Eierskap aktiverer det eksisterende varige lager- og driftsbudsjettsystemet.

Eiere legger til ansatte eller ledere i nærheten i Business-fanen. Disse uavhengige rollene fungerer via frameworkets identitets-bridge; de endrer ikke spillerens hovedjobb. Eksisterende PhoneHub-jobbroller og konfigurert administrativ tilgang fungerer fortsatt. Ledere kan bestille varer, og ansatte kan motta ankomne sendinger som standard. Lageret forblir reservert til et kjøp eller en leverandørlevering er bekreftet.

service='hybrid' tillater både betjent og selvbetjent kasse og reparasjoner. 'self' tillater direkte service; 'staff' krever et tilbud fra en ansatt som kunden godkjenner i denne butikken. Det frittstående produktet beholder sitt eksisterende handle-OS.

Gå bort til gulvkiosken og trykk E. Shop-fanen laster den faktiske beskyttede Pulse-modellen, med rotasjon ved å dra, inspeksjon foran/bak, zoom og valgt utførelse. Prisen kommer fra telefonserveren. Betaling krever bekreftelse og bruker det konfigurerte inventoryet, penger og levering av telefon i eske. En timeout er ikke bevis på en feilet belastning; sjekk inventoryet og betalingsjournalen før du prøver igjen.

Kunder ber om hjelp med salg eller reparasjon i Help-fanen og får et kønummer. Ansatte velger en kunde i nærheten i Counter-fanen og lager et tilbud; bare den kunden kan godkjenne og betale. Begge må bli værende i samme butikk i samme routing bucket. Godkjenning av reparasjon er bundet til den valgte unike enheten og den oppgitte prisen. Bytte av enhet gjør den ugyldig.

For betjente reparasjoner åpner teknikeren terminalen ved en ledig reparasjonsbenk, lager kundens reparasjonstilbud og blir værende der til det godtas. Benken reserveres før betaling. En vellykket betalt reparasjon kjører monteringssekvensen med den spilleren som tekniker; selvbetjening bruker butikkens tekniker. Telefonmotoren eier reparasjonen av enheten og gjenoppretter betalt arbeid etter en avbrutt serversesjon. Klient-propsene oppretter eller erstatter aldri en telefon i inventoryet.

Space-fanen, ved kontrollpunktene på taket og ved disken, styrer taket, klima, låser, belysning og skjerm. Geometri, værbeskyttelse, gulv og sitteplasser fra den ferdige MLO-en beholdes.