Minecraft anticheat guide
Anticheat Handover Notes for New Minecraft Admins
A handover template for new Minecraft admins covering anticheat versions, config files, punishment state, alert recipients, reload rights, and open decisions.
What should an anticheat handover note cover?
A handover note tells a new admin what the anticheat is set to do, why it is set that way, where the files live, and who can change them. Keep one note, update it on every configuration change and version change, and keep secrets and player data out of it. The template below is a starting point you can adapt.
Handover template
Fill each row from the live files and the console, not from memory. If a value is unknown, write unknown and add it to open decisions.
| Field | What to write | Example entry |
|---|---|---|
| Installed versions | Server software build, Java runtime, FairPlay, PacketEvents | Paper build, Java version, plugin versions |
| Configuration location | Folder path and the three policy files | plugins/<fairplay-folder>/config.yml |
| Automatic punishment state | Kick and ban on or off, with the date changed | Kick: off, Ban: off, changed on the launch date |
| Alert recipients | Roles that hold fairplay.notify | Staff-alerts group |
| Reload rights | Roles that hold fairplay.command.reload | Admins group |
| Known false-positive cases | Case IDs and the check involved, no private player data | Link to case log |
| Open decisions | Questions still waiting on an owner | Bedrock handling policy |
| Contacts | Owner and the support route for the anticheat | Owner name and vendor support channel |
How do you write and verify the note?
A note is only useful if the new admin can act on it. Have the outgoing admin review it, then have the new admin repeat the checks in a staging copy.
How does a new admin check their permissions?
Permission checks are faster than guessing. In LuckPerms, you can check whether a user holds a node directly from the console or in game. Run the check before you grant reload rights, then grant them through the group that owns that responsibility.
/lp user new-admin permission check fairplay.command.reload
/lp user new-admin permission check fairplay.notifyWhere do secrets and player data belong?
Do not paste webhook URLs, passwords, or raw player logs into the handover note. FairPlay's docs say player logs can contain violations, chat, joins, and leaves, so the note should say where logs live and who may open them, not show their contents. Store secrets in your password manager and reference the entry by name.
If a new admin needs the actual values, share them through the access channel your staff already uses for secrets, and only after the admin has been granted that access. The handover note should tell them where to look, not hand them the values in plain text.
How do you keep the note current?
A handover note goes stale the first time someone changes a setting without writing it down. Put the note in the same place the staff already check, and make the update step part of every configuration change. Review the whole note once a quarter, or sooner after a wave, a version update, or a staff change. Each review should confirm that the versions, file paths, and permission holders still match the live server.
When you find a mismatch, fix the note first, then the server, and record which one was wrong. A mismatch usually means someone made a change outside the process, and that is worth a short conversation with the staff who made it. Keep that conversation about the process, not about blame, so the next change gets written down instead of hidden.
What have we not verified?
This template does not cover your custom rules, your staff ladder, or any setting that your host changes. It also does not confirm how the anticheat behaves on your server. Your staging run and your review records are the evidence.
FAQ
Should a new admin get reload rights on day one?
That is your decision. Give reload rights after the new admin has read the configuration files and tested a reload in staging, and record the date you granted them.
Where do player logs go in a handover?
Write the storage location and the names of people allowed to open them. Do not copy log contents into the note, because they can include chat and join history.
How often should the note be updated?
Update it after every configuration change, every version update, and every change to who holds alert or reload permissions.
What if the outgoing admin has already left?
Rebuild the note from the live files, the console, and your backups. Compare the backup values with the live values, and record any difference as an open decision for the owner.