ZeroDev Sentinel docs
ZeroDev Sentinel: commands
Build 0.1.2. Every command below is registered by zerodev_sentinel. Type them in the server console (txAdmin's live console works too), or in game in F8 or chat as a player with the ACE shown. In game the answer is printed in chat.
Arguments: <name> is required, [name] is optional, a|b means one of them. A server id is the number FiveM gives an online player; an account is the account id Sentinel shows in cases and sentinel:diag player <server id>.
Commands marked "restricted" are registered with FiveM's restricted flag: in game they also need the ACE command.<name> (the common server.cfg line add_ace group.admin command allow covers it). The server console can always run them.
Overview
| Command | What it does |
|---|---|
sentinel:advisor |
Prints every hardening check: current value, recommended value, what it blocks, what it might break and the line to copy into server.cfg. |
sentinel:diag |
Prints what Sentinel decided and why: storage, crypto, mode, rules, scheduler timings and the latest decisions. |
sentinel:discord |
Shows the Discord bot: connected or not, the guild and channels it uses, linked staff; unlinks a Discord user from the console. |
sentinel:health |
Prints the startup box again, every row included. |
sentinel:level |
Shows or changes the protection level at once and saves it (the same switch as the owner desk). The saved level wins over Config.Protection after a restart. |
sentinel:link |
Prints a one-time code for a staff member to link their Discord account: they type /link in Discord. Single use, 10 minutes. |
sentinel:lockdown |
Shows or changes entity lockdown on the main world (routing bucket 0) while the server runs. Sentinel puts the original mode back when it stops. |
sentinel:map |
The terrain grid of the 3D duty map: whether it is measured, when and by whom. The first staff member in game measures it on their own; this asks again. |
sentinel:mode |
The older words for the protection levels: watch = watch, review = recommended, enforce = strict. Saved like sentinel:level. |
sentinel:owner |
The owner seat. On the first start Sentinel prints a one-time code in the server console; the owner types it in game to claim the seat. |
sentinel:panel |
Opens the browser panel: prints a one-time sign-in code (works once, for 5 minutes) for a player or a staff account, lists open panel sessions, or ends them. |
sentinel:storage |
Shows where clips and photos go (FiveManage, Discord, off), the upload queue and the last failures. Keys are never printed. |
sentinel:webhook |
Shows the Discord webhook state and counters. The URL itself is never printed. |
sentinel:ban |
Queues a ban for a case from the server console (the owner without a game client). |
sentinel:case |
Prints a case: subject, evidence with SHA-256 fingerprints, the log, and whether the hash chain over the log still verifies. |
sentinel:console |
Opens the staff console in game. The same as the console key. Players only, not the server console. |
sentinel:listen |
Listens to a player's in-game voice chat through your own game, while you watch them; needs the "listen" permission (owner only unless given). Every listen is in the staff record. |
sentinel:release |
Releases a player from quarantine. |
sentinel:replay |
Plays a case's recording back in the world for one staff member, in a private routing bucket with a free camera. |
sentinel:review |
Opens a case for an online player and keeps recording them for Config.Actions.recordSeconds after the last signal. |
sentinel:rollback |
Plans and applies the rollback of a case's unexplained gains through the framework, step by step, each result written to the case. |
sentinel:save |
Saves the last two minutes around a player as an archive named save- |
sentinel:trail |
Shows the money and item trail, the last changes of one player or account, and which scripts are trusted to explain gains. |
sentinel:victims |
Lists the players a confirmed case's subject harmed, tells them, and revives and returns them on request. A framework's own death state is not cleared. |
sentinel:wave |
Lists the bans queued for the ban wave, applies one now or cancels it. Queued bans are applied only in enforce mode. |
sentinel:appeal |
Records an appeal that reached staff another way (Discord, mail) in the ban's case. |
sentinel:appeals |
Lists open appeals, oldest first: case, date, number of messages, a preview. |
sentinel:decide |
Decides an open appeal. accept lifts every active ban of that account or case and cancels a queued wave ban; reject keeps the ban. A decision is final. |
sentinel:audit |
Reads every started resource and prints the security audit of the events clients can trigger. Saved in data/audit/. |
sentinel:guard |
Prints the line that guards a resource and whether its guard is running. It does not change any file. |
sentinel:observe |
Shows what the event observer has learned, the details of one event, and sets an owner limit for an event. |
sentinel:patch |
Sets, lists or removes guard rules (virtual patches) for one resource's events or framework callbacks. |
sentinel:integrity |
File integrity: a summary, the changes of one resource, a fresh check, or accept a resource's current files after you updated it yourself. |
sentinel:scan |
Script scanner: reads the code of every started resource, or one, for behaviour backdoors use. |
sentinel:shield |
Prints the join shield's limits and counters and the account age settings. |
sentinel:staff |
Prints the staff record, or writes the report of the last 7 days to data/reports/. |
sentinel:combat |
Prints the combat rules' counters, kill limit and aim statistics. |
sentinel:witness |
Prints the client witness counters and, per player, the latest challenge results. |
Setup and health
sentinel:advisor
Prints every hardening check: current value, recommended value, what it blocks, what it might break and the line to copy into server.cfg.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:advisor |
the full advisor report |
sentinel:diag
Prints what Sentinel decided and why: storage, crypto, mode, rules, scheduler timings and the latest decisions.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:diag |
storage, crypto, mode, rules, scheduler, last decisions |
sentinel:diag perf |
scheduler timings per job (p50 / p95 / p99 in microseconds) |
sentinel:diag decisions N |
the last N detection decisions with their sentences |
sentinel:diag player ID |
what Sentinel knows about one player |
sentinel:diag rules |
every rule with its state and counters (raised, explained, shadow, scored, errors) |
sentinel:diag storage |
the storage backend, its queue and why it was chosen |
sentinel:discord
Shows the Discord bot: connected or not, the guild and channels it uses, linked staff; unlinks a Discord user from the console.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:discord |
bot state and linked accounts |
sentinel:discord links |
every linked Discord user and game account |
sentinel:discord unlink <discord user id> |
remove a link (console) |
sentinel:health
Prints the startup box again, every row included.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:health |
the full startup box |
sentinel:level
Shows or changes the protection level at once and saves it (the same switch as the owner desk). The saved level wins over Config.Protection after a restart.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:level |
the current level, its mode and who set it |
sentinel:level watch\|recommended\|strict |
switch to that level and save it |
sentinel:link
Prints a one-time code for a staff member to link their Discord account: they type /link in Discord. Single use, 10 minutes.
Who: server console, staff whose Sentinel role allows it (checked in game).
| Form | What it does |
|---|---|
sentinel:link |
your link code (staff, in game) |
sentinel:lockdown
Shows or changes entity lockdown on the main world (routing bucket 0) while the server runs. Sentinel puts the original mode back when it stops.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:lockdown |
show the current lockdown and who set it |
sentinel:lockdown relaxed |
refuse entities created by client scripts |
sentinel:lockdown inactive |
no lockdown |
sentinel:lockdown strict confirm |
refuse every client-created entity; asks for confirm first, because traffic and pedestrians have not been measured under it |
sentinel:map
The terrain grid of the 3D duty map: whether it is measured, when and by whom. The first staff member in game measures it on their own; this asks again.
Who: server console, staff whose Sentinel role allows it (checked in game).
| Form | What it does |
|---|---|
sentinel:map |
the grid state and the last measuring run |
sentinel:map sample <id> |
measure the island again with the game of that player (about 20 s) |
sentinel:mode
The older words for the protection levels: watch = watch, review = recommended, enforce = strict. Saved like sentinel:level.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:mode watch\|review\|enforce |
switch to that level and save it |
sentinel:owner
The owner seat. On the first start Sentinel prints a one-time code in the server console; the owner types it in game to claim the seat.
Who: server console, staff whose Sentinel role allows it (checked in game).
| Form | What it does |
|---|---|
sentinel:owner |
show who holds the seat (console) |
sentinel:owner code |
print a fresh code when no owner is set (console) |
sentinel:owner reset |
clear the seat and print a new code (console) |
/sentinel owner <code> |
claim the seat in game with the code from the console |
sentinel:panel
Opens the browser panel: prints a one-time sign-in code (works once, for 5 minutes) for a player or a staff account, lists open panel sessions, or ends them.
Who: server console, staff whose Sentinel role allows it (checked in game). Restricted.
| Form | What it does |
|---|---|
sentinel:panel <server id \| account> \| sessions \| end <account\|all> |
(the usage line the command prints) |
sentinel:panel <server id \| account> |
a sign-in code for that person (an account: shown in this console only) |
sentinel:panel sessions |
every open panel session |
sentinel:panel end <account \| all> |
sign out one account or everyone |
sentinel:storage
Shows where clips and photos go (FiveManage, Discord, off), the upload queue and the last failures. Keys are never printed.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:storage |
storage state and queue |
sentinel:webhook
Shows the Discord webhook state and counters. The URL itself is never printed.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:webhook |
state, source (convar or store), sent, failed, queued |
sentinel:webhook test |
send a test message, then show the state |
sentinel:webhook set <url> |
store a webhook URL (server console only) |
sentinel:webhook clear |
remove the stored URL (server console only); a sentinel_webhook convar still applies |
Staff work: cases, evidence, bans
sentinel:ban
Queues a ban for a case from the server console (the owner without a game client).
Who: server console, staff whose Sentinel role allows it (checked in game). Restricted.
| Form | What it does |
|---|---|
sentinel:ban <case id> |
queue the ban for the next wave |
sentinel:case
Prints a case: subject, evidence with SHA-256 fingerprints, the log, and whether the hash chain over the log still verifies.
Who: server console, players with sentinel.admin (Config.Ace.admin). Restricted.
| Form | What it does |
|---|---|
sentinel:case <case id> |
print that case |
sentinel:console
Opens the staff console in game. The same as the console key. Players only, not the server console.
Who: staff whose Sentinel role allows it (checked in game).
| Form | What it does |
|---|---|
sentinel:console |
open the console |
sentinel:listen
Listens to a player's in-game voice chat through your own game, while you watch them; needs the "listen" permission (owner only unless given). Every listen is in the staff record.
Who: server console, staff whose Sentinel role allows it (checked in game).
| Form | What it does |
|---|---|
sentinel:listen <server id> |
start listening |
sentinel:listen off |
stop |
sentinel:release
Releases a player from quarantine.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:release <server id> [note] |
move them back and close the quarantine |
sentinel:replay
Plays a case's recording back in the world for one staff member, in a private routing bucket with a free camera.
Who: server console, players with sentinel.admin (Config.Ace.admin). Restricted.
| Form | What it does |
|---|---|
sentinel:replay <case id> [viewer server id when run from the console] |
open the replay for yourself; from the server console, for the player with that server id |
sentinel:review
Opens a case for an online player and keeps recording them for Config.Actions.recordSeconds after the last signal.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:review <server id> [note] |
open a review case with an optional note |
sentinel:rollback
Plans and applies the rollback of a case's unexplained gains through the framework, step by step, each result written to the case.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:rollback <case> plan [minutes] |
what the subject gained in the incident window, what they passed on to other characters (one hop) and what victims lost to them; prints the plan and a confirmation code |
sentinel:rollback <case> apply <code> [skip 2,5] |
applies that plan through the framework adapters |
sentinel:rollback <case> resolve <op> committed\|rejected |
staff settle a step whose outcome was unknown |
sentinel:save
Saves the last two minutes around a player as an archive named save-
Who: server console, players with sentinel.admin (Config.Ace.admin). Restricted.
| Form | What it does |
|---|---|
sentinel:save <server id> |
save the archive for that player |
sentinel:trail
Shows the money and item trail, the last changes of one player or account, and which scripts are trusted to explain gains.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:trail |
ledger size, counters and trusted scripts |
sentinel:trail <server id \| account> [count] |
the last changes (default 20, at most 200) |
sentinel:trail trust <resource> |
that script's events now explain money and item gains |
sentinel:trail untrust <resource> |
stop trusting it |
sentinel:victims
Lists the players a confirmed case's subject harmed, tells them, and revives and returns them on request. A framework's own death state is not cleared.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:victims <case> |
list the victims |
sentinel:victims <case> confirm |
list, write to the case and notify |
sentinel:victims <case> add <id> |
add a victim by server id |
sentinel:victims <case> restore <id \| all> |
revive and return |
sentinel:victims notify on \| off |
victim messages (saved) |
sentinel:wave
Lists the bans queued for the ban wave, applies one now or cancels it. Queued bans are applied only in enforce mode.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:wave |
list queued bans with their due time |
sentinel:wave now <account> |
apply that queued ban now (enforce mode only); the case is read first, and a closed case drops the ban |
sentinel:wave cancel <account> |
cancel that queued ban |
Appeals
sentinel:appeal
Records an appeal that reached staff another way (Discord, mail) in the ban's case.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:appeal <code> <text> |
record the text under the ban with that appeal code |
sentinel:appeals
Lists open appeals, oldest first: case, date, number of messages, a preview.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:appeals |
list open appeals |
sentinel:decide
Decides an open appeal. accept lifts every active ban of that account or case and cancels a queued wave ban; reject keeps the ban. A decision is final.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:decide <case id \| appeal code> accept [note] |
lift the ban(s) and close the case |
sentinel:decide <case id \| appeal code> reject [note] |
keep the ban; later messages for it are not recorded |
Event firewall and guard
sentinel:audit
Reads every started resource and prints the security audit of the events clients can trigger. Saved in data/audit/.
Who: server console, staff whose Sentinel role allows it (checked in game). Restricted.
| Form | What it does |
|---|---|
sentinel:audit |
run the audit |
sentinel:guard
Prints the line that guards a resource and whether its guard is running. It does not change any file.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:guard <resource> |
print the guard line for that resource and its status |
sentinel:guard |
list the resources whose guard is running |
sentinel:observe
Shows what the event observer has learned, the details of one event, and sets an owner limit for an event.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:observe limit <event> <calls per 10 s \| off> |
set or remove your own limit for an event (judged by the event_rate rule) |
sentinel:observe |
summary |
sentinel:observe <event> |
where the event comes from, its roles, learned rate and shape |
sentinel:observe rescan |
read every started resource again |
sentinel:patch
Sets, lists or removes guard rules (virtual patches) for one resource's events or framework callbacks.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:patch <resource> <event> <json rule> |
set the rule for one event; write callback: |
sentinel:patch <resource> <event> off |
remove that rule |
sentinel:patch <resource> |
list its rules and whether it is guarded |
Watchers
sentinel:integrity
File integrity: a summary, the changes of one resource, a fresh check, or accept a resource's current files after you updated it yourself.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:integrity |
summary and changed resources |
sentinel:integrity <resource> |
what changed in that resource |
sentinel:integrity check [resource] |
hash again now (one or all) |
sentinel:integrity accept <resource> |
its current files become the new base |
sentinel:scan
Script scanner: reads the code of every started resource, or one, for behaviour backdoors use.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:scan |
scan every started resource |
sentinel:scan <resource> |
scan one and print its findings |
sentinel:scan status |
the last result |
sentinel:shield
Prints the join shield's limits and counters and the account age settings.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:shield |
status |
sentinel:staff
Prints the staff record, or writes the report of the last 7 days to data/reports/.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:staff [count] |
the last entries (default 20, at most 200) |
sentinel:staff report |
write the 7-day report now |
Rule details
sentinel:combat
Prints the combat rules' counters, kill limit and aim statistics.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:combat |
counters |
sentinel:combat weapons |
also the weapon table with learned scales |
sentinel:witness
Prints the client witness counters and, per player, the latest challenge results.
Who: server console, players with sentinel.admin (Config.Ace.admin).
| Form | What it does |
|---|---|
sentinel:witness |
counters and every player |
sentinel:witness <server id> |
one player, with their decoys |