Change Your Minecraft Server Version
How to upgrade, downgrade, or switch your Minecraft server to a different version.
Changing Version via the Panel
- In the XGamingServer Panel, click Startup
- Find the Minecraft Version or Server Version field
- Enter the desired version (e.g.,
1.21.4,1.20.1) - Check if you need to change the Java version too
- Restart your server
Important Warnings
- Always back up your world before changing versions
- Upgrading (1.20 → 1.21) is generally safe — Minecraft upgrades world data automatically
- Downgrading (1.21 → 1.20) is risky — newer blocks/items may corrupt the world
- All players must run the same version as the server
Java Version Compatibility
| Minecraft Version | Required Java |
|---|---|
| 1.7.10 – 1.16.5 | Java 8 |
| 1.17 – 1.17.1 | Java 16 |
| 1.18 – 1.20.4 | Java 17 |
| 1.20.5 – 1.21+ | Java 21 |
If you change MC version, you may need to change Java too. See Java Version Guide.
Mod & Plugin Compatibility
- Mods and plugins are version-specific — most won't work across major versions
- Check mod/plugin pages for supported versions before switching
- Remove incompatible mods from the
mods/orplugins/folder before starting
💡 Tip: To let players on different versions connect, see ViaVersion (allows older clients to join newer servers).
Related Guides
How is this guide?

40% Off — Limited TimeGet your Minecraft server todayInstant setup, DDoS protection, and 24/7 support included.
Get a Server