How to Change Your Minecraft Server Version

To change Minecraft server version, make a backup, stop the server, install the server JAR for the version you want and start it again. On TheGameHosting the Version Changer does the swap: pick the platform and the version and click Install. Going up is routine; going down on a world that already exists is where worlds get damaged.

This guide covers switching to any version, newer or older, and switching platform (for example Vanilla to Paper). If you only want to move to the latest release, our Minecraft server update guide goes deeper into plugin checks and the Paper update folder.

Upgrade or downgrade: what happens to your world

The Minecraft Wiki on downgrading is clear: opening a world in an older version can corrupt it, wipe chunks or player inventories and crash, and upgrading again does not undo the damage. The singleplayer game shows a warning before it happens. A server shows none: it simply loads what is in the folder.

Before you change the version

1. Make a backup in Backups → Create backup and name it with the current version, for example “1.21.11 before change”. Our guide to back up a Minecraft server world explains what it includes.
2. Check plugins and mods. Each one needs a build for the target version. Mods also have to match on every player's game.
3. Check Java. Minecraft 1.20.5 to 1.21.11 needs Java 21, and 26.1 or newer needs Java 25. Old modded versions such as 1.12.2 want Java 8. See how to change the Java version.
4. Tell your players which version to use, because their game has to match the server.

How to change Minecraft server version in the panel

1. Stop the server from the Console.
2. Open Version in the side menu.
3. Choose the platform: Vanilla, Paper, Purpur, Fabric, Forge, NeoForge or any of the 28+ in the list. Use Custom JAR if you need your own file.
4. Select the Minecraft version and click Install.
5. If the new version needs a different Java, change it in Startup → Docker Image.
6. Start the server and watch the Console. Plugin or mod errors appear there in the first seconds.
7. Join, check your world, then let your players in.

You can add a co-admin in Users so they can change the version or restore a backup without your password.

Changing the version by hand

On your own PC or a machine without a panel, the version is simply the JAR you start:

1. Download the server JAR for the version you want: Vanilla from the official Minecraft server page, Paper from the PaperMC downloads page, or the installer of your mod loader.
2. Type stop in the console and wait until it closes.
3. Replace the old JAR, or point your start command to the new file name.
4. Start the server and read logs/latest.log.

java -Xms2G -Xmx2G -jar paper.jar --nogui

A modded server is not just one JAR: Fabric, Forge and NeoForge need the loader for the target version and every mod rebuilt for it. A modpack should only change version when its author publishes a matching release.

How to go back to an older version safely

There is only one safe way down: the backup you made before the upgrade.

1. Stop the server.
2. Choose the old version in Version and install it.
3. Restore the backup taken on that version. Our guide to restore a Minecraft server world walks through it.
4. Start the server and check the world.

Anything built after the upgrade is lost with this method. If you have no backup from the old version, the alternatives are to stay on the new version or start a fresh world on the old one. When the only problem is that some players are on another version, you may not need to change at all: ViaVersion lets newer clients join an older server, and ViaBackwards lets older clients join a newer one.

Common errors after a version change

• “Outdated client” or “Outdated server”: the player's game does not match the server version.
• UnsupportedClassVersionError: the server needs a newer Java. Change it in Startup.
• A plugin is disabled on start: it has no build for the new version yet. Update it or wait.
• Modded blocks are gone: a mod was missing on start. Restore the backup, install the mod and try again.

Switch versions in one click on TheGameHosting

A Minecraft server from TheGameHosting includes the Version Changer with 28+ platforms and Custom JAR, plus one-click backups so every change can be undone. The server runs 24/7 on AMD 9950X/7950X3D with DDR5 and NVMe in Dallas or Amsterdam, and one plan runs every game in the Game Changer. See plans and pricing and use code FULL2026 for 15% off for life.

FAQ

Hosting for these games

• Minecraft Java hostingPaper, Purpur, Fabric, Forge and more
• Minecraft Bedrock hostingPhones, consoles and Windows