Pulse Phone docs
Administration
8. Pulse Admin
/pulseadmin in game opens Pulse Admin, the full-screen owner panel: Server status (every detected script and its state), Setup (the start-up check as a checklist with copy buttons), Features and apps, Handsets and accessories, Prices and items, Languages, Vending machines, Jobs and dispatch, Voice and calls, Photo storage, Admin access, Diagnostics (support code, report, change history) and Every setting (search with /). Esc closes it; Alt+Up / Alt+Down change section. An optional key is Config.OwnerTools.key (empty by default; players rebind it under Key Bindings > FiveM).
Who may open it, and use every admin-only tool in the phone:
| Who | How |
|---|---|
| Server console, txAdmin Live Console | always |
| Framework staff | Config.OwnerTools.frameworkAdmins = true (default) and one of Config.OwnerTools.adminGroups (admin, superadmin, god): ESX getGroup(), QBCore permissions, Qbox ACE via qbx_core |
| A player you grant | console: pulseadmin grant <server id> (online) or pulseadmin grant license:...; pulseadmin revoke <id or license>; pulseadmin list. Or Pulse Admin > Admin access. Grants are kept on the server by licence |
| ACE | add_ace group.admin phone.admin allow (unchanged) |
Framework staff get everything except the owner's part: granting and removing Pulse admins, the photo storage keys and upload address, and the Admin access settings (Config.OwnerTools.*) need the console, ACE or a console grant. With Config.OwnerTools.enabled = false the panel changes nothing (it still shows everything and can still teleport an admin to a vending machine).
Every Pulse Admin request is checked on the server for each call (admin, field schema, rate limit) and written to the security log; every change is in the change history with who made it. Storage keys saved in Pulse Admin are kept on the server only and are never sent back to a game client.
9. Admin and testing commands
The ace, if you prefer it to the groups above:
add_ace group.admin phone.admin allow
add_principal identifier.license:YOUR_LICENSE group.adminRun these in the server console, or in game (F8 or chat) as a Pulse admin. phone:health prints to
the server console, and phonecarphotos runs in game only. <id|number> is an online server ID
or any phone number.
| Command | What it does |
|---|---|
phone:health |
Prints the start-up check again. |
phone:diag |
Lists every script the phone considered and why it used or skipped each one. |
phone:usage |
Prints the Usage numbers (below): phones set up, active in the last 7 days, messages, calls and photos of the last 7 days, and the most-used apps. |
phone:setup |
In game: takes the phone out on Settings > Server > Setup Assistant. |
phone:set <key> [value] |
Changes a setting without opening a file, e.g. phone:set Store.phonePrice 1500. With no value it shows the setting, its default and whether it was changed. |
phone:reset <key\|all> |
Puts one setting, or every setting, back to the config/ files. |
phone:alert <extreme\|severe\|advisory> <title> \| <message> |
Console only: sends an emergency alert to every phone. |
phone:inspect <id\|number> |
A summary of one phone: number, mail, created, setup, passcode. |
phone:resetpin <id\|number> |
Removes a forgotten passcode and Face Unlock. |
phone:number <id\|number> <newnumber> |
Gives a phone a new, unused number that fits Config.Numbers.format. Everything the phone owns moves with it in one step; if any part fails, nothing changes. The old number is never issued again. Refused with unique phones (the number is on the item). phone:setnumber is the same command. A player typing phone:number alone sees their own number. |
phone:wipe <id\|number> confirm |
Erases a phone's own data and resets it. Without confirm it only says what it would erase. |
phonefactoryreset [id] |
Resets a player's phone to setup. Also allowed with the ace command.phonefactoryreset. |
phone:new <id> |
Console only: gives the player a brand new phone record. |
phone:battery <id> <0-100> |
Sets a player's battery. |
phone:damage <id> <crack\|shatter\|water\|repair\|clear> |
Cracks, shatters, soaks or repairs the phone in a player's hand; clear also takes off everything fitted. |
phone:retention [now] |
Runs data retention now and prints what it removed (now while retention is off). |
phone:zone ... |
Dead zones and repeaters (section 8, Dead zones). |
phone:ownermedia |
Checks your own ringtones, tones and wallpapers again. |
phone:musiclibrary |
Reads ownermedia/music/ again and prints what the Server Library holds. |
markets:shock, markets:halt |
Market events and trading halts in the Markets app. |
phone_api |
Console: prints the add-on API. |
phone:wifi list |
Lists every placed router: id, name, position, routing bucket, state, devices on it, owner. |
phone:wifi remove <id> |
Removes a router. The item is not given back to its owner. |
phone:wifi tp <id> |
Teleports you to a router (in game). |
phone:burner list |
Lists every burner: number, live or destroyed, item or per character. |
phone:burner owner <number> |
Who first switched a burner on (for staff; never shown in game). |
phone:taps list |
Lists active police taps: number, officer, intercepts, time left, reason. |
phone:taps end <id> |
Ends a tap. |
phonecarphotos |
Photographs every car model for the Garage app (needs screenshot-basic). |
Standalone only
Testing on a standalone server. These only work with no framework, where the phone keeps its
own jobs, money, cars and homes. [id] defaults to yourself.
| Command | What it does |
|---|---|
phonejobs |
Lists the jobs and grades. The top grade of each is the boss. |
phonesetjob <job> <grade> [id] |
Sets a job. phonesetjob unemployed 0 clears it. |
phoneduty [id] |
Toggles duty. |
phonegivemoney <amount> [id] |
Adds bank money. society:<job> in place of the id funds a company. |
phonegivecar <model> [plate] [id] |
Adds a car to the phone's garage. |
phonestorecar [id] |
Puts the phone-garage car you are sitting in back in the garage. |
phonegivehouse [label] [id] |
Gives a home where the player stands. |
Every phone:inspect, phone:resetpin, phone:wipe and phone:number is written to the
security log and the activity log. A player without the ace gets no answer, and the attempt is
logged.
A walk-through that touches every system:
phonesetjob police 4makes you police chief: Services shows Your Company with staff, hiring, grades and the company account. Dial911from a second player and choose Police: your phone rings.phonegivemoney 5000, then pay someone from Wallet or in Messages, or deposit into the company account from Services.phonegivecar adder, then Garage > the car > Valet: it is brought to you and the valet fee is taken. Drive it, thenphonestorecar.phonegivehouse Beach House, then Home: waypoint, lock and unlock, give a key to another player's number.
On a standalone server, jobs, cars, homes and money are kept in the phone's own tables, so they
survive a restart. Add your own jobs in Config.Standalone.jobs; a job shows in Services only if
a Config.Services company lists it.
Settings > Server: the guided setup and in-game settings
An admin (ace phone.admin) sees Settings > Server on their phone. Nobody else does, and the
server checks the admin right again on every request.
- Health Check is the start-up check, section by section: framework, database, the scripts it connected, every feature on or off, items present or missing, and the interface files. A numbered What to do list and the text to paste (with Copy) are at the bottom.
- Setup Assistant (
phone:setupin F8) walks you through it: what was found, the items, which features are on, store prices and which jobs get the job-only apps. - Configuration has most settings from the
config/files, group by group, with a check on every value (a price can't be negative, a job name can't have spaces, and so on). Since 1.4.0 it also carries Setup length (the full first-run setup, the default, or the short one), New phones arrive switched on and the First-week card switch (section 8, "A new phone's first start"). The first two take effect from the next start, the card switch at once. - Change History lists every change with who made it and when.
- Usage shows how much the phone is used on your server (below).
Which value wins. The config/ files are the defaults. A value changed in game is saved on
the server (the phone_pulse_settings table) and wins over the file until you press Reset to
Default on it, or Reset Everything. Editing the file does not undo a value changed in game.
Settings marked Restart needed are saved at once and used from the next time the phone
starts (ensure phone in the console, or a server restart). Everything else applies at once.
To switch in-game changes off entirely, set Config.OwnerTools.enabled = false in
config/apps.lua: saved values are then ignored but not deleted.
Usage
Settings > Server > Usage answers "are my players using it" from your own phone: how many
phones are set up, how many were active in the last 7 days, the messages, calls and photos of
the last 7 days, and the most-used apps. The numbers are counted on the server from the tables
the phone already keeps, reused for a minute between requests, and never sent anywhere: there
is no reporting and no upload. phone:usage prints the same numbers in the server console.
What is kept for it is small. App opens are counted per day and app in phone_usage_daily:
how many times an app was opened, and by how many different phones (a close count, not an
exact one). No row names a player, a device or a time of day. "Active"
is phone_devices.last_seen, the time a phone was last opened, written at most once an hour
per phone. Both are added by the phone itself on its first start after the update
(section 10).
The update notice
At start, and once a day while the server runs, the phone fetches one small version file from
zerodevscripts.com (https://zerodevscripts.com/pulse/version.json). When a newer Pulse Phone is
out, the console says Update available with what is new (each version once), the start-up
check has an Update line, and Settings > Server shows it. What that request carries: your
server's IP address reaches our web server, as with any download, and nothing else: no server
name, no key, no player data. With no internet or the site down, the phone waits a few seconds
and carries on without a word. To switch it off, set Config.UpdateCheck.enabled = false in
config/apps.lua.
Department stores: moving them into your MLO
The police quartermaster and the medical supply room (config/apps.lua) are where
officers and medics draw their Pulse Tablets, and printer paper when paper.required is on.
They ship at the Mission Row front desk and outside Pillbox Hill. To put one inside your own
police station or hospital, with no code to change:
- Join as an admin (ace
phone.admin) and stand where the counter should be, facing the way the clerk should face. - Type
/deptstorepos. A ready line such ascoords = vec4(452.61, -983.12, 30.69, 88.4),is printed in F8 and in the server console. - Paste it over that location's
coordsinconfig/apps.luaand restart the resource.
A store can have several locations. Jobs, minimum grade, duty, prices (0 = free issue), whether the department's company account pays, per-player limits and stock are set per store and item in the same file, and all of them are checked on the server.
Before you open purchases
Before opening purchases, test a store purchase, unboxing, model/finish change, held prop,
call, charging and reconnect on your server. Run phone:health and phone:diag in the server
console. Custom integrations require the documented bridge; support for a framework does not
automatically make every third-party resource compatible.