Skip to content

Minecraft: Add Your Own World to the Server

Upload your own Minecraft world to your server using the Files tab or SFTP, then set it in server.properties → Find out more

19 November 20263 min read41 Views0 helpful

Don't have your own server yet? Host your Minecraft server with ZAP-Hosting.

Introduction

Want to play your single-player world or a world downloaded from the internet on your Minecraft server? In this guide, you'll upload the world using the Files tab or via SFTP, then set it as the server world in server.properties.

Before you start

You need the complete folder for your world. You can identify it by the level.dat file located directly inside the folder. On Windows, Java Edition single-player worlds are located at %appdata%\.minecraft\saves\<Weltname>.

  • Version: The world should have been created using the same or an older Minecraft version than the one running on your server. An older server won't load a world from a newer version.
  • Variant: Each variant has its own data folder on your server, for example minecraft/paper/ or minecraft/vanilla/. Upload the world to the folder for the variant you want to play. The Files tab automatically opens the folder for the active variant.
  • Backup: If you want to replace your current world, create a backup in the Backups tab first.
Info

This guide applies to Java Edition. For Bedrock Edition, see Minecraft Bedrock: Import a custom world.

Upload your world

Stop your server before uploading or replacing world files.

Using the Files tab

  1. Pack your world folder into a ZIP archive on your PC. You can only upload individual files in the Files tab, not folders.
  2. Open your gameserver management panel and go to the Files tab.
  3. Click Upload or drag the ZIP file into the file manager.
  4. For the uploaded file, click Extract, enter your variant's folder as the Target folder, and confirm.
  5. Make sure level.dat is located directly in the new world folder and not in another subfolder.
Info

Files can be up to 100 MB when uploading, and archives can be up to 200 MB when extracting, including their extracted size. Upload larger worlds via SFTP.

Using SFTP

For large worlds, connect using an SFTP client such as FileZilla or WinSCP. You can find your login details in the External access section of the Files tab. Our guide Access via SFTP explains how. After connecting, go to your variant's folder and upload the complete world folder there.

Tip

Switching from another host? ZapX can also retrieve your server files, including your world, directly. To do so, click Import server in the Files tab.

Set your world on the server

Your server loads the world whose folder name is set under level-name in server.properties. The default is world. You have two options:

  • Replace your current world: Rename or delete the old world folder, then rename your world folder to world. No further setup is needed.
  • Use your world with its own name: Leave your world folder as it is and enter its name as the level-name value.

For the second option, go to the Configuration tab. In the Files list, click the pencil (Edit directly) next to server.properties and change the line:

Code
level-name=myworld

The value must exactly match the folder name, including uppercase and lowercase letters. Save the file and restart the server. The new world will load when the server starts.

Info

From Minecraft 26.1, Vanilla, Fabric, Forge and Paper store all dimensions inside the world folder under dimensions/minecraft/. On Paper up to 1.21 and on Spigot, the Nether and End are stored in separate folders (<Weltname>_nether and <Weltname>_the_end). The server converts an uploaded singleplayer world to its own format on the first start. You can find more details in our Managing Worlds guide.

Common issues

The server creates a new, empty world. Usually, the folder name doesn't match level-name, or level.dat is in an extra subfolder after extraction. Check both in the Files tab. Also make sure you uploaded the world to the folder for the active variant.

The server loads the old world again after a restart. If you have ever transferred the world name to your server with our Seed Generator or Config Generator, the server resets level-name to that value on every start. In that case, transfer the world name you want via the Config Generator as well (setting level-name).

The server won't start anymore. Check the error message in the Console tab. The most common cause is a world from a newer Minecraft version. If this happens, set the correct version or restore your backup.

Conclusion

Your own world is now running on your server. Have fun playing! If you have any other questions, our support team is available every day. 🙂

FAQ

Frequently asked questions

Stop the server, pack your world folder as a ZIP, upload it to your variant's folder in the Files tab, and extract it there. Upload larger worlds via SFTP. Then rename the folder to world or enter its name as level-name in server.properties, and restart the server.
In the Configuration tab, click Edit directly next to server.properties in the Files list, set level-name to your world folder's name, save the file, and restart the server.
Usually, the folder name doesn't match level-name, level.dat is in an extra subfolder after extraction, or the world isn't in the folder for the active variant.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 people found this article helpful.

Personal support

Need more help than the guide provides?

Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.

Zappy knows this guide and answers you right in the chat.