Dokumentace Pulse Phone
Podrobnosti instalace
1. Rychlá instalace
Než cokoli zkopírujete
Použijte server artifact, který splňuje požadavky níže, se zapnutým OneSync a game buildem 2699 nebo novějším. Na běžném roleplay serveru mějte nejdřív funkční framework, inventář, oxmysql, voice resource a screenshot-basic. Standalone funguje i bez frameworku; předměty v inventáři jsou tam volitelné.
Po uplatnění nákupu stáhněte resource ze svého účtu Cfx.re. Použijte serverový klíč patřící účtu, který asset vlastní. Pokud Cfx.re hlásí chybu oprávnění (entitlement), opravte vazbu účtu a klíče; změna nastavení telefonu oprávnění udělit nemůže.
Krok 1 — Vložte resource na server
Rozbalte balíček a zkopírujte složku resource phone obsahující fxmanifest.lua do adresáře resources svého serveru. Nepřejmenovávejte ji a nedávejte na její místo vnější složku ZIP/balíčku.
Na hostovaném serveru nahrávejte v režimu Binary, nebo nahrajte zip a rozbalte ho tam (proč). Rychlý start (krok 2) uvádí počet souborů a velikost každé složky pro tento build a kontrola při startu uvede každý soubor, který chybí nebo má špatnou velikost.
Před testováním Pulse zastavte předchozí telefonní resource, aby dva telefony nesoupeřily o stejnou klávesu a předmět. Pokud plánujete jeho data později importovat, zálohujte je.
Krok 2 — Přidejte předměty do inventáře
Vyberte svůj stávající inventář; nemusíte ho nahrazovat.
| Váš inventář | Co je potřeba udělat |
|---|---|
| ox_inventory | Otevřete dodaný config/items/ox_inventory.lua. Jeho záznamy slučte do ox_inventory/data/items.lua, dovnitř existující tabulky. Nenahrazujte celý soubor inventáře. Vlastní záznam phone v ox_inventory ponechte: jeho použití otevře Pulse Phone a řádek Phone item v kontrole při startu to potvrdí. Vypsaným záznamem ho nahraďte jen tehdy, když ten řádek říká, že otevírá jiný script. Obrázky zkopírujte z config/items/images/ do ox_inventory/web/images/. Po úpravě restartujte server. |
| qb-inventory s QBCore | Chybějící definice předmětů se zaregistrují automaticky při startu. Zkopírujte config/items/images/ do qb-inventory/html/images/. Pokud váš inventář vyžaduje trvalé sdílené záznamy, dodaný config/items/qb-core.lua je připravený ke sloučení do qb-core/shared/items.lua. |
| Výchozí inventář ESX | Chybějící předměty se přidají automaticky. Pokud konzole žádá restart, restartujte jednou, aby je ESX načetlo. Pokud je váš databázový účet nemůže přidat, použijte config/items/esx.sql. |
| qs-inventory nebo jiný podporovaný inventář | Postupujte podle krátkého řádku pro váš inventář v Předmětech a inventářích. Použijte jeho vlastní seznam předmětů a složku obrázků. |
| Standalone bez inventáře | Žádné záznamy v inventáři nejsou potřeba. Požadavky na předměty nechte vypnuté. |
Kontrola při startu rozpozná chybějící záznamy a vypíše jen definice, které ještě potřebujete. Inventář, který načítá definice předmětů při startu, například ox_inventory, potřebuje záznamy výše; Pulse nepřepisuje soubory jiného resource.
Krok 3 — Zkontrolujte hlavní konfiguraci
Otevřete config/config.lua. Výchozí hodnoty rozpoznají vaše stávající nastavení:
Config.Framework = 'auto'Ponechte inventory = 'auto' v existující tabulce Config.Providers. Pokud provozujete několik inventářových resources, nastavte tuto hodnotu na inventář, který chcete používat, například 'ox_inventory'. Nepřidávejte na konec souboru druhou tabulku Config.Providers ani Config.Item.
V existující tabulce Config.Item zvolte, jak telefony fungují:
| Nastavení | Co dělá |
|---|---|
required = false, unique = false |
Každá postava má telefon, aniž by nosila předmět. Užitečné pro první test. |
required = true, unique = false |
Postava potřebuje předmět phone, aby otevřela svůj vlastní telefon. Darováním předmětu se její data nepřevádějí. |
unique = true |
Každý předmět telefonu má vlastní číslo a data. Předáním předmětu se předá ten telefon. Vyžaduje ox_inventory, qb-inventory, qs-inventory, core_inventory nebo codem-inventory. |
name = 'phone' |
Název předmětu v inventáři. Ponechte ho, pokud zároveň neměníte dodanou definici předmětu. |
Unikátní telefony se řídí zvoleným inventářovým bridge. Ponechte Config.Item.inventory = 'auto'; tento starší přepis je jen pro stávající pokročilé instalace. Config.Providers.inventory má přednost, když je výslovně nastaven.
Na existujícím serveru neměňte Config.IdentityScope. Výchozí hodnota 'character' drží telefony různých postav oddělené.
Volitelné: telefony v inventáři a placená služba
Pokud chcete pro každý telefon vyžadovat samostatný předmět, nastavte required = true a unique = true v existující tabulce Config.Item v config/config.lua, až přidáte záznamy do inventáře. Použijte jeden z inventářů pro unikátní telefony uvedených výše.
Pokud chcete prodávat telefonní službu, nastavte ve stejném souboru Config.Carrier.enabled = true. Tím se zapne aplikace Carrier, kde si hráči kupují tarif. Nové telefony potřebují tarif, než budou dostupné běžné hovory, zprávy a aplikace s mobilními daty. App Hub slouží hráčům k instalaci aplikací, není to obchod se službami. Pokud chcete i zóny pokrytí, nastavte Config.Coverage.enabled = true. Pokrytí a placené tarify jsou samostatné možnosti; kteroukoli nechte vypnutou, pokud danou funkci nechcete.
Upravujte existující nastavení, nepřidávejte duplicitní tabulky. Po uložení restartujte server. Pokud bylo dříve uloženo nastavení ve hře, resetujte ho v Settings → Server, aby platila hodnota ze souboru.
Krok 4 — Spusťte závislosti před Pulse
Ponechte stávající připojení k databázi a nastavení frameworku. Přidejte jen chybějící řádky; nespouštějte druhou kopii žádné závislosti.
Použijte toto pořadí s resources, které už na serveru máte:
- Databázový resource a jeho stávající nastavení připojení.
- Framework a jeho potřebné knihovny, identity a resources postav.
- Inventář, s konfigurací daného inventáře pro váš framework.
- Jeden podporovaný voice resource a
screenshot-basic. ensure phone.
Neinstalujte ESX, QBCore ani jiný inventář jen kvůli Pulse. V Váš framework vyberte své stávající nastavení a najdete tam konkrétní příklad pořadí spouštění. Qbox se rozpozná jako Qbox, i když jiný resource používá jeho exporty kompatibilní s QBCore.
Pro administrátorský přístup k Pulse přidejte add_ace group.admin phone.admin allow. Aby oprávnění platilo, váš administrátorský účet už musí patřit do group.admin.
Krok 5 — Přečtěte si kontrolu při prvním startu
Restartujte server. Pulse vypíše report při startu a automaticky vytvoří své databázové tabulky, jakmile je dostupné SQL připojení.
- FIX / FAIL: potřebná část nemůže fungovat. Než ji necháte hráče používat, proveďte opravu z daného řádku.
- NOTE / WARN: přečtěte si, které funkce se to týká; některá varování popisují volitelné funkce, které jste nenastavili.
- Příkazem
phone:healthv konzoli serveru kontrolu zopakujete. - Příkazem
phone:diaguvidíte zvolený framework/inventář/poskytovatele. - Jako admin se připojte, otevřete F8 a spusťte
phone:setuppro existujícího průvodce nastavením.
Nastavení uložená v adminském nastavení ve hře přepisují odpovídající nastavení ze souborů. Pokud se zdá, že změna v souboru je ignorována, zkontrolujte Settings → Server a resetujte uložený přepis, než budete měnit další soubory.
Krok 6 — Otestujte jako hráč
- Načtěte postavu, stiskněte F1 a dokončete nastavení telefonu. Pokud jsou zapnuté požadavky na předmět, nejdřív kupte telefon v obchodě nebo dejte postavě nastavený předmět telefonu.
- Pokud jste koupili zapečetěnou krabici, použijte krabici z inventáře, rozbalte ji a pak dokončete nastavení. Telefon přijde zapnutý; s
Config.Device.arrivesOn = falsenejdřív podržte End nebo O. - Otevřete Messages, Contacts a Phone. Vraťte se na domovskou obrazovku, otevřete přepínač aplikací a postupně každou aplikaci zavřete.
- Pořiďte fotku a krátké video. Obojí otevřete v Photos, zavřete a znovu otevřete telefon a ověřte, že zůstaly.
- Připojte se znovu a ověřte, že stejná postava má stále stejný telefon. Hovory otestujte s druhým hráčem přes nainstalovaný voice resource.
Kde co změnit
| Co chcete změnit | Soubor nebo místo |
|---|---|
| Framework, poskytovatel inventáře, předmět telefonu, obchod, modely, přiřazení kláves | config/config.lua |
| Poskytovatel voice | config/config.lua |
| Nastavení aplikací a služeb/jobů | config/apps.lua |
| Záznamy v inventáři a obrázky | config/items/ |
| Připojení k databázi, pořadí spouštění resources, přihlašovací údaje k hostingu médií | server.cfg (soukromé přihlašovací údaje držte na straně serveru) |
| Integrace pro vývojáře | Pokročilé integrace, volitelný Developer Kit (zerodevscripts.com/downloads/PulsePhone-developer-kit.zip) a stávající soubory bridge/; běžná instalace nevyžaduje jejich úpravy |
| Fotky/videa hráčů ve vestavěném úložišti | media/; při aktualizaci tuto složku zachovejte |
Sekce níže obsahují podrobnou referenci. K dokončení první instalace nemusíte číst nastavení každé funkce.