How to Upload a World to a Minecraft Server

To upload world Minecraft server files, zip your world folder on your PC, stop the server, upload the zip to the server's main folder, extract it and make sure the folder name matches level-name in server.properties. On TheGameHosting you do all of it in the browser with Files, or over sFTP for big worlds.

Moving a singleplayer world, a map you downloaded or a world from another server works the same way. What breaks uploads is almost always one of three things: the folder ends up one level too deep, the name does not match level-name, or the Nether and the End are left behind. This guide avoids all three.

Before you upload: version, software and a backup

• Match the version. Run the server on the same Minecraft version the world was last played on, or a newer one. Opening a world in an older version is not supported: the Minecraft Wiki warns it can wipe chunks or inventories and crash. If you need to switch versions first, see how to change your Minecraft server version.
• Match the mods. A world made with Fabric, Forge or NeoForge mods needs the same mods on the server, or modded blocks disappear.
• Java only. This guide is for Java Edition. Bedrock worlds use a different format; for those, read how to upload a world to a Bedrock server.
• Back up what is there now. Uploading a world replaces the current one. Make a copy first with our guide to back up a Minecraft server world.

Find your world and zip it

Singleplayer worlds live in the saves folder of your game directory (.minecraft/saves), one folder per world, named after the world. On Windows, press Win+R, type %appdata%\.minecraft\saves and press Enter. You can also open it from the game: Singleplayer, select the world, Edit, Open World Folder.

A real world folder has a level.dat file directly inside it. Where the Nether and the End are depends on the software and the version:

Zip the world folder itself (right-click it, then Compress to ZIP file on Windows or Compress on macOS). If it comes from an older Paper or Spigot server, zip world_nether and world_the_end too. One zip uploads far faster than thousands of small region files.

How to upload world Minecraft server files in the panel

1. Back up the current world: open Backups and click Create backup.
2. Stop the server from the Console. Never replace a world while the server is running: it saves on shutdown and can overwrite your upload.
3. Open Files. You are in the server's main folder, next to server.properties. Rename the old world folder (for example to world-old) instead of deleting it.
4. Click Upload and choose your zip. Wait until it finishes.
5. Open the zip's menu (the three dots or right-click) and choose Unarchive.
6. Open the new folder and check that level.dat is directly inside it, not in a second folder with the same name.
7. Open server.properties in Files and set level-name to the exact folder name, keeping capitals and spaces.
8. Start the server and watch the Console while the world loads, then join and check your builds.

# server.properties
level-name=MySurvivalWorld

If level-name does not match any folder, the server generates a brand-new world with that name. That is the classic “I uploaded my world and got a fresh one” mistake.

Big worlds: upload with sFTP

For worlds of several gigabytes, a file client is more reliable than the browser. Copy the address, port and username from Settings → SFTP Details, log in with your panel password and drag the zip to the main folder. Then extract it in Files exactly as above. Our SFTP guide shows where each value goes in FileZilla and WinSCP.

If you run the server with a friend, add them in Users so they can upload the world from their own PC without sharing your account.

Moving between Vanilla and Paper

When you put a Vanilla or singleplayer world on Paper, Paper converts the storage layout by itself on first start, according to the PaperMC migration guide. The other direction needs manual work:

• Paper before 26.1 to Vanilla: copy world_nether/DIM-1 and world_the_end/DIM1 into world. If you skip it, the Nether and the End look reset, although the data still exists in those folders.
• 26.1 and newer: Paper uses the same world/dimensions/ layout as Vanilla, so only a few data files move. Follow the PaperMC guide with the server stopped.

Common problems after uploading

• A new world loads instead of yours: level-name does not match the folder, or level.dat is one folder too deep (MyWorld/MyWorld/level.dat). Move the contents up one level.
• The Nether or the End is new: the dimension folders were not uploaded or are in the wrong place. Check the table above.
• The server crashes on start: the world comes from a newer version or needs mods the server does not have. Read the error in the Console.
• Upload stops halfway: use sFTP for large files.
• Something went wrong: stop the server and follow our guide to restore a Minecraft server world from the backup you made.

Bring your world to TheGameHosting

On a Minecraft server from TheGameHosting you upload your world in Files or over sFTP, back it up with one click and pick the right version in the Version Changer. Your world stays online 24/7 with no PC left on and no ports to open, on AMD 9950X/7950X3D with DDR5 and NVMe in Dallas or Amsterdam. Compare sizes on plans and pricing and use code FULL2026 for 15% off for life.

FAQ

Hosting for these games

• Minecraft Java hostingPaper, Purpur, Fabric, Forge and more
• Minecraft Bedrock hostingPhones, consoles and Windows