Skip to the content
Docs

Admin Menus

On this page7

There is no admin-menu adapter, because there does not need to be one. Any admin menu can open our panel with a single server-side call.

lua
exports['5code-recognition']:OpenAdminPanel(source, targetA, targetB)
ArgumentRequiredWhat it is
sourceyesThe admin's server id.
targetAnoA player's server id.
targetBnoA second player's server id, to open the pair view between A and B.

Called with no targets (or only one), the panel opens on its overview. Called with two, it opens straight on the Pair page for A and B — which is the view staff actually want when they are handling a report.

Where it is known to fit

MenuSupportHow
EasyAdminSnippetA button in its player menu calling OpenAdminPanel.
vMenuSnippetSame.
qb-adminmenuSnippetSame.
ps-adminmenuSnippetSame.
your ownSnippetSame.

All of them are the same one-line call, from server code.

Direct commands

If you would rather not touch your admin menu at all, every panel view has a command:

CommandLevelWhat it does
/recognition:admin [idA] [idB]viewOpens the panel; with two ids, straight on the pair view.
recognition:check <idA> <idB>console / viewBoth directions, printed to the console. No UI.
recognition:statusconsole / viewRunning scans, detected scripts, voice trust.
recognition:verifyproofs [fromId]console / viewChecks that the tamper-evident proof log and admin log were not changed.
recognition:selftestconsole / viewThe installation self-test.
recognition:export <idA> <idB> [note]console / exportOne-click Discord export of a pair.
/recognition:tags [id]classifierWhat the game says about someone's clothes.
/recognition:debugsettingsDebug overlay on or off.

Rename any of them, or set it to false to turn it off, in Config.Commands. The full list is on Commands.

Permissions

The menu integration inherits the normal levels. Give staff roles the child ACE they need:

cfg
add_ace group.mod   recognition.admin.view   allow
add_ace group.mod   recognition.admin.export allow
add_ace group.admin recognition.admin        allow
LevelACEUnlocks
viewrecognition.admin.viewThe panel: overview, pair view, lookup, timeline, deaths list.
editrecognition.admin.editEditing and deleting memories, keeping or wiping memories after a death, handing out standalone items.
exportrecognition.admin.exportDiscord exports.
classifierrecognition.admin.classifierThe Clothing page (Auto-scan and review), /recognition:tags.
identityrecognition.admin.identityIdentity resets, free implants, cooldowns.
settingsrecognition.admin.settingsThe in-game settings editor, prune, debug.

Full detail: Admin & Permissions.

txAdmin

lua
Config.Admin.TxAdmin = true
Config.Admin.TxAdminPerms = { 'view' }

A txAdmin login counts as an admin, at the levels listed in TxAdminPerms — read-only by default.

txAdmin heals are also always read as an admin revive for the New Life Rule, on every ambulance script.

Framework groups

lua
Config.Admin.FrameworkGroups = { 'admin', 'god', 'superadmin' }
Config.Admin.GroupPerms = {}   -- e.g. { mod = { 'view' }, admin = 'all' }

Handy when your staff roles already live in the framework and you would rather not maintain a second ACE list. GroupPerms maps a group to specific levels; without it, a listed group gets the parent permission.

What the panel gives your staff

The panel has a tablet look with an icon sidebar. Each page:

PageWhat it answers
OverviewWhat is happening right now, the last 24 hours, and whether the proof log is intact.
PairWhat A knows about B and what B knows about A — two % rings, cue bars and short chips, details behind the (i). A LIVE badge while something is happening, a trend chart, and the Discord export button.
LookupFind anyone by name, server id, char key, device serial or report id. Suggestions show while you type; a "Search by" hint explains each kind.
TimelinePick a player first, then a day-by-day list with one short line per event. Click a line for details. Filters: 24h / 7d / 30d, and Scans, Proofs, Papers, Deaths, Admin.
DeathsThe New Life Rule review. The page explains itself; each death has Keep memories / Wipe memories buttons.
ClothingThe clothing classifier and Auto-scan, with summary tiles and filter chips. Needs classifier.
AuditThe admin log: who changed what, and why.
SettingsThe in-game config editor: plain titles, an (i) tip per setting, friendly group names and "reset to file". Needs settings.

See Admin Panel for a full tour.

Self-protection

KeyDefaultWhat it does
Config.Admin.BlockSelfViewtrueNo pair view, live watch or lookup of your own character.
Config.Admin.BlockSelfEdittrueNo edits of memories that involve your own character.
Config.Admin.LogViewstrueLog admin views, not just writes.
Config.Admin.RequireReasontrueEvery write needs a written reason.