Tutorial / Admin panels > Utilities
Reports
Read and handle player reports sent with !report: go to the reporter, review their last death, start a sit, resolve or delete.
What it does
Players send reports with !report <text> in chat. Reports collects them in one list, so admins can read, act on and resolve them.
Each report keeps the reporter's position and map. If the reporter died in the 5 minutes before, it also keeps that death and their damage log lines. Online admins get a chat line and a notice for every new report.
Where to find it
Q menu > KGX's Admin Toolbox > Utilities > Reports.
Toolbox admins can use it. Players can get it through Settings > Player Access with the Reports (read and resolve) tick.
Every player can send a report with !report <text> or /report <text>.
The panel
| Item | What it does | Default |
|---|---|---|
| Show resolved reports | Also lists resolved reports, marked [Resolved]. | Off |
| Report list | Columns #, When, From and Report, newest first. | |
| Line below the list | Shows how many reports are open. Select a report to read it in full here. | |
| Refresh | Loads the latest reports. | |
| Delete all resolved reports | Asks to confirm, then deletes every resolved report. |
A selected report shows its number, the reporter's name and SteamID, the map, who resolved it, and the full text. When available, it also shows the reporter's last death (killer, weapon, distance, who hit first) and their damage log lines from the 5 minutes before.
Right-click a report
| Option | What it does |
|---|---|
| Go to reporter | Teleports you to the reporter. If they are offline, to where the report was made (same map only). |
| Review the reporter's last death (hits, replay)... | Opens the kill review. Only while that kill is still kept on this map. |
| Start a sit with the reporter | Starts a sit. Needs Sit Room access and the reporter online. |
| Admin notes of the reporter... | Opens their admin notes. Needs Admin Notes access. |
| Mark resolved / Reopen | Marks the report resolved with your name, or opens it again. |
| Copy SteamID | Copies the reporter's SteamID. |
| Copy report text | Copies the text. |
| Delete | Deletes the report at once, without asking. |
How to use it
Handle a new report
- Open Utilities > Reports when the "New report" notice appears.
- Click the report to read it in full below the list.
- Right-click it and pick Go to reporter or Start a sit with the reporter.
- When it is dealt with, right-click and pick Mark resolved.
Check an RDM report
- Select the report and read the last death and damage log lines below the list.
- Right-click and pick Review the reporter's last death (hits, replay)....
Clean up the list
- Tick Show resolved reports to check what is done.
- Press Delete all resolved reports and confirm with Delete.
Settings and commands
| Command | Who | What it does |
|---|---|---|
!report <text> |
Everyone | Sends a report to the admins. Up to 300 characters. |
Tips and limits
- A player can send one report per minute. Otherwise they see "Please wait N seconds before sending another report."
- The server keeps the newest 200 reports in
data/kgx_admin_toolbox/reports.json. They survive restarts and map changes. - Admins with access who join are told how many reports are open.
- Reports are written to the Action Log and to the reporter's history.
- Resolving, reopening and deleting are written to the Action Log.
- Players can contact admins in chat with
@messageas well.