Uploading a World to a Minecraft Server: Map Import Guide

How to Upload a World to a Minecraft Server

If you want to load a custom world (map) onto your Minecraft server, you are in the right place. Maybe you want to move a single player world into multiplayer, or install a custom map you downloaded from the internet. This guide covers the whole process step by step.

Preparation: Getting the World Files

Using a Single Player World

You can move a single player world from your own computer to the server:

World file location on Windows:

%appdata%\.minecraft\saves\YourWorldName

On macOS:

~/Library/Application Support/minecraft/saves/YourWorldName

On Linux:

~/.minecraft/saves/YourWorldName

Downloading a Map From the Internet

Popular Minecraft map sites:

• Planet Minecraft
• Minecraft Maps
• CurseForge

Extract the .zip file you downloaded, and you will find the world folder inside.

Step 1: Stop the Server

Shut the server down cleanly before you touch the world files:

# In the server console
stop

Or, if you are using screen:

screen -r minecraft
# Type "stop" in the console and press Enter

⚠️ Changing world files while the server is running can cause data loss.

Step 2: Uploading the World Files to the Server

Uploading Over SFTP/FTP

1. Open FileZilla or WinSCP
2. Connect using your server details:
   • Host: your server IP address
   • Port: 22 (SFTP)
   • Username and password
3. Navigate to the Minecraft folder on the server
4. Drag and drop the world folder

Uploading With SCP (Terminal)

# Copying from your local machine to the server
scp -r /path/to/YourWorldName root@YOUR_SERVER_IP:/home/minecraft/
 
# If you have a zip file instead
scp world.zip root@YOUR_SERVER_IP:/home/minecraft/
ssh root@YOUR_SERVER_IP "cd /home/minecraft && unzip world.zip"

Downloading Directly on the Server

If the world file is available at a URL:

cd /home/minecraft
wget https://example.com/map.zip
unzip map.zip

Step 3: Check the World Folder Structure

The world folder you uploaded should contain these files:

YourWorldName/
├── level.dat          ← World settings (required)
├── region/            ← World chunk data (required)
├── data/              ← Map data
├── datapacks/         ← Data packs
├── DIM-1/             ← The Nether dimension
├── DIM1/              ← The End dimension
├── playerdata/        ← Player data
└── poi/               ← Points of interest

💡 If level.dat or the region/ folder is missing, the world files are not correct.

Step 4: Edit the server.properties File

Edit server.properties so the server uses your new world:

# Change the world name (it must match the folder name)
level-name=YourWorldName

Setting the World Type

# Normal world
level-type=minecraft\:normal
 
# Superflat
level-type=minecraft\:flat
 
# Amplified
level-type=minecraft\:amplified

Step 5: Set File Permissions (Linux)

# Set the owner of the Minecraft folder
sudo chown -R minecraft:minecraft /home/minecraft/YourWorldName
 
# Fix the permissions
sudo chmod -R 755 /home/minecraft/YourWorldName

Step 6: Start the Server

# Start the server
cd /home/minecraft
java -Xms2G -Xmx4G -jar server.jar nogui

You will see the new world name being loaded in the console:

[Server] Preparing level "YourWorldName"
[Server] Preparing start region for dimension minecraft:overworld

Backing Up a World

To back up your current world:

# Create a date stamped backup
cp -r /home/minecraft/world /home/minecraft/backup/world_$(date +%Y%m%d_%H%M%S)
 
# Back up as a zip archive
cd /home/minecraft
zip -r world_backup_$(date +%Y%m%d).zip world/

Automatic Backup Script

#!/bin/bash
# backup_world.sh
MCDIR="/home/minecraft"
BACKUP_DIR="$MCDIR/backup"
WORLD_NAME="world"
 
mkdir -p $BACKUP_DIR
cd $MCDIR
zip -r "$BACKUP_DIR/${WORLD_NAME}_$(date +%Y%m%d_%H%M%S).zip" $WORLD_NAME/
 
# Delete backups older than 7 days
find $BACKUP_DIR -name "*.zip" -mtime +7 -delete

Automate it with a cron job:

# Back up every day at 04:00
crontab -e
0 4 * * * /home/minecraft/backup_world.sh

💡 White Bilişim includes free daily backups on every VDS package. Backups at the server level keep your data safe at all times.

Common Problems

“Failed to load world” error

• Check that the level.dat file is present
• Verify that the Minecraft version is compatible
• Avoid spaces and non ASCII characters in the folder name

The World Does Not Load and a New One Is Created

• Make sure the level-name value in server.properties matches the folder name exactly
• Watch out for capitalization, it matters on Linux

The Nether and End Dimensions Are Missing

• Make sure you also copied the DIM-1/ (Nether) and DIM1/ (End) folders

VDS Suggestions for a Minecraft Server

Conclusion

Uploading a custom world to your Minecraft server takes only a few simple steps. With the right VDS infrastructure behind it, even large worlds run without trouble.

👉 Take a look at our Xeon Enterprise VDS or Ryzen Premium VDS packages for your Minecraft server, and browse our other game server options.