How do I add Addons to my Bedrock Server?

Addons are Bedrock behavior packs that change how the game works. They can add new mobs, items, blocks, crafting recipes, and other gameplay features. When you install an addon on your server, every player who joins will experience those changes.

Many addons are distributed as .mcaddon or .mcpack files from sites like MCPEDL and the Minecraft Forum. Some addons also include a matching resource pack for textures and models. If yours does, install the resource pack as well using our resource pack guide.

Installing an Addon

There are two ways to install an addon: a less technical method where you enable it in a singleplayer world and upload that world, and a more technical method where you install it directly on the server.

Installing an Addon to your world

1. Download the addon to your computer. If it is a .mcaddon or .mcpack file, double-click it to import it into your local Bedrock edition of Minecraft.
2. Open Minecraft Bedrock.
3. Under your world, hit the pencil icon to edit your world.
4. Scroll down and select Behavior Packs.

5. Click Available. Here you’ll see the behavior packs you can add to your world.
6. Activate the pack(s) you’d like to use. If the addon requires a resource pack, open Resource Packs and activate the matching pack there as well.
7. Scroll back to General.
8. Under File Management select Export World and save your world as an .mcworld file on your computer.

9. Upload that exported world to your server (see below), then restart the server.

Uploading the world to your server

1. Open the Blacksmith’s Portal
2. Go to Files
3. Open worlds. If you do not see a worlds folder, create one with the Create Directory button.
4. Inside worlds, create a folder with the Create Directory button and name it, e.g. myworld.

5. Open your created folder.
6. Upload your exported .mcworld file.
7. Right click on your uploaded file and select Unarchive.
8. Restart your server. The addon will now be active on that world.

Uploading Addons directly to your server

1. Open the Blacksmith’s Portal.
2. Go to Files.
3. Open development_behavior_packs. If you don’t see it, create it with the Create Directory button.
4. Within this folder, create a new folder named after the addon.
5. On your computer, locate the .mcaddon or .mcpack file you downloaded and upload it to this folder.
6. Right click on it and select Unarchive.

7. Repeat for any additional behavior packs.
8. If the addon includes a resource pack, upload it to development_resource_packs using the same steps. See our resource pack guide for details.
9. Continue below to enable the pack on your existing world.

Manually enabling Addons on an existing world

To enable addons on a world that is already on your server, upload the behavior packs first, then register them in your world folder.

1. Each uploaded behavior pack has a manifest.json file inside its folder.
2. Open manifest.json and note the UUID and Version keys under the header object. You will need these next.

3. Go to your world folder, e.g. worlds/myworld.
4. Open world_behavior_packs.json. If you don’t see one, create it with the New File button.
5. The file should look like this:

[
  {
    "pack_id": "uuid pasted from behavior pack",
    "version": [1, 0, 0]
  }
]

6. For multiple behavior packs, add a comma after each } except the last entry.
7. If the addon requires a resource pack, add it to world_resource_packs.json in the same world folder using the resource pack UUID and version.
8. Save the file and restart your server.