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.

Flush and copy on a running Paper server, then resume saves.
save-off
save-all flush
# copy the server directory now, for example:
# rsync -a /srv/mc/ /srv/mc-backup-2026-11-07/
save-on

Check 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.

Dependencies to verify before the staging run.
ComponentWhat to confirmWhere to record it
Paper or Spigot buildTarget Minecraft version is listed as supported by each pluginStaging notes file
PacketEventsRequired version for your anticheat, per that anticheat's docsStaging notes file
Anticheat pluginRelease notes for the target server build and any known issuesStaging notes file
Protocol bridges (for example ViaVersion)Whether client version support changed for players you serveStaging notes file
Bedrock bridge (Geyser and Floodgate, if used)Compatibility with the target Java versionStaging 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.

Search the latest Paper log for errors after a staging restart.
grep -nE 'ERROR|Exception|Caused by' logs/latest.log | head -n 50

Write 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.

Related sources and official pages

Browse all anticheat guides