Knowledge base

Add-ons and worlds on your Bedrock server

On a Bedrock server you can use add-ons (behavior packs and resource packs) and upload your own world. Here is how. It applies to Bedrock Edition, not Java.

What you need

  • A Bedrock server with us (see Get started).
  • The add-on files (.mcaddon or .mcpack), or your world (.mcworld or a world folder).
  • Access to the files through the file manager or FTP/SFTP.

Upload your own world

  1. Stop the server.
  2. A .mcworld file is a zip archive. Unpack it on your computer so you have the world folder itself with for example level.dat and db.
  3. Upload the folder to the server's worlds folder.
  4. Open server.properties and set level-name to the folder name.
  5. Start the server and check the world in the game.

Take a backup first. If the server already has a world you want to keep, download the worlds folder before you overwrite anything.

Install add-ons

Add-ons consist of behavior packs (rules and behaviour) and resource packs (looks and sound).

  1. Stop the server. Unpack the .mcaddon or .mcpack file (they are zip archives) so you have one folder per pack with a manifest.json in the root.
  2. Upload behavior packs to behavior_packs and resource packs to resource_packs on the server.
  3. Open manifest.json in each pack and find the header section. Note the uuid and version values.
  4. Create or open world_behavior_packs.json and world_resource_packs.json in your world's folder under worlds, and add one entry per pack with pack_id (= uuid) and version as a list, for example [1, 0, 0].
  5. Save, start the server and check the console for errors.

Copy the values from header, not from modules. A wrong uuid, a wrong version or invalid JSON means the pack is not loaded.

If something does not work

ProblemTry this
The add-on does not workCheck uuid and version in both files, and that the JSON file is valid. Restart the server after changes.
Features are missingSome add-ons need an experimental feature turned on in the world. Turn it on in the world on your computer and upload the world.
Marketplace contentPacks from the Minecraft Marketplace cannot be used on your own server.
The server will not startRemove the last pack you added and try again. The console usually shows what is wrong.

Tip: Add one add-on at a time and test it before you add the next. That makes troubleshooting easy.

Need help?

If you get stuck, open a support ticket and tell us which game and server it concerns and what happens. We will help you move on.

Was the article helpful?