> ## Documentation Index
> Fetch the complete documentation index at: https://docs.purpify.host/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a Java world

> Move a Minecraft Java Edition world to a newer version safely on a Purpify server.

Back up the server, verify software compatibility, and upgrade the world only after selecting the newer Minecraft Java version. Treat a world upgrade as one-way.

## Update the world

<Steps>
  <Step title="Review compatibility">
    Confirm that the target Minecraft version supports your server software, plugins, mods, mod loader, datapacks, and world-generation settings. Update or remove incompatible content first.
  </Step>

  <Step title="Create an offline copy">
    Stop the server, create a [backup](/server/backups), and download the world when possible. Do not rely on a copy that the running server is still writing.
  </Step>

  <Step title="Select the newer version">
    Follow [Choose Java server software and version](/java/server-software) and select the target version. Avoid changing server software and Minecraft version in the same test when you can separate the changes.
  </Step>

  <Step title="Start once and inspect the console">
    Allow the server to convert and save the world. Do not interrupt it during conversion. Stop and restore the backup if the console reports an incompatible world or repeated conversion failure.
  </Step>

  <Step title="Test important areas">
    Check player data, spawn, dimensions, commands, farms, plugins, mods, and datapacks. New terrain features normally appear only in chunks generated after the upgrade.
  </Step>
</Steps>

<Warning>
  Do not open the upgraded world in an older Minecraft version. Downgrading can remove blocks, entities, items, or entire chunks.
</Warning>