If you want to move your own Minecraft world to your server, you do not upload individual map files, but the complete world folder. This world becomes active through the level-name entry in server.properties. What matters is a clean folder structure, matching server versions, a stopped server, and a quick check after the restart.
Requirements before the upload
Create a backup first: one of your local world and one of the currently active server world. Switching worlds is technically simple, but world files are written during server startup and while the server is running. If you overwrite files during that time, chunks, player files, or dimension data can be damaged.
A Minecraft world is always a folder. For a Java single-player world, you typically find it under .minecraft/saves/<WorldName>. The level.dat file, among others, must be directly inside this folder. If you first open an extra wrapper folder and the actual world is inside it, the upload has been prepared one level too high.
Example of a correct structure:
my-world/
level.dat
region/
playerdata/
data/
For the server, it is best to use a simple folder name such as my-world, survival-2026, or adventuremap. Spaces, umlauts, and special characters can create unnecessary sources of errors depending on the tool, operating system, or panel. You do not need to format the visible world name nicely in the game; what matters is that the technical folder name is unique.
Prepare the world folder
Package the complete world folder, not just region, level.dat, or individual files. If the world comes from single-player, close Minecraft completely first so no files are still open. For downloaded maps, extract the archive locally and then check which level contains level.dat.
If you want to replace an existing server world, do not delete the old folder too quickly. It is better to rename it, for example from world to world-backup-old. That way, you can later switch back via level-name without having to upload files again.
Also pay attention to the Minecraft version. A world from a newer Minecraft version cannot be opened reliably in an older server version. Use the same or a compatible server version with which the world was created or last saved. If you need to adjust the server software anyway, the guide Change the Minecraft Server Version – Vanilla, Paper, Purpur, Forge & Fabric Without Reinstalling will help you. For additional configuration values in the same file, Configure Minecraft server.properties Correctly – All Settings Explained is the right companion.
Stop the server and upload the world
Stop the server completely before changing files. Wait until the process has really ended and no new console output appears. Then upload the prepared world folder to the server file system.
On Java servers, the active world folder is usually located in the server's main directory, where server.properties is also located. If your current entry is level-name=world, the server loads the world folder. If you now upload a folder named my-world, world remains in place as long as you do not delete it.
For Bedrock Dedicated Servers, Microsoft describes in the official documentation that worlds are stored in subfolders of worlds/ and that the active world name is set via level-name in server.properties: documentation at learn.microsoft.com. For Java setups, the principle with the level-name entry is also the central mechanism, even if the directory structure looks different depending on the server software.
Activate the world via level-name
You control which world the server loads through the level-name entry in server.properties. In the game-serverhosting config editor, set level-name to the exact name of your uploaded world folder.
If you enter my-world there, the server loads the my-world folder as the active map on the next start. Uppercase and lowercase letters, hyphens, and underscores must match the folder name. If you want to keep several worlds on the server, you can leave them next to each other and only change the value of level-name.
Example:
level-name=my-world
Save the change and restart the server. Do not create a new world with the same name beforehand if you actually want to load an existing world. If the server cannot find a matching folder, it may create a new world with that name depending on the setup. It then looks as if the uploaded world has disappeared, even though in most cases only the folder name does not match exactly.
Check the result
After the restart, connect to the server and first check whether you spawn in the expected world. Check distinctive buildings, the spawn point, inventories, and important dimensions such as the Nether or the End if they belong to the world. Also look at the server console. You should check warnings about missing files, damaged chunks, wrong versions, or unloaded datapacks right away.
If you use plugins, mods, datapacks, or different server software, also test the functions that depend on the world. This is especially important for maps with command blocks, resource packs, custom datapacks, or mod blocks. If mods are missing, a world may start, but content can be missing or replaced.
Troubleshooting
The server starts with a new empty world
First check the value of level-name and the folder name. Both must match exactly. Also check whether level.dat is directly inside the specified folder. A ZIP archive was often extracted in such a way that an additional subfolder was created.
The world loads, but buildings are missing
Then the wrong folder is often active, or only part of the world was uploaded. Check whether the region folder exists and whether all files were transferred during the upload. For very large worlds, uploading again as an archive can be worthwhile if your file manager can extract archives server-side.
Players spawn without inventory
In Java worlds, player data is normally stored in the playerdata folder. If it is missing or does not come from the same world, inventories and positions can be missing. Also check whether the server is running in online mode as before, since UUIDs are relevant for player files.
The server does not start after switching worlds
Read the last console lines. Common causes are a world version that is too new, missing mods, faulty datapacks, or damaged files. As a test, set the old level-name again. If the old folder is still present unchanged, you can use it to check whether the problem is with the new world or the server configuration.
Checks, limits, and a safe rollback path
The guide “Upload & Switch a Minecraft World – Your Own Map on the Server” applies to the server type described in the article and the version state visible at the time of review. Menu names, available versions, mod or plugin compatibility, and required resources may differ after updates. Therefore, do not transfer values to another game, loader, or server version without checking them.
Before making changes to the world, savegame, configuration, or extensions, create a backup of the affected files. Then change only one related step and test it with the same client and server version you want to play with later.
| Checkpoint | Expected result | Abort and rollback |
|---|---|---|
| Server start | The server reaches the ready state without new error messages. | If startup errors occur, undo the change and restore the latest backup. |
| Connection test | A test account can connect using the address shown in the panel. | If version or connection errors occur, compare version, port, and firewall/opening settings again. |
| Function test | The specifically changed function works without damaging existing world or game data. | If side effects occur, stop the server and restore the backed-up files. |
A successful single test is not a guarantee of performance or availability. World size, mods, plugins, player count, network path, and simultaneous load can change the result. Document the version, change, and test result so you can trace later differences.
FAQ
Can I keep multiple Minecraft worlds uploaded at the same time?
Yes. You can keep multiple world folders on the server. However, only the world whose folder name is entered in server.properties under level-name is active.
Does the world folder always have to be named world?
No. world is only a common default name. You can name the folder differently as long as level-name contains exactly the same name.
Can I open a newer world on an older server version?
You should avoid that. Minecraft worlds are not reliably backward compatible. Use the same or a compatible version with which the world was created or last saved.
What happens to my old world when I switch?
As long as you do not delete or overwrite the old world folder, it remains intact. You can switch back to it later by entering its folder name again under level-name.
Why is a backup important before the upload?
During startup and operation, the server writes world files. If an upload is incomplete or the wrong version is used, you can restore the previous state with a backup.