/

/

/

Upload an existing Minecraft world

Upload an existing Minecraft world

Applies to: All servers · All plans

If you have a world from a local game, another server, or a different host, you can upload it and run it on your server.

Before you start

  • Back up your current world before uploading a new one. The existing world will be replaced. See Back up your Minecraft server.
  • Your world folder must match the world name set in server.properties (level-name=world by default).
  • Java and Bedrock world formats are incompatible. A Java world can’t be loaded on a Bedrock server. A Bedrock world can’t be uploaded on a Java server.

Prepare your world folder

Your world folder should contain these files/subfolders:

  • level.dat
  • region/
  • playerdata/ (optional)

The folder itself should be named to match level-name in server.properties (usually world).

Compress the folder into a .zip file if you’re uploading through the browser.

Upload the world

  1. Stop your server.
  2. In the File Manager, navigate to your server’s root directory.
  3. Delete or rename the existing /world folder.
  4. In the File Manager, click Upload and upload your .zip file.
  5. On the uploaded .zip file, click the three dots icon (…) and select Decompress.
  6. Make sure the extracted folder is named to match the level-name in server.properties.

Start your server

Start the server (see Start, stop, or restart your server) and watch the console. A successful world load shows Preparing level “world” (or whatever your level-name is set to).

Common issues

ProblemFix
World loads but is empty / spawn is wrongMake sure the folder name matches level-name in server.properties
“Failed to load world” in consoleWorld might be corrupted or from an incompatible version
World reverts on restartMake sure the old world/ folder was fully replaced, not just left alongside the new one

 

Need personalized assistance?

Our senior support engineers are available 24/7 to help with complex infrastructure migrations and troubleshooting.