Docs van Pulse Phone

Frameworks

Voor Pulse Phone 1.4.28 min lezenBijgewerkt 20 oktober 2026

3. Stap voor stap voor je framework

De telefoon vindt je framework zelf: es_extended, qb-core, qbx_core, ox_core, ND_Core, vrp of de core van TMC. Je hebt Config.Framework in config/config.lua alleen nodig als er meer dan één draait, of voor een custom framework.

Je framework in één oogopslag

Framework	Gevonden via	Items	Bank en contant	Goed om te weten
ESX Legacy	`es_extended`	Pulse voegt zijn items zelf toe aan de `items`-tabel van ESX (standaard inventory). Op ox_inventory plak je het blok dat de opstartcontrole print	ESX-accounts	Bedrijfsrekeningen via je society-script
QBCore	`qb-core`	Pulse voegt zijn items zelf toe aan de shared items van QBCore (qb-, ps-, lj-inventory)	QBCore-geld	Rangen met `isboss` leiden het bedrijf
Qbox	`qbx_core` (de `qb-core`-stand-in ervan telt als Qbox, niet als tweede framework)	Plak het geprinte ox_inventory-blok	Qbox-geld	Gebruikt de Qbox-adapter, nooit die van QBCore
ox_core	`ox_core`	Plak het geprinte ox_inventory-blok	Het ox_core-account van het personage; contant geld is de `money` van ox_inventory	Geen dienstvlag: iedereen telt als in dienst
ND Core	`ND_Core`	Plak het geprinte ox_inventory-blok	`bank` en `cash` van ND	Geen dienstvlag; geen bedrijfsrekeningen
TMC	de resource `core`, herkend aan het eigen core-object van TMC	Elk item moet in de itemlijst van TMC staan: de opstartcontrole print ze	TMC-geld	Loopt via de custom bridge, niets in te stellen
vRP 2	`vrp`	Zie de sectie over vRP	vRP-portemonnee en bank	vRP 1 en forks worden niet ondersteund
Standalone	niets van het bovenstaande draait	Geen nodig	De eigen bank van de telefoon	Voor testservers of servers zonder framework
Custom	`Config.Framework = 'custom'`	Via je bridge	Via je bridge	Zie "Custom of in-house framework"

Het framework forceren

De meeste servers hebben dit nooit nodig. Forceer het framework als de opstartregel het verkeerde noemt, of als er twee framework-cores geïnstalleerd en gestart zijn. Voeg één regel toe aan server.cfg:

server.cfg

setr phone_framework qb

Waarde	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`	Geen framework: de telefoon houdt een eigen identiteit en bank bij
`custom`	Je eigen bridge (zie "Custom of in-house framework" hieronder)
`auto`	Hetzelfde als de regel weglaten: `Config.Framework` beslist

Het gaat vóór Config.Framework. Herstart de telefoon nadat je het hebt aangepast.
De resourcenamen werken ook: qbcore, qb-core, qbx_core, es_extended, ox_core. Een woord dat hij niet kent, wordt geweigerd: de opstartcontrole meldt dat en de geldfuncties blijven uit.
qb op een server die qbx_core draait, gebruikt de Qbox-adapter. Qbox antwoordt ook als QBCore.
Als het framework dat je forceert niet gestart is, blijven telefoons op hun "not ready"-scherm staan tot het wel draait. De telefoon schakelt nooit zelf over naar een ander framework.

Multicharacter werkt op elk framework. Config.IdentityScope = 'character' (de standaard) geeft elk personage een eigen telefoon. 'player' geeft één telefoon per account. Kies één keer: als je het op een live server verandert, blijft elke bestaande telefoon achter.

Bedrijfsbeheer (dienst, personeel, aannemen, de bedrijfsrekening in de Services-app) gebruikt de bedrijven in Config.Services in config/apps.lua. Wijken je jobnamen af van de standaard (police, ambulance, mechanic, taxi, fire ...), voeg de jouwe dan toe aan de job-lijst van dat bedrijf. Wil je zelf de bazenrangen kiezen, voeg dan bossGrade = <n> toe aan het bedrijf.

ESX Legacy

server.cfg

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

Items: met de standaard ESX-inventory hoef je niets te doen. De telefoon voegt zijn items bij het opstarten toe aan de items-tabel van ESX, en de console zegt welke hij heeft toegevoegd. config/items/esx.sql is er als je ze liever zelf toevoegt. Met een andere inventory, zie sectie 4.
Geld: de bank is het ESX-account bank, contant geld is het account money.
Personage: de telefoon volgt de identifier van de ESX-speler, dus esx_multicharacter werkt.
Baas: de rang met de naam boss beheert het bedrijf, tenzij je bossGrade instelt.
Bedrijfsrekeningen: esx_addonaccount / esx_society, of een bankscript uit sectie 7.

QBCore

server.cfg

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

Items: niets te plakken. De telefoon voegt de items die hij nodig heeft bij het opstarten toe aan de shared items van QBCore, en de console zegt welke hij heeft toegevoegd. Kopieer de afbeeldingen van config/items/images/ naar qb-inventory/html/images/; de opstartcontrole noemt de afbeeldingen die ontbreken.
Geld: bank en cash.
Personage: de citizenid, dus qb-multicharacter werkt.
Baas: rangen met isboss = true in je jobs, tenzij je bossGrade instelt.
Bedrijfsrekeningen: Renewed-Banking, qb-banking, of het oudere qb-management.
Multijob: als ps-multijob draait, verschijnen de andere jobs van de speler in Services en maakt één tik een job actief.

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

Items: Qbox gebruikt ox_inventory, dat geen items van een ander script kan overnemen. Start de server één keer: de opstartcontrole print de ontbrekende entries, klaar om te plakken in ox_inventory/data/items.lua (sectie 4). Afbeeldingen gaan naar ox_inventory/web/images/.
Geld: bank en cash, via qbx_core.
Personage: de citizenid.
Baas: rangen met isboss = true, tenzij je bossGrade instelt.
Multijob: ingebouwd. De andere jobs van een speler verschijnen in Services.
qbx_core antwoordt ook als qb-core. Dat is normaal: de telefoon behandelt de twee als één framework.

ox_core

server.cfg

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

Items: start de server één keer: de opstartcontrole print de ontbrekende entries, klaar om te plakken in ox_inventory/data/items.lua (sectie 4). Afbeeldingen gaan naar ox_inventory/web/images/.
Geld: de bank is het ox_core-account van het personage. Contant geld is het item money in ox_inventory.
Personage: de charId.
Jobs: ox_core-groepen hebben geen dienstvlag, dus de telefoon houdt de dienst zelf bij. Bedrijfsbeheer (personeel, aannemen, rangen) en valet zijn niet beschikbaar op ox_core.

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

Wordt vanzelf gevonden als ND_Core gestart is. Forceren: setr phone_framework nd.
Items: ND gebruikt ox_inventory. Start de server één keer: de opstartcontrole print de ontbrekende entries, klaar om te plakken in ox_inventory/data/items.lua (sectie 4).
Geld: de ND-bank van het personage, en ND-cash (ox_inventory houdt het item money gelijk).
Personage: het character-id van ND. Het getoonde telefoonnummer is dat van ND zelf als het personage er een heeft.
Jobs: de ND-job en -rang van het personage. ND heeft geen dienstvlag, dus iedereen telt als in dienst. Bedrijfsbeheer, bedrijfsrekeningen en valet zijn niet beschikbaar op ND Core.
Garage: auto's in bezit komen uit de tabel nd_vehicles van ND.

vRP

Alleen vRP 2 wordt ondersteund (niet vRP 1 of community-forks). De telefoon laadt een kleine extensie in vRP vanuit bridge/frameworks/vrp/. Niets te kopiëren.

server.cfg

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

Items: er is geen itembestand voor vRP, en vRP 2 kan geen items bruikbaar maken voor de telefoon. Laat Config.Item.required = false staan (de standaard), en stel Config.Store.box = false in zodat de winkel telefoons direct overhandigt. Spelers gebruiken de laaditems met /phonepack en /phonecable; met een vRP-inventory moet de speler daarvoor pulse_magpack en pulse_cable bij zich hebben, dus voeg beide items toe aan je vRP-itemlijst, of stel Config.Charging.enabled = false in.
Geld: de bank en portemonnee van vRP.
Personage: het character-id van vRP.
Jobs: bedrijfsbeheer en valet zijn niet beschikbaar op vRP. De Garage-app blijft leeg tenzij je een garagescript aansluit.

TMC

TMC is ingebouwd. De telefoon herkent de core van TMC zelf: geen extra resource, en geen aanpassing in config/config.lua (auto, tmc en custom werken allemaal).

server.cfg

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

De opstartcontrole toont Framework: TMC.

Items: voeg de Pulse-items toe aan de itemlijst van TMC zoals je elk item toevoegt. De namen zijn phone, pulse_magpack, pulse_magpack_max, pulse_cable, pulse_router, pulse_burner, pulse_buds, pulse_ringlight, pulse_wallet (config/items/tmc.lua heeft de entries), en voor de dozen van de winkel pulse_phone_box plus één per afwerking (pulse_phone_box_black ...). De labels, gewichten en beschrijvingen staan in config/items/qb-core.lua, en de afbeeldingen in config/items/images/. Een item dat niet in de lijst staat, wordt geweigerd en de speler ziet "inventory full": de console noemt dan het item. Een doositem dat in de lijst ontbreekt, houdt de verkoop niet tegen: de winkel overhandigt die telefoon zonder doos en meldt dat in de console. Wil je helemaal geen dozen, stel dan Config.Store.box = false in.
Geld: het contante geld van het personage, en de bank: de banking-resource van TMC als die draait (de eigen persoonlijke rekening), anders het bankgeld van de core. Hebben je rekeningnummers niet de vorm BNK123456, geef dan in config/config.lua het veld op waarin het rekeningnummer staat: Config.Providers.tmcBankAccount = 'charinfo.account' (gebruik je eigen veld). Wallet toont een streepje, nooit een verzonnen bedrag, als de bank niet gelezen kan worden.
Personage: het citizen-id van TMC.
Jobs: de job die in dienst is (of de eerste), met de rang en dienststatus.
Had je de tijdelijke pulse_tmc-connector? Verwijder ensure pulse_tmc en verwijder die map. De console herinnert je eraan zolang hij nog draait.

Standalone (geen framework)

server.cfg

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

Items: geen nodig. Elke speler heeft een telefoon, een Reserve en een kabel.
Geld: de telefoon houdt een eigen bank bij. Een nieuwe speler begint met 5000 (startingBalance in config/apps.lua).
Personage: de Rockstar-licentie van de speler.
Jobs, auto's en woningen: de telefoon houdt ze zelf bij. Vul ze met de testcommando's in sectie 9.

Custom of in-house framework

Stel Config.Framework = 'custom' in in config/config.lua.
Geef de telefoon een bridge-tabel in de vorm van optional-developer-kit/custom_framework_bridge.lua: als Config.Providers.custom in config/config.lua, of vanuit je eigen resource met exports.phone:RegisterFrameworkBridge(MyBridge).
Alleen GetCharacterId is verplicht. Laat je een functie voor naam, job, licentie of voertuig-/woninglijst weg, dan doet de telefoon alsof je server die data niet heeft. Laat je een geld- of itemfunctie weg, dan wordt die actie geweigerd: de telefoon betaalt nooit uit een eigen bank. De Bank-app verschijnt alleen als je bridge GetBankBalance heeft.
Als je core herstart terwijl de telefoon blijft draaien, roep dan exports.phone:FrameworkRestarted() aan zodra de core klaar is.

bridge/frameworks/custom.lua laat zien hoe de telefoon je tabel gebruikt. Om andere in-house scripts aan te sluiten (een bank- of garagescript), zie optional-developer-kit/custom_provider_template.lua en Exports. De twee templates zitten in de optionele developer kit, zerodevscripts.com/downloads/PulsePhone-developer-kit.zip, niet in de telefoonmap.