How to Import & Export Minecraft Worlds (Java & Bedrock)

This guide will teach you how to export (download) your world and import (upload) a world to your BaoHost server.

---

Exporting a World (Downloading Your World)

Java Edition

1. Go to the Files tab in your panel.
2. Find your world folder. By default it is named world. To confirm, open server.properties and check the level-name= value — that is your world folder's name.
3. Right-click the world folder and select Archive.
4. Wait for the archive to finish — larger worlds may take several minutes.
5. Once complete, a .tar.gz file will appear. Download it to your computer.

Bedrock Edition

1. Go to the Files tab in your panel.
2. Open the worlds/ folder.
3. Right-click your world folder and select Archive.
4. Wait for the archive to finish.
5. Once complete, download the .tar.gz file to your computer.

---

Importing a World (Uploading Your World)

📝 Note: If your world was archived as a .tar.gz file, you can still upload it — when selecting the file in the upload dialog, change the file type filter from Compressed (zipped) Folder to All Files to be able to select it.

Java Edition — Using World Manager (Recommended)

BaoHost has a built-in World Manager that makes importing worlds easier on Java servers.

1. Stop your server.

2. Go to the World Manager in your panel.

3. Choose one of the following modes:

   Replace Mode — Replaces your current world with a new one.

   • Click Select .zip to replace world.
   • Upload your archive file. The current world will be automatically archived as a backup before it is replaced.

   Add Mode — Adds a new world without touching your existing world(s). Useful for multi-world setups (e.g. Nether/End) or bringing in additional maps.

   • Enter a folder name (e.g. world_nether).
   • Click Select .zip to add and upload your archive file.

   Import via URL — Fetches a world directly from an external link.

   • Paste the URL of your world archive file.
   • Choose whether to replace the existing world or add it as a new world.
   • Click Fetch & Install.

4. Restart your server.

📝 Note: The World Manager automatically detects and unwraps nested wrapper folders — it will find the folder that actually contains level.dat, wherever it is in the archive file.

Java Edition — Manual Upload

If you prefer to upload manually via the Files tab:

1. Stop your server.
2. Go to the Files tab and upload your .zip or .tar.gz file.
3. Wait until the upload reaches 100%.
4. Right-click the file and select Extract or Unarchive.
5. Make sure the extracted folder name matches the level-name= value in server.properties. If they don't match, either rename the folder or update level-name= accordingly.
6. Restart your server.

Bedrock Edition

The World Manager is not yet available for Bedrock servers. You will need to upload your world manually:

1. Stop your server.
2. Go to the Files tab and open the worlds/ folder.
3. Upload your .zip or .tar.gz file into the worlds/ folder.
4. Wait until the upload reaches 100%.
5. Right-click the file and select Extract or Unarchive.
6. Restart your server.

---

Common Issues

My server created a new world. For Java Edition, this usually means the world folder name doesn't match the level-name= value in server.properties. Double-check both names and make sure they are exactly the same.

My upload won't extract. Make sure the world is compressed as a .zip or .tar.gz file, the upload reached 100% before extracting, and the archive isn't corrupted.

My world is missing builds or player data. Always upload the entire world folder. Uploading only files like level.dat or folders like region/ will result in an incomplete world.

The archive is taking a long time. Large worlds can take several minutes to compress, upload, or extract. Wait until the process is fully complete before restarting your server.

---

Tips

• Always create a backup before replacing your world.
• Stop your server before uploading or replacing world files.
• Wait for uploads and extraction to finish before restarting your server.
• Keep a backup of your worlds on your computer in case you ever need to restore them.