Minecraft server help centre

Getting started

How to change or update your Minecraft server version

Changing the Minecraft version of your server takes one field in Settings. What needs thought is everything around it: your world, your plugins or mods, and the version your players start the game with.

In short

To change your Minecraft server version, make a backup and check that your plugins or mods support the new version. Then open Settings, set the Minecraft version under Server software to latest or an exact release, save and restart; the world, settings and play address stay. Going back to an older version needs the backup from before the update, and every Java player has to start the game with the version of the server.

Before you change the Minecraft server version

  • Make a backup. A world that has been opened in a newer version cannot safely go back to an older one, so the backup is your way back. See back up and restore your server.
  • Check your plugins or mods. Each one needs a build for the new version. Their download page lists the versions they support.
  • Tell your players. Everyone on Java has to start the game with the same version as the server.
The Backups tab with a name typed for a new backup and the Create backup button
Make a backup first and give it a name you will recognise, such as the version you are leaving.

Change the Minecraft version in Settings

  1. Open the control panel of your server and go to Settings.
  2. Under Server software, set Minecraft version to latest for the newest release, or type the exact release you want.
  3. Save the change. The matching Java version is set with it.
  4. Restart the server and watch the Console. The first start on a new version takes a little longer while the world is upgraded.
The Server software card in Settings with the server type and the Minecraft version field
Type latest or an exact release. Installed plugins and mods must support the version you choose.

Your world, settings and play address stay as they are. Only the server software changes. Which Java version your server needs explains the Java side, in case you ever set it by hand.

Minecraft versions you can run, and what each is good for

These Java versions can be picked for a server. The Java version that belongs to each one is set for you.

Minecraft versionJavaWhy people pick it
latest, 26.2, 26.1.2, 26.1.1Java 25The newest blocks, mobs and features
26.3Java 25The very newest release, for Vanilla and Fabric while Paper catches up
1.21.11, 1.21.8, 1.21.4Java 21Plugin servers that wait for their plugins to support 26.x
1.21.1Java 21Many current NeoForge modpacks
1.20.6, 1.20.4Java 21 and Java 17Older plugin servers and smaller modpacks
1.20.1Java 17A large share of Forge modpacks, many of them built around Create
1.19.4, 1.18.2Java 17Modpacks and maps made for those versions
1.16.5Java 8Classic Forge modpacks
1.12.2Java 8Old tech and magic modpacks
1.8.9Java 8Classic PvP from before the attack cooldown

1.20.6 runs on Java 21 and 1.20.4 on Java 17; the panel takes care of the difference. The Java version for each Minecraft version has the full table.

Minecraft version numbers explained: from 1.21.11 to 26.1

After 1.21.11, Mojang switched to version numbers based on the year. 26.1 is the first big release of 2026, 26.2 the second, and so on. A third number, as in 26.1.2, is a smaller fix release of that version.

For a server the rule stays the same: the server and the players' game need the same version, or a plugin such as ViaVersion that bridges the difference.

Updating: what happens to your Minecraft world

When a newer version loads your world for the first time, it converts the saved chunks to the new format. Land you already explored keeps its shape. New biomes, blocks and structures from the update appear in chunks generated after the update, so players have to travel to new land to find them.

Pre-generated land counts as explored. If you pre-generated a large area, new terrain features only appear outside it.

How to get new biomes and structures in an old Minecraft world

Since 1.18, Minecraft blends the edge between old land and newly generated land, so the border between the two looks natural. Still, the new features only appear where land is generated for the first time. Three ways to get them:

  • Travel further out. Everything beyond the explored area is generated with the new version.
  • Widen the world border and pre-generate the new ring, so players find fresh land close to home.
  • Remove chunks nobody used. With a backup in hand, a tool such as MCA Selector can select the chunks players spent only a few minutes in and delete them. Minecraft generates them again with the new version, while bases stay untouched.

Removing chunks cannot be undone without the backup. Download the world first, and try it on a copy before you upload the result.

Going back to an older Minecraft version

Minecraft does not support opening a world in an older version than the one it was last played on. The server may start, but chunks, items and entities can break or disappear.

  1. Set the older version in Settings.
  2. Restore the backup you made before the update, from the Backups tab.
  3. Start the server.

If you have no backup from before the update, a fresh world on the older version is the only clean option.

Plugins and mods after a Minecraft version change

  • Paper and Purpur: most plugins keep working across the small releases of one version, but a big update often needs new builds. Update them in the Plugins tab. A plugin that is not ready yet shows errors in the console at startup and stays off.
  • Fabric, Forge and NeoForge: every mod needs a build for the exact Minecraft version and loader. Most Fabric mods also need the Fabric API for that version.
  • Modpacks: do not change the Minecraft version by hand. Pick a newer version of the pack instead, as in install a modpack; that sets the right loader and Minecraft version for you.

On the day a big update comes out, vanilla and Fabric are usually ready first. Paper and many plugins need some days or weeks. If your server depends on plugins, wait until each of them lists the new version.

Fix Incompatible client, outdated client and outdated server

What players seeWhat it meansFix
Incompatible client! Please use and a version numberThe player's game and the server run different versions.Start the game with the version the message names.
Outdated client, in older versions of the gameThe player's game is older than the server.Update the game in the launcher.
Outdated server, in older versions of the gameThe server is older than the player's game.Update the server, or let the player start the server's version.
The server's version in red in the server listThe same mismatch, seen before joining.The same fixes.

To play an older version in the Minecraft Launcher, open Installations, click New installation, choose the server's version and click Create. Start the game from that installation.

On Paper and Purpur, the ViaVersion plugin lets players with a newer game join an older server, and ViaBackwards does the reverse. Mods cannot be bridged like that: on a modded server every player needs the server's exact version. Can't connect to your server covers the other reasons a join fails.

Update a Bedrock or crossplay server

Bedrock players update automatically, so a Bedrock or crossplay server has to keep up rather than choose a version.

  • Crossplay: the server is Java, so its version follows the steps above. What has to follow Bedrock is Geyser. Update Geyser and Floodgate in the Plugins tab when Bedrock players suddenly cannot join after a Bedrock update.
  • Bedrock: when players see that the server is outdated, select the newest version under Server software in Settings and restart. Our support team can help if the newest Bedrock release is not listed yet.

When Geyser falls behind a new Minecraft version, Bedrock players are the first to be turned away; Java and Bedrock crossplay explains why.

Questions from Minecraft server owners

Will updating my Minecraft server delete the world?

No. The world is converted the first time the new version loads it. Make a backup first all the same, because going back to the older version needs that backup.

How do I see which version my Minecraft server runs?

In Settings under Server software, and in the first lines of the Console when the server starts.

Should I update my Minecraft server as soon as a new version comes out?

Only when everything you use is ready. A vanilla server can update on day one. A server with plugins or mods is better off waiting until each of them lists the new version.

Can players on different Minecraft versions play together?

Not on a plain server. On Paper or Purpur, ViaVersion and ViaBackwards let nearby versions join the same server. On a modded server everyone needs the same version.

What does 26.1 mean in Minecraft?

Since 2026 Minecraft versions are numbered by year: 26.1 is the first big release of 2026 and 26.2 the second. It comes after 1.21.11 and needs Java 25 on the server.

Why are the new biomes missing after I updated my Minecraft server?

New features only appear in land that is generated after the update. Explore further out, widen the world border, or remove unused chunks from a copy of the world so they are generated again.

Do I need to update my plugins after a Minecraft update?

After a big update, usually yes. Check the Updates box in the Plugins tab, and wait with the server update until every plugin you depend on lists the new version.

Which Minecraft version is best for a modded server?

The one your modpack or mods are made for. Today that is often 1.21.1 for NeoForge packs and 1.20.1 for Forge packs; check the pack page before you set the version.

Checked against the Settings and Backups tabs of our control panel, September 2026. Written by the Cheapest Minecraft Hosting team, first published , updated .