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.
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/orminecraft/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.
This guide applies to Java Edition. For Bedrock Edition, see Minecraft Bedrock: Import a custom world.
Stop your server before uploading or replacing world files.
- Pack your world folder into a ZIP archive on your PC. You can only upload individual files in the Files tab, not folders.
- Open your gameserver management panel and go to the Files tab.
- Click Upload or drag the ZIP file into the file manager.
- For the uploaded file, click Extract, enter your variant's folder as the Target folder, and confirm.
- Make sure
level.datis located directly in the new world folder and not in another subfolder.
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.
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.
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.
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
worldfolder, then rename your world folder toworld. 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-namevalue.
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:
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.
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.
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.