Minecraft anticheat guide
Minecraft Version Update Checklist for Anticheat Servers
Stage a new Minecraft or Paper version with a cloned world, anticheat release-note checks, an alert-only period, and a tested rollback before production.
Stage the new version before the live server moves
Run the new Minecraft or Paper build on a copy of your live server before production. Clone the world and configuration, confirm every anticheat dependency supports the target release, run an alert-only period with known-legitimate testers, and keep a rollback path you have tested. Promote the update only after the staging gate passes.
This checklist does not assume any anticheat supports a given version. Read each project's release notes for the exact build you plan to run.
Clone the world and configuration first
Stop the live server or pause writes before copying. Keep the copy with a date and the exact Paper build and plugin jar versions in its name or in a notes file. A copy you cannot identify later is not a rollback point.
Copy the whole server directory, including the world folders for the overworld, nether, and end, plus the plugin folders and their configuration. Do not rely on a single world backup.
save-off
save-all flush
# copy the server directory now, for example:
# rsync -a /srv/mc/ /srv/mc-backup-2026-11-07/
save-onCheck release notes for every dependency
An anticheat can depend on more than the server jar. Build a short inventory and check each item against its release notes or documentation before you install anything. Record the version you tested, not the latest version on a download page.
| Component | What to confirm | Where to record it |
|---|---|---|
| Paper or Spigot build | Target Minecraft version is listed as supported by each plugin | Staging notes file |
| PacketEvents | Required version for your anticheat, per that anticheat's docs | Staging notes file |
| Anticheat plugin | Release notes for the target server build and any known issues | Staging notes file |
| Protocol bridges (for example ViaVersion) | Whether client version support changed for players you serve | Staging notes file |
| Bedrock bridge (Geyser and Floodgate, if used) | Compatibility with the target Java version | Staging notes file |
Run an alert-only staging period
Turn on the new build with punishments disabled. Alerts still show what the checks see, so you can compare behavior without enforcement. Use the same settings as production except the punishment and mitigation switches.
Compare alert volume against a baseline from your current live build, using the same kind of play. A number copied from a product page or forum post does not tell you what your players will trigger.
Scan the startup log for errors
Plugin load failures often appear only in the console or latest log. Search the log after every restart, not only the first one. Treat any new exception that names an anticheat, PacketEvents, or a protocol bridge as a blocker.
grep -nE 'ERROR|Exception|Caused by' logs/latest.log | head -n 50Write the rollback plan before the upgrade
Decide how you will return to the previous build before you start. Assume a world saved by a newer build may not load on an older one. Restore from the pre-upgrade copy instead of downgrading in place, and test the restore on staging once.
Promote only after the gate passes
Promote the build when all of these are true: the server starts with no new anticheat or bridge errors, the alert review found no unexplained spikes, the rollback restore has been tested, and staff know the punishment settings for production.
What we have not verified
This article does not test any Minecraft release, Paper build, or anticheat version combination. It does not state which versions FairPlay or any other plugin supports. Check the current release notes and your own staging results before making claims to players or staff.
FAQ
How long should the alert-only period last?
No fixed number is correct. Run it long enough to cover one normal peak period and a mix of your regular player activities, then decide from the recorded alert review rather than from elapsed time.
Can I skip staging for a patch release?
A patch can still change plugin behavior or break a dependency. Run the same startup and error scan, and a short alert-only check, even when the release is small.
Is a world copy enough to roll back?
No. Keep the matching server jar, plugin jars, and configuration with the world copy. A world without its matching build can fail to load or behave differently.