Upload a World or Map to Server

Introduction

Whether you’ve downloaded a breathtaking adventure map from Planet Minecraft or you’re migrating an existing single-player world to your HumbleServers node, uploading a custom map is a straightforward process. You can upload files and whole folders of any size on the Files page in the client area, or use SFTP with a desktop app, which this guide walks through.

Step 1: Stop Your Server

Before making any changes to world files, you must ensure the server is not actively writing data.

1. Navigate to your server in the HumbleServers client area .
2. Open your server console.
3. Click the Stop button and wait for the status to show “Offline.”

Step 2: Prepare Your Tools

To upload entire folders efficiently, you need an SFTP client. We recommend WinSCP for Windows users.

• Download and install it here: WinSCP Official Download.

Step 3: Connect via SFTP

1. On your server’s page, open Files and click the SFTP button.
2. Locate your SFTP Details (Server Address, Username).
3. Open WinSCP and create a new connection:
   • File Protocol: SFTP
   • Host Name: The address shown in the SFTP dialog.
   • User name: The username shown in the SFTP dialog.
   • Password: Your SFTP password. If you haven’t set one, click Set SFTP password in the same dialog.
4. Click Login.

Step 4: Clear the Old World and Upload

1. On the Files page (or via WinSCP), locate the existing world folder.
2. Delete the old world folder to make room for the new one.
3. On your computer (the left side of WinSCP), find your custom map folder.
4. Drag and drop the custom map folder into the server directory (the right side of WinSCP).

Step 5: The “world” Rule

Minecraft looks for a specific folder name defined in your server.properties file (the default is world).

1. Once the upload is complete, right-click the uploaded folder in WinSCP.
2. Rename it to exactly world.

   Tip: If your map is in a zip file, you must extract it on your computer before uploading.

Step 6: Finalize and Start

All set! Go back to your Console and click Start. The server will now load your custom map. If the world doesn’t look right, double-check that the folder you uploaded contains the level.dat file directly inside it (and not nested inside another sub-folder).