How to Add a Savegame to Your Minecraft PocketMine Edition Server

With PocketMine-MP a save is always a complete folder and never a single file. All worlds are stored in the worlds folder in the main folder of your server. Which world gets loaded is decided by the level-name entry in the server.properties file.

Structure of a world folder

worlds
|___ my_world
|    |___ db
|    |___ level.dat
|    |___ levelname.txt
|___ my_second_world
     |___ db
     |___ level.dat
     |___ levelname.txt

Find your local world

If you want to transfer a world from your Minecraft Bedrock client, you can find it in the following locations:

Extract a world from a .mcworld file

Upload the savegame

1. Stop the server
   Stop your server via the dashboard. While the server is running it constantly writes to the loaded world.

2. Connect via SFTP
   Connect to your server via SFTP or use the file browser in the dashboard.

3. Open the directory
   In the main folder of your server, navigate to the following folder:

   worlds
   

4. Upload the world folder
   Upload the complete folder of your world with all files it contains. Use a folder name without spaces or special characters, for example my_world.

5. Open server.properties
   In the main folder of your server, open the file:

   server.properties
   

6. Enter the world name
   Look for the following entry and set it to the folder name of your uploaded world:

   level-name=my_world
   

7. Start the server
   Save the change and start your server. On startup your uploaded world is now loaded.

Which worlds work?

Let the server generate a new world

If the folder set under level-name does not exist, PocketMine-MP creates the world on startup. This is controlled by the following entries in server.properties:

Manage multiple worlds

Additional worlds next to the main world are defined in the pocketmine.yml file in the main folder of your server:

worlds:
  my_second_world:
    seed: 123456
    generator: FLAT