How to Upload a World to Your Minecraft Server

Uploading a Minecraft world to your server is useful when you want to transfer an existing singleplayer world, move a world from another server, or restore a world from a backup.

A Minecraft world contains all of the terrain, structures, player builds, entities, and world data for that world. Uploading a world allows you to use an existing Minecraft world on your server instead of generating a completely new one.

This guide explains how to upload a Minecraft world to your server using the File Manager in your Game Panel.

This guide is written for Minecraft: Java Edition servers, including Vanilla, Paper, Spigot, and Purpur servers.

What Is a Minecraft World? #

A Minecraft world is stored as a collection of files and folders containing the world data.

A standard Minecraft server may have folders such as:

world
world_nether
world_the_end

The main world folder contains data such as:

• Terrain
• Player builds
• Chunks
• Villages
• Structures
• Entities
• Player data
• World settings
• Other world information

A world can be transferred between compatible Minecraft server versions.

Important: Always Create a Backup First #

Before replacing an existing world, create a backup of your server.

Uploading a world with the same name as an existing world may overwrite or replace the world you currently use.

If you have important builds or player progress, make sure you have a backup before continuing.

How to Upload a Minecraft World to Your Server #

Step 1: Stop Your Minecraft Server #

Stop the Minecraft server completely.

Do not upload or replace world files while the server is running.

This prevents Minecraft from writing new data to the world while you are replacing it.

Step 2: Prepare Your Minecraft World #

Find the Minecraft world you want to upload.

If the world is stored as a ZIP file, extract it on your computer first.

You should have a folder containing files and folders similar to:

level.dat
region
data
playerdata
entities

The exact files may vary depending on the Minecraft version and world.

Make sure you upload the actual world folder.

For example:

MyWorld
├── level.dat
├── region
├── data
├── playerdata
└── entities

Step 3: Open Your Server Files #

Open the File Manager in your Game Panel.

Navigate to the main directory of your Minecraft server.

This is normally where you can find files such as:

server.properties
eula.txt

and folders such as:

world
plugins

Step 4: Upload the World #

Use the Upload option in the File Manager.

Upload your Minecraft world folder or ZIP file, depending on what your Game Panel supports.

If you uploaded a ZIP file, extract it using the File Manager after the upload has finished.

Make sure the world folder is located directly inside the main server directory.

For example:

/home/container/MyWorld/

and not:

/home/container/MyWorld/MyWorld/

The folder containing level.dat should be the actual world folder.

Step 5: Rename the World #

You can rename the uploaded world folder to make it easier to identify.

For example:

MyWorld

or:

survival

The folder name will be used when configuring the server to load the world.

Step 6: Configure the Server to Use the World #

Open:

server.properties

Find:

level-name=

Set it to the name of the uploaded world folder.

For example, if your world folder is:

MyWorld

set:

level-name=MyWorld

Make sure the name matches the folder name exactly.

Step 7: Save the Configuration #

Save your changes to:

server.properties

Make sure the file has finished saving before continuing.

Step 8: Start the Server #

Start your Minecraft server.

Minecraft will load the world specified by:

level-name=

If everything is configured correctly, the server should load your uploaded world.

Step 9: Check Your World #

Join the Minecraft server and check that your world has loaded correctly.

Check important areas such as:

• Spawn
• Player builds
• Chunks
• Villages
• Nether
• The End
• Player data

If everything looks correct, the world has been successfully uploaded.

Uploading a World With a Different Name #

You do not have to rename the world folder to world.

For example, you can upload:

SurvivalWorld

and configure:

level-name=SurvivalWorld

Minecraft will then use that folder as the main world.

Uploading a World From Singleplayer #

If you are uploading a singleplayer world, you can normally find your worlds in your Minecraft saves folder.

A typical Windows location is:

%appdata%\.minecraft\saves

Each folder inside the saves directory is a Minecraft world.

Copy the world you want to upload and transfer it to your server.

Make sure the server is running a Minecraft version compatible with the world.

Uploading the Nether and End #

If you are transferring a complete server world, you may also need to transfer the Nether and End dimensions.

A standard server may use:

world
world_nether
world_the_end

The exact folder names depend on your server software and configuration.

If you are uploading a singleplayer world, the Nether and End are normally stored inside the main world folder rather than as separate folders.

Do not rename or move dimension folders unless you know how your server software handles them.

Common Mistakes to Avoid #

Uploading the Wrong Folder #

Make sure the folder containing:

level.dat

is the folder being used as the world.

Avoid accidentally creating:

MyWorld/MyWorld/level.dat

when the server expects:

MyWorld/level.dat

Forgetting to Change level-name #

If your uploaded world is called:

MyWorld

but server.properties still contains:

level-name=world

the server may continue loading the old world.

Uploading While the Server Is Running #

Always stop the server before replacing or uploading world data.

Forgetting to Create a Backup #

Uploading a world can replace an existing world.

Always create a backup before making major world changes.

Using an Incompatible Minecraft Version #

Worlds created on a newer Minecraft version may not work correctly on older versions.

Always check that the Minecraft version of the world is compatible with your server.