Skip to content

Using Worlds

mcman can help you manage your server's worlds. You can make mcman download a world or keep the world under the worlds/ directory.

Worlds are defined in server.toml under the worlds table. The key of the table is the world name. For example, the world with name 'city' would be worlds.city.

Downloading Worlds

If you set the download field to a Downloadable mcman will download the world zip file and unzip it if the world does not exist in the output directory.

[worlds.earth.download]
type = "url"
url = "https://example.com/cdn/worlds/earth.zip"

The worlds/ Folder

Optionally, you can store your worlds under the worlds/ folder.

worlds
├─ lobby.zip
└─ arena.zip

When building, if the world does not exist in the output directory, mcman will unzip the world file located in the worlds/ folder.

Note

For your world to be unpacked, there needs to be a world entry in server.toml for it:

[worlds.city]
# just the entry is enough

You can also manually unpack a world using the mcman unpack <world> command.