How to Upload a World to Your Minecraft Server Print

Uploading a custom world to your Minecraft server allows you to use existing maps, backups, or downloaded worlds. This guide will show you how to upload and load a world using the File Manager or SFTP.

Supported Versions: Minecraft Java Edition

Step 1: Stop Your Server

Before uploading a world, you must stop your server to prevent corruption.

1. Log into your Game Panel
2. Select your server
3. Click Stop
4. Wait until the server is fully offline

Step 2: Prepare Your World Files

Your world folder should contain files like:

• level.dat
• region/
• data/

Important: The world must be inside a folder, not just loose files.

If your world is downloaded as a .zip, extract it on your computer first.

Step 3: Upload Your World (File Manager Method)

1. Go to File Manager in your panel
2. Upload your world folder as a .zip
3. Once uploaded, click the ... (options)
4. Click Decompress
5. Delete the .zip file after extracting

➡️ How to Use the File Manager

The file manager allows you to upload, edit, and manage your server files directly in your browser. :contentReference[oaicite:0]{index=0}

Step 4: Upload Your World (SFTP Method - Recommended for Large Worlds)

If your world is large, use SFTP for faster and more reliable uploads.

1. Connect to your server using SFTP
2. Navigate to your server directory
3. Drag and drop your world folder into the server

➡️ How to Connect via SFTP

SFTP allows secure file transfers and is ideal for large uploads. :contentReference[oaicite:1]{index=1}

Step 5: Set the World in server.properties

You must tell the server which world to load.

1. Open server.properties in the File Manager
2. Find the following line:

level-name=world

Change it to match your world folder name:

level-name=YourWorldName

Example:

level-name=survival_world

Step 6: Start Your Server

1. Go back to your panel
2. Click Start
3. Wait for the server to load

Your new world should now be active.

⚠️ Important Notes

• World folder name must match server.properties exactly
• Avoid spaces in world folder names
• Large worlds may take longer to load on first start

⚠️ Warning: Always create a backup before replacing your world.

➡️ How to Backup Your Server

Troubleshooting

World Not Loading

• Check level-name matches the folder name exactly
• Ensure the world folder is in the root directory
• Restart the server

Server Generates a New World

• The folder name is incorrect
• The world folder is empty or missing files

Upload Failed or Missing Files

• Re-upload the world using SFTP
• Check file sizes and integrity
• Ensure all files were extracted correctly

Next Steps

• Install plugins for your world
• Set a spawn location
• Configure world settings
• Invite players to join

Getting Help

• Knowledge Base: Explore more guides for configuration, setup, and troubleshooting.
• Support Ticket: Open a ticket from your HostByte account if you need assistance.
• Discord: Join our community below.

• Status Page: Check live updates at status.hostbyte.net.