Direct answer

Upgrading the Minecraft game version changes world data, registry formats and plugin/mod compatibility. Plan a staged upgrade with a restorable backup; changing the JAR alone is not a complete migration.

Recommended procedure

  1. Record the running game, server software, Java, plugin and mod versions.
  2. Read server software release notes and identify any incompatible mods, plugins, datapacks and world-generation features.
  3. Stop the server and create an offline backup of worlds, player data, plugin databases and configurations.
  4. Clone production into a staging environment; install the matching new JAR, runtime and dependencies there first.
  5. Join staging with a supported client, inspect inventories and chunks, then migrate production in a controlled maintenance window.

Why this matters

World upgrades can alter region files and data versions. After opening the world in a newer version, running an older JAR against those files may damage them or simply fail.

Practical example: Example: before upgrading a modded server, create a test clone and have one player inspect an existing storage room, another explore new chunks and an administrator verify claims and inventories. These three tests exercise different failure modes. Do not replace the original backup with the already-upgraded test copy.

How to verify the result

  • Check server startup, console errors, player inventory/permissions, new chunk generation and representative plugin features.
  • Measure performance under comparable player loads where possible.
  • If the update fails, restore the complete pre-upgrade backup instead of downgrading the executable alone.

Version and compatibility notes

  • Follow the version-specific Java requirement of the actual server software.
  • Avoid a bulk upgrade of several game versions without testing the migration path.

Official references

These sources were checked for the current MSH revision. Version-sensitive details should always be confirmed against the project documentation for the release you run.

Was this article helpful?
Help us improve this article

Tell us what is missing, unclear, outdated, or incorrect. You can also suggest something we should add.

What could we improve?
Do not include passwords, server IPs, or other private information.0 / 1000