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.

For ZeroDev Sentinel 0.1.214 min readUpdated

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

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: as the event for an ox_lib, ESX or QBCore 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