ᴅɪꜱᴄᴏᴜɴᴛꜱ ꜰʀᴇᴇ ꜱᴇʀᴠᴇʀ ᴛᴏᴏʟꜱ ᴀꜰꜰɪʟɪᴀᴛᴇꜱ ꜱᴇᴛᴜᴘꜱ ᴍᴏᴅᴇʟꜱ ʙᴜɪʟᴅꜱ ᴏꜰꜰᴇʀꜱ ᴀ/ʙ ᴛᴇꜱᴛɪɴɢ ᴅᴇᴠᴇʟᴏᴘᴍᴇɴᴛ ᴍᴀʀᴋᴇᴛɪɴɢ

You are uploading a world onto your server — the same way you would upload a plugin JAR, except the file is a whole folder.

The easy path: zip the world on your PC, stop the server, replace the world folder in the panel file manager, start the server, join.

Java Edition only. A world from a phone, console, or Windows Bedrock will not load on a Java server.

After you start it — confirm players can reach it with Server Status. If the map is huge and the server stutters, check the RAM Calculator.

Step 01

Get the world off your PC

Quit the world in Minecraft first. Copying it while it is open can break the save.

  1. In the launcher, select the world → EditOpen World Folder. You should see a file called level.dat inside. That folder is the world.
  2. Go up one level so you can see the folder itself (not the files inside it).
  3. Either rename the folder to world (easiest — the server already looks for that name) or keep a name you prefer, like Survival. Avoid spaces.
  4. Right-click the folder → compress / send to zip. Upload that zip in Step 04.

If you cannot use the launcher button: Windows is %appdata%\.minecraft\saves (Win+R), Mac is ~/Library/Application Support/minecraft/saves, Linux is ~/.minecraft/saves.

Step 02

Stop the server

Open your host’s panel and click Stop. Wait until the status says it is offline. Do not upload while it is running — that corrupts the map.

If you already had a world on this server that you might want back, download the current world folder (and world_nether / world_the_end if they exist) before you delete anything.

Step 03

Move the old world out of the way

In the panel, open Files (or File Manager). You should see server.properties and a folder named world. That world folder is what the server loads as the main map.

Skip this step if you want to keep the current map and add yours beside it — use Multiverse in Step 06 instead.

  1. Rename world to world-old (or delete it if you are sure you do not need it).
  2. If you also see world_nether and world_the_end, rename or delete those too. Leaving them behind mixes your new Overworld with the old Nether.

Step 04

Upload the zip into the server files

Stay in that same Files view — the folder that contains server.properties. That is the server root. Your world has to land here, not inside plugins or world-old.

  1. Upload world.zip.
  2. Unzip / extract it in the panel, then delete the zip.
  3. Check what you got. You want this:
server.properties
world/
  level.dat
  region/
  …

If you see world/world/level.dat, the zip had an extra folder. Move the inner folder up so level.dat sits directly in world.

If the browser upload fails (common on big worlds), connect with FileZilla using the SFTP details in your panel and drop world.zip in the same place, then unzip it there.

Open server.properties and set level-name to the folder name. If you renamed it to world:

level-name=world

Want a different name? Keep the folder as something like Survival, then set the same word in server.properties:

level-name=Survival

The folder name and level-name must match exactly (capital letters count). If they do not, the server creates a new empty world and ignores your upload. On Paper, the Nether and End folders must use that name too — Survival_nether and Survival_the_end (Step 05).

To keep the default world and load this map as a second world, leave level-name=world alone and import the extra folder with Multiverse (Step 06).

Hosts such as Four Seasons Hosting have Files and SFTP on the same panel — see their Minecraft plans if you need a server to upload to.

Step 05

Put the Nether and End where the server expects them

Most Minecraft hosts run Paper. Paper does not look for the Nether inside your world folder. If you skip this, you keep your Overworld and get a new Nether and End.

In Files, open your world folder (world, or whatever you named it). If you see folders named DIM-1 (Nether) and DIM1 (End):

  1. Go back to the server root (next to server.properties).
  2. Create a folder named <level-name>_nether — so world_nether, or Survival_nether if the world is Survival. Move DIM-1 into it.
  3. Create <level-name>_the_end the same way, and move DIM1 into it.

The server root should now look like this (using world as the name):

server.properties
world/              ← your Overworld
world_nether/       ← your Nether
world_the_end/      ← your End

If you copied this world from another Paper server, you already have those three folders — upload all three, and rename them so they match level-name (or the Multiverse world name).

Step 06

Add it as an extra world with Multiverse

Changing level-name replaces the main map. If you want the lobby or survival world to stay, and this upload to be a second world people can teleport to, use Multiverse-Core (the usual world-management plugin on Paper).

  1. Leave the existing world folder and level-name=world as they are. Do not do Step 03.
  2. Upload your save next to server.properties under its own name, e.g. Survival (with Survival_nether / Survival_the_end if you split them in Step 05).
  3. Put the Multiverse-Core JAR in plugins/ if it is not installed already, then start the server.
  4. In console or as an operator, import the folder:
    /mv import Survival normal
    Use nether or end instead of normal if that folder is a Nether or End world.
  5. Teleport there with /mv tp Survival. List worlds with /mv list.

Multiverse is what you use day to day after the upload: create worlds, import folders, set spawn, and send players between maps. For Nether portals on extra worlds, add Multiverse-NetherPortals so Survival links to Survival_nether instead of the main Nether.

Import only after the files are on the server. The command loads a folder that is already sitting in the server root — it does not upload anything by itself.

Step 07

Start the server and join

  1. Click Start in the panel.
  2. Watch the console. It should prepare spawn in your world — not generate a world from a seed you never used.
  3. Join with the same IP you always use. Walk to a build you know. Go through a Nether portal if you had one.

Your builds are there. Your inventory may be empty — singleplayer and an online server identify you as different players. That is normal. Use whitelist.json if you want to lock the server to certain accounts.

If it didn’t work

What went wrong

What you see What to do
You joined a brand-new empty world The server did not see your folder. level-name must match the folder name, and level.dat must sit directly inside it — not one folder deeper.
Overworld is yours, Nether is new Paper is ignoring the Nether inside the world folder. Do Step 05: move DIM-1 into world_nether.
“World is in use” The server was still on, or a leftover session.lock is in the world folder. Stop the server, delete session.lock, start again.
The upload never finishes Use FileZilla (SFTP) from the panel’s connection details. Browser uploads often fail on large worlds.
Builds are there, inventory is empty Expected when the world came from singleplayer. Your items were saved under a different player ID.
The world will not load It may be Bedrock, or the zip did not finish extracting. Confirm level.dat is in world.

FAQ

Frequently asked questions

Where do I upload the world on the server?

In the panel file manager, into the same folder as server.properties. That is the server root. Unzip so you have a world folder there with level.dat inside it.

Can I use a name other than world?

Yes. Keep the folder name you want (for example Survival), set level-name to that same word in server.properties, and on Paper name the extra folders Survival_nether and Survival_the_end. Avoid spaces. To keep the default world as well, leave level-name alone and import the extra folder with Multiverse.

How do I add a world without replacing the current one?

Upload the folder next to server.properties under its own name, install Multiverse-Core, then run /mv import WorldName normal. Teleport with /mv tp WorldName. Do not change level-name.

Do I have to stop the server before uploading?

Yes. Stop it, upload, then start it. Replacing world files while the server is running can break the map.

Why did my Nether reset after I uploaded?

Paper looks for the Nether in a folder called world_nether next to your world, not inside it. Move DIM-1 into world_nether (Step 05).

Can I upload a Bedrock world to a Java server?

No. They are different formats. Geyser lets Bedrock players join a Java server — it does not convert the world.