Changing the world

Replace the auto-generated world with one you bring in.

On first launch the server generates a fresh world named Bedrock level. To play on a world you already have - a single-player save, a Realm, or a world from another server - drop it into the worlds/ folder and point the server at it.

Stop the server before swapping worlds, and back up the existing worlds/ folder first. The server only loads one world at a time, chosen by level-name.

Export the world

Get the world out of wherever it currently lives as a .mcworld file:

  • From a device - in the in-game world list, tap the pencil / Edit next to the world, scroll down, and choose Export World. You get a .mcworld file.
  • From a Realm - open the Realm, go to Edit World (or Configure > Game), scroll down, and choose Download World.

Put it in the worlds folder

A .mcworld file is just a renamed .zip. Unpack it into its own folder under worlds/:

  1. Rename My World.mcworld to My World.zip.
  2. Create a folder inside worlds/ with the name you want. Spaces are fine, so you can keep the world's original name like My World.
  3. Extract the zip into that folder so level.dat sits directly inside it. If extraction produced a nested subfolder, move the contents up one level.

The result should look like this:

level.dat
levelname.txt

Point the server at it

Open server.properties and set level-name to the exact folder name you created:

level-name=My World

A typo here doesn't error - the server treats it as a brand-new world name and generates an empty world instead. Double-check it matches the folder.

Start the server. It loads the world from worlds/<level-name>/.

With Docker, the worlds/ folder lives inside the volume you mounted at /data, so unpack the world there.

Packs travel with the world

If the world relied on behavior or resource packs, its world_behavior_packs.json and world_resource_packs.json come along inside the export. Make sure the packs they reference are present on the server - see Adding packs for where those files live and how pack activation works.

On this page