Dokumentace Pulse Phone

Frameworky

Pro Pulse Phone 1.4.28 min čteníAktualizováno 20. října 2026

3. Krok za krokem pro váš framework

Telefon si váš framework najde sám: es_extended, qb-core, qbx_core, ox_core, ND_Core, vrp nebo core od TMC. Config.Framework v config/config.lua potřebujete, jen pokud jich běží víc, nebo pro vlastní framework.

Váš framework v kostce

Framework	Rozpoznán podle	Předměty	Banka a hotovost	Dobré vědět
ESX Legacy	`es_extended`	Pulse si přidá své předměty do tabulky `items` v ESX sám (výchozí inventář). Na ox_inventory vložte blok, který vypíše kontrola při startu	Účty ESX	Firemní účty přes váš society script
QBCore	`qb-core`	Pulse si přidá své předměty do sdílených předmětů QBCore sám (qb-, ps-, lj-inventory)	Peníze QBCore	Hodnosti s `isboss` řídí firmu
Qbox	`qbx_core` (jeho náhrada `qb-core` se počítá jako Qbox, ne jako druhý framework)	Vložte vypsaný blok pro ox_inventory	Peníze Qbox	Používá adaptér Qbox, nikdy ten pro QBCore
ox_core	`ox_core`	Vložte vypsaný blok pro ox_inventory	Účet postavy v ox_core; hotovost je `money` z ox_inventory	Žádný příznak služby: všichni se počítají jako ve službě
ND Core	`ND_Core`	Vložte vypsaný blok pro ox_inventory	`bank` a `cash` z ND	Žádný příznak služby; žádné firemní účty
TMC	jeho resource `core`, rozpoznaný podle vlastního core objektu TMC	Každý předmět musí být v seznamu předmětů TMC: kontrola při startu je vypíše	Peníze TMC	Běží přes custom bridge, nic se nenastavuje
vRP 2	`vrp`	Viz sekci vRP	Peněženka a banka vRP	vRP 1 a forky nejsou podporované
Standalone	neběží nic z výše uvedeného	Nejsou potřeba	Vlastní banka telefonu	Pro testovací servery nebo servery bez frameworku
Vlastní	`Config.Framework = 'custom'`	Přes váš bridge	Přes váš bridge	Viz „Vlastní nebo interní framework“

Vynucení frameworku

Většina serverů to nikdy nepotřebuje. Framework vynuťte, když řádek při startu uvádí špatný, nebo když jsou nainstalovaná a spuštěná dvě jádra frameworků. Přidejte jeden řádek do server.cfg:

server.cfg

setr phone_framework qb

Hodnota	Framework
`esx`	ESX Legacy (`es_extended`)
`qb`	QBCore (`qb-core`)
`qbox`	Qbox (`qbx_core`)
`ox`	ox_core
`nd`	ND Core (`ND_Core`)
`vrp`	vRP 2 (`vrp`)
`tmc`	TMC (`core`)
`standalone`	Bez frameworku: telefon má vlastní identitu a banku
`custom`	Váš vlastní bridge (viz „Vlastní nebo interní framework“ níže)
`auto`	Totéž jako vynechat řádek: rozhoduje `Config.Framework`

Má přednost před Config.Framework. Po změně telefon restartujte.
Fungují i názvy resources: qbcore, qb-core, qbx_core, es_extended, ox_core. Slovo, které nezná, se odmítne: kontrola při startu to oznámí a funkce s penězi zůstanou vypnuté.
qb na serveru, kde běží qbx_core, použije adaptér Qbox. Qbox se hlásí i jako QBCore.
Pokud vynucený framework není spuštěný, telefony zůstanou na obrazovce „not ready“, dokud se nespustí. Telefon nikdy sám nepřepne na jiný framework.

Multicharacter funguje na každém frameworku. Config.IdentityScope = 'character' (výchozí) dá každé postavě vlastní telefon. 'player' dá jeden telefon na účet. Vyberte jednou: změna na živém serveru nechá všechny existující telefony za sebou.

Správa firem (služba, personál, nábor, firemní účet v aplikaci Services) používá firmy v Config.Services v config/apps.lua. Pokud se názvy vašich jobů liší od výchozích (police, ambulance, mechanic, taxi, fire ...), přidejte ty své do seznamu job dané firmy. Pokud chcete hodnosti šéfa zvolit sami, přidejte k firmě bossGrade = <n>.

ESX Legacy

server.cfg

ensure oxmysql
ensure es_extended
# ... your ESX scripts, inventory, banking ...
ensure pma-voice
ensure screenshot-basic
ensure phone

Předměty: s výchozím inventářem ESX není co dělat. Telefon při startu přidá své předměty do tabulky items v ESX a konzole řekne, které přidal. config/items/esx.sql je k dispozici, pokud je chcete přidat sami. S jiným inventářem viz sekce 4.
Peníze: banka je účet ESX bank, hotovost je účet money.
Postava: telefon se řídí hráčovým identifier v ESX, takže esx_multicharacter funguje.
Šéf: firmu řídí hodnost s názvem boss, pokud nenastavíte bossGrade.
Firemní účty: esx_addonaccount / esx_society, nebo bankovní script ze sekce 7.

QBCore

server.cfg

ensure oxmysql
ensure qb-core
# ... qb-inventory and your other qb scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

Předměty: nic se nevkládá. Telefon při startu přidá potřebné předměty do sdílených předmětů QBCore a konzole řekne, které přidal. Obrázky zkopírujte z config/items/images/ do qb-inventory/html/images/; kontrola při startu uvede ty, které chybí.
Peníze: bank a cash.
Postava: citizenid, takže qb-multicharacter funguje.
Šéf: hodnosti s isboss = true ve vašich jobech, pokud nenastavíte bossGrade.
Firemní účty: Renewed-Banking, qb-banking nebo starší qb-management.
Multijob: když běží ps-multijob, ostatní joby hráče se zobrazí v Services a jedním klepnutím se job aktivuje.

Qbox

server.cfg

ensure oxmysql
ensure qbx_core
ensure ox_inventory
# ... your other Qbox scripts, in Qbox's own order ...
ensure pma-voice
ensure screenshot-basic
ensure phone

Předměty: Qbox používá ox_inventory, který nedokáže přebírat předměty z jiného scriptu. Spusťte server jednou: kontrola při startu vypíše chybějící záznamy, připravené ke vložení do ox_inventory/data/items.lua (sekce 4). Obrázky patří do ox_inventory/web/images/.
Peníze: bank a cash, přes qbx_core.
Postava: citizenid.
Šéf: hodnosti s isboss = true, pokud nenastavíte bossGrade.
Multijob: vestavěný. Ostatní joby hráče se zobrazí v Services.
qbx_core se hlásí i jako qb-core. To je normální: telefon s nimi zachází jako s jedním frameworkem.

ox_core

server.cfg

ensure oxmysql
ensure ox_core
ensure ox_inventory
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

Předměty: spusťte server jednou: kontrola při startu vypíše chybějící záznamy, připravené ke vložení do ox_inventory/data/items.lua (sekce 4). Obrázky patří do ox_inventory/web/images/.
Peníze: banka je účet postavy v ox_core. Hotovost je předmět money v ox_inventory.
Postava: charId.
Joby: skupiny ox_core nemají příznak služby, takže službu si vede telefon sám. Správa firem (personál, nábor, hodnosti) a valet nejsou na ox_core k dispozici.

ND Core

server.cfg

ensure oxmysql
ensure ox_lib
ensure ND_Core
ensure ox_inventory
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

Rozpozná se sám, když je spuštěný ND_Core. Vynucení: setr phone_framework nd.
Předměty: ND používá ox_inventory. Spusťte server jednou: kontrola při startu vypíše chybějící záznamy, připravené ke vložení do ox_inventory/data/items.lua (sekce 4).
Peníze: bank postavy v ND a cash v ND (ox_inventory drží předmět money v souladu).
Postava: ID postavy v ND. Zobrazené telefonní číslo je to z ND, pokud ho postava má.
Joby: job a hodnost postavy v ND. ND nemá příznak služby, takže všichni se počítají jako ve službě. Správa firem, firemní účty a valet nejsou na ND Core k dispozici.
Garáž: vlastněná auta se berou z tabulky nd_vehicles v ND.

vRP

Podporované je jen vRP 2 (ne vRP 1 ani komunitní forky). Telefon do vRP načte malé rozšíření z bridge/frameworks/vrp/. Nic se nekopíruje.

server.cfg

ensure oxmysql
ensure vrp
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

Předměty: pro vRP neexistuje soubor s předměty a vRP 2 neumí udělat předměty použitelnými pro telefon. Ponechte Config.Item.required = false (výchozí) a nastavte Config.Store.box = false, aby obchod předával telefony přímo. Nabíjecí předměty hráči používají přes /phonepack a /phonecable; s inventářem vRP k tomu hráč musí nést pulse_magpack a pulse_cable, takže přidejte oba předměty do seznamu předmětů vRP, nebo nastavte Config.Charging.enabled = false.
Peníze: banka a peněženka vRP.
Postava: ID postavy ve vRP.
Joby: správa firem a valet nejsou na vRP k dispozici. Aplikace Garage zůstane prázdná, pokud nepřipojíte garážový script.

TMC

TMC je vestavěné. Telefon rozpozná core od TMC sám: žádný další resource a žádná změna v config/config.lua (auto, tmc i custom fungují).

server.cfg

ensure oxmysql
ensure core
# ... your other scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone

Kontrola při startu ukáže Framework: TMC.

Předměty: přidejte předměty Pulse do seznamu předmětů TMC stejně, jako přidáváte jakýkoli předmět. Názvy jsou phone, pulse_magpack, pulse_magpack_max, pulse_cable, pulse_router, pulse_burner, pulse_buds, pulse_ringlight, pulse_wallet (config/items/tmc.lua obsahuje záznamy) a pro krabice z obchodu pulse_phone_box plus jeden na každou povrchovou úpravu (pulse_phone_box_black ...). Popisky, váhy a popisy jsou v config/items/qb-core.lua a obrázky v config/items/images/. Předmět, který v seznamu není, se odmítne a hráč uvidí „inventory full“: konzole pak předmět uvede. Chybějící předmět krabice prodej nezastaví: obchod předá telefon bez krabice a oznámí to v konzoli. Pokud krabice vůbec nechcete, nastavte Config.Store.box = false.
Peníze: hotovost postavy a její banka: resource banking od TMC, když běží (její vlastní osobní účet), jinak bankovní peníze z core. Pokud vaše čísla účtů nemají tvar BNK123456, uveďte v config/config.lua pole, které číslo účtu obsahuje: Config.Providers.tmcBankAccount = 'charinfo.account' (použijte své vlastní pole). Když banku nelze přečíst, Wallet ukáže pomlčku, nikdy vymyšlenou částku.
Postava: citizen id v TMC.
Joby: job ve službě (nebo první), s hodností a stavem služby.
Měli jste dočasný konektor pulse_tmc? Odstraňte ensure pulse_tmc a smažte tu složku. Konzole vám to připomíná, dokud ještě běží.

Standalone (bez frameworku)

server.cfg

ensure oxmysql
ensure pma-voice
ensure screenshot-basic
ensure phone

Předměty: nejsou potřeba. Každý hráč má telefon, Reserve a kabel.
Peníze: telefon má vlastní banku. Nový hráč začíná s 5000 (startingBalance v config/apps.lua).
Postava: Rockstar licence hráče.
Joby, auta a domy: telefon si vede vlastní. Naplníte je testovacími příkazy ze sekce 9.

Vlastní nebo interní framework

Nastavte Config.Framework = 'custom' v config/config.lua.
Dejte telefonu bridge tabulku ve tvaru optional-developer-kit/custom_framework_bridge.lua: buď jako Config.Providers.custom v config/config.lua, nebo z vlastního resource přes exports.phone:RegisterFrameworkBridge(MyBridge).
Povinná je jen GetCharacterId. Pokud vynecháte funkci pro jméno, job, licenci nebo seznam vozidel/domů, telefon se chová, jako by váš server taková data neměl. Pokud vynecháte funkci pro peníze nebo předměty, daná akce se odmítne: telefon nikdy neplatí z vlastní banky. Aplikace Bank se zobrazí, jen když váš bridge má GetBankBalance.
Pokud se vaše core restartuje, zatímco telefon dál běží, zavolejte exports.phone:FrameworkRestarted(), jakmile je core připravené.

bridge/frameworks/custom.lua ukazuje, jak telefon vaši tabulku používá. Pro připojení dalších interních scriptů (bankovní nebo garážový script) viz optional-developer-kit/custom_provider_template.lua a Exporty. Obě šablony jsou ve volitelném vývojářském kitu, zerodevscripts.com/downloads/PulsePhone-developer-kit.zip, ne ve složce telefonu.