Troubleshooting

The key does nothing

The client needs the mod too. It is in the server’s mod list, so the game downloads it on join; make sure the join finished. Then check nothing else is bound to F11 under Settings, Controls, KOVA Admin Tools.

The password did not open the tools

Either the password is wrong, allowServerAdminLogin is off, or the server has no passwordAdmin. The game itself answers #login with an error when the password does not match.

I added myself to a role and nothing happened

The settings file is read about once a minute; #kova reload reads it now if somebody else has access. Check the server log for a line about a malformed role: a role that fails to parse is skipped and named there. Check the ID is the Reforger player ID, a UUID, and not a platform ID.

An admin cannot give Game Master

The greyed button names what is missing. The usual causes:

• The admin’s role lacks Give Game Master and does not hold everything the Game Master role carries.
• gmGrantRole points at a role the mod refused because it carries more than Game Master powers. The server log and the panel say so. Point it back at gamemaster.

A Game Master keeps getting it back

They hold a role that carries Use Game Master, or Auto Game Master for admins is on and they are an admin. Remove the role, or block Game Master for them on the Staff page.

A ban did not stick

Look in the KovaAdminTools folder at KovaAdminTools_StructuredBans.json, its .last-good.json, and any .corrupt.* beside them. If the Bans page reads Ban storage unavailable, the store needs repair before bans can change; existing bans still hold.

I removed someone from a role but they still have access

They may hold a second role, a role given in game (the Staff card shows who gave it), or be signed in with the server password. The Staff card lists every source.

The server log is filling up

Switch off recordKill first; it is the busiest family. Then recordLeave and recordJoin. Use quietConsoleEvents to keep a family in the record while stopping its console line.

Reports are missing

A report needs the reported player on the server and a reason, and a player can have three open at once. The chat line goes only to staff online with See the staff list; everyone else finds it on the Reports page.

What to send to support

Problem	Send
The tools will not open, or a page is missing	Heartbeat.json, Manifest.json, Config.json, Roles.json, and the server log
A role does not carry what you expect	Config.json, RoleDefinitions.json, Roles.json
A ban did not stick, or bans cannot be changed	StructuredBans.json, its .last-good.json, any .corrupt.*.json, and the server log
A panel command did nothing	Inbox.json, Inbox.receipts.json, InboxCheckpoint.json
Messages or announcements are wrong	Config.json and Messages.json
Anything about a decision	Audit.ndjson and DecisionEvents.ndjson around the time it happened

All of these are in the KovaAdminTools folder and start with KovaAdminTools_. Say which version you run; the Settings page shows it.

Warning. Never delete a .corrupt.* or .recovery.json file before sending it. A repair works from them.

Support

The KOVA Discord, or support@kova.host.