ox_core
ox_core admin panel and staff tools
ox_core keeps cash in ox_inventory and the bank in an account, and FiveStaff looks in both
There is no cash balance on an ox_core character: cash is the money item in ox_inventory, the bank is the character’s default account, and a job is whichever of their groups has the type job. FiveStaff reads and changes each of those where ox_core actually keeps it, through ox_core and ox_inventory while the character is loaded and through the database when they are not.
Shown on our demo server, which runs QBCore
ox What FiveStaff sees on ox_core
- Characters by state id
- Money cash item and bank account
- Jobs the group of type job
- Items ox_inventory
- Vehicles by plate
Framework data
What FiveStaff reads and changes on ox_core
What FiveStaff reads
- The character, its state id and the names on it
- Every group the character is in, and which of them is their job
- Cash, from the money item in ox_inventory
- Bank, from the character’s default account
- Items out of ox_inventory
- Owned vehicles, by plate
What staff can change
- Set cash or bank
- Set an item count, or remove an item
- Set the job and its grade
- Give or take an owned vehicle
- Move a vehicle to another character, or change its plate
Every one of these goes through the same pipeline as a ban: permission-checked and written to the audit log with what it was before. Item, money, job and vehicle edits can be put back in one press from the player’s profile.
What your staff can do
Run an ox_core server from one panel
Everything below works from the web panel, from Discord and, for staff who are playing, in game. Each power is its own permission, so you choose who gets which.
Characters and the economy
Every ox_core character with their cash, bank, groups and vehicles. Staff set cash and bank, item counts and the job, and give, move, re-plate or remove a vehicle.
- Edit inventories
- Edit money
- Edit vehicles
- Edit jobs
Players and records
Everyone who has ever joined, and everything staff did about it.
Player log and alerts
What every player actually did, searchable, with alerts you write.
Live view and calls
Watch a player's game as it happens, and talk to them.
Reports
A player types /report in game and your team picks it up in seconds.
Bans and appeals
Bans that survive a new account, and appeals you can actually read.
Staff tools in game
Ban, warn and message from the game, with trust scores over every head.
Discord
Logs, slash commands and staff roles, in the Discord you already run.
In the panel
The screens your staff will use
Real screens from the panel, taken on our demo server, which runs QBCore. On yours, the accounts and jobs are ox_core’s own.
Player log
What the player log picks up on ox_core
ox_core says when a character is loaded, when somebody joins a group and when money goes in or out of the bank, and ox_inventory says where every item went. FiveStaff listens to both, with no changes to your scripts.
From ox_core
- Deposits into and withdrawals from the bank
- Groups joined and grades changed, a new job included
- Characters loaded
With ox_inventory
- Items dropped, picked up, given, and taken from another player
- Moves into and out of stashes, boots and gloveboxes, with the plate
- Shop purchases with the price, and crafts with what went into them
- Items created from nothing, with the script that made them
- Items used, and one player searching another
On every server
- Joins and leaves
- Deaths and kills, from the game itself: how, by whom and with what
- txAdmin’s scheduled restarts and shutdowns, and resources stopped or started by hand
- Every line your scripts already send to qb-log, kept word for word
- Your own events, with one line of Lua: exports.fivestaff:logEvent
-- one line, and it is searchable by item and amount
exports.fivestaff:logEvent(source, 'drugs.weed.sold', {
item = 'weed_brick', amount = 5, price = 2500
})The log is off until you switch it on, and a category you leave off costs your server nothing. The player log and alerts
Your resources
The scripts it works with on ox_core
A server picks its inventory, its ambulance job and its clothing separately from its framework. FiveStaff looks for what is actually running and works through it.
Inventory
ox_core runs with ox_inventory and keeps no items of its own. Items, and the money item that is a character’s cash, are read and changed through ox_inventory.
-
ox_inventory
Heal and Revive
Revive goes through your ambulance script, so its own death screen and timers are cleared too, rather than a player being stood up the script still thinks is dead.
-
qbx_medical -
qb-ambulancejob -
ps-ambulancejob -
esx_ambulancejob -
wasabi_ambulance -
wasabi_ambulance_v2 -
tk_ambulancejob -
sky_ambulancejob -
brutal_ambulancejob -
osp_ambulance -
p_ambulancejob -
plt_ambulance_job
The small print
Where ox_core is different
The details a tool gets wrong when it treats every framework as the same one, and what FiveStaff does instead.
Cash is an item, and the bank is an account
ox_core keeps no cash balance on a character. Cash is the money item in their ox_inventory, and the bank is the account ox_core marks as their default. FiveStaff reads and sets each one there, rather than looking for a cash column that does not exist and reporting nought.
A job is a group with the type job
ox_core has groups rather than jobs, and a character holds one group of each type. The job FiveStaff shows and sets is the group whose type is job, so a character’s gang or any other group is a different one and is left as it is.
Hunger and thirst count up from full
ox_core keeps hunger, thirst and stress on the character, and nought is full rather than empty. Food and drink and Calm stress set those statuses the way ox_core reads them, so a player is fed rather than starved by a tool that assumed a hundred meant full.
Revive comes from your ambulance script
ox_core has no revive of its own. Revive and Heal go through whichever ambulance script you run, so its own death screen and timers are cleared too.
Install
Put it on your ox_core server
One resource, a few lines in server.cfg, and no changes to your framework or your scripts.
-
1
Add your server
Sign in to the panel with Discord, press Add server, give it a name and choose a plan.
-
2
Download the resource
On your server’s dashboard, press Download the resource. The fivestaff folder inside already holds your server key, so there is nothing to fill in.
-
3
Add it to server.cfg
Upload the folder to your resources, keeping its name exactly fivestaff, and add the lines opposite anywhere after ox_core and ox_inventory start.
-
4
Restart and check
Restart, or type ensure fivestaff in the server console. Within seconds the dashboard says Online. FiveStaff finds ox_core from its own resource, and uses ox_inventory for items and cash.
-
5
Connect your game database
Under Settings, Database, connect a read-only database user and choose Other as the table layout. Pick ox_core’s tables yourself on any plan, or let FiveStaff work them out on Pro, and confirm before anything is read.
ensure fivestaff
# lets FiveStaff update itself, and staff start and stop resources
add_ace resource.fivestaff command.restart allow
add_ace resource.fivestaff command.start allow
add_ace resource.fivestaff command.stop allowOnly if it guessed wrong
Most servers never need these. They go above ensure fivestaff.
set fivestaff_framework "ox"When FiveStaff starts, the server console says which framework and inventory it is using. Try one edit on a test character before your staff use it on a player.
Why staff use it
Built for the people who keep an ox_core server fair
A record of every player, a log of every action, and powers handed out one at a time.
One record for every player
Whichever character somebody is on, their warnings, bans, reports and notes sit on one profile, and a ban checks every identifier they connect with — so a new account is not a fresh start on your ox_core server.
Nobody needs in-game admin
Your team is a list in the panel. Staff act from the panel, from Discord or in game with /staff, and you hand out no ace permissions to make that work.
Each power is its own permission
Edit money, Edit inventories, Edit vehicles and Edit jobs are separate permissions, so a trial moderator can read the player log without being able to set a balance.
Every change has a before
The audit log records who did what and what it was before, and item, money, job and vehicle edits can be put back in one press.
Questions people ask first
Where does FiveStaff find a character’s cash on ox_core?
In ox_inventory, as the money item, because ox_core keeps no cash balance of its own. The bank is the character’s default account in ox_core. Both are read and set where they live.
Do item edits go through ox_inventory?
Yes. ox_core runs with ox_inventory, so a character’s items are read and changed there, which is where the player will see them.
Will changing a job take away a character’s other groups?
No. A job on ox_core is the character’s group of type job, and that is the group FiveStaff reads and sets. A character holds one group of each type, so a gang or any other group is a different one and is left as it is.
Can staff feed a player or calm their stress?
Yes. Food and drink and Calm stress set ox_core’s own statuses, which it keeps on the character. ox_core counts hunger and thirst up from nought, which is full, and FiveStaff sets them that way round.
Does Revive work on ox_core?
ox_core has no revive of its own, so Revive and Heal go through whichever ambulance script you run from the list above, and its own death screen and timers are cleared with them.
Can staff edit a character who is offline?
Yes. A character who is not on the server is edited in your database, through your game server, so your game server has to be online for any edit.
What does the player log pick up without any changes?
Bank deposits and withdrawals; groups and jobs joined and grades changed; characters loaded; where every item went in ox_inventory, cash included, because cash is an item; and joins, leaves and deaths.
Can an edit be undone?
Item, money, job and vehicle edits are written to the audit log with what they were before, and can be put back from the player’s profile under Framework, Edits.
Running something else?
Each framework has a page of its own, in its own words.
Point it at your ox_core server
Sign in with Discord, add your server, and drop one resource into it. Free for 3 staff, and nothing to cancel if it is not for you.