Hero image

Knowledge Base

How To Add Addons To Your Server

Minecraft Bedrock addons are integrated modifications or additions to the game that enhance or change the gameplay experience and can be downloaded from the in-game marketplace or other online sources. Addons can range from simple tweaks to game mechanics to more complex additions such as new mobs, items, behaviors, and custom features, all designed to work seamlessly within the Bedrock Edition framework. If you wish, you can also make an addon by yourself!

Getting the Server Files

There are 3 main types of files that can contain addons, these are:

  • .mcpack

  • .mcadddon

  • .zip (or other archives)

Follow the steps below to convert them into the required server files.

This article was written for the “Minecraft for Windows” version of the game, installation for other versions (such as Pocket and Xbox editions) may differ slightly depending on your platform.

.mcpack

These files only contain resource packs. For a more detailed guide on how to add them to your server, see this article.

.mcaddon

  1. Double-click the file to open it in Minecraft and add it to the game files.

  2. Wait for Minecraft to open and import the file.

  3. Go to your installation folder. You can easily open it by pressing Win + R and paste %localAppdata%\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\games\com.mojang\.

  4. Open the behavior_packs folder. Inside it you will find all imported packs.

  5. Find the folder with the name of the pack you want and copy it to your desktop.

  6. Repeat steps 4 and 5, but with the resource_packs folder.

Make sure you add _BP and _RP for behavior packs and resource packs respectively to the end of the folder names if both have the same name.

.zip (and other archives)

  1. Unarchive the archive file.

  2. After unarchiving, you will find 2 folders representing resource_packs and behavior_packs.

Adding the addon to your server

Make sure to start the server at least once to generate all the necessary files before continuing.

  1. Login to the Dashboard.

  2. Choose a server from your server list.

  3. Navigate to the File Manager.

  4. Open the resource_packs folder.

  5. Upload your resource pack to this folder.

  6. Return to the home folder.

  7. Open the Worlds folder and open the Bedrock Level folder.

  8. Create a new file called world_resource_packs.json if it doesn’t already exist.

    1. Add the following information to the file, keep the file open so you can fill in the details later:
      [
        {
       "pack_id" : "UUID HERE",
       "version" : [version, number, here]
        }
      ]
      
    1. Add the following information to the file, keep the file open so you can fill in the details later:
      [
        {
       "pack_id" : "FIRST UUID HERE",
       "version" : [version, number, here]
        },
        {
       "pack_id" : "MIDDLE UUID HERE",
       "version" : [version, number, here]
        },
        {
       "pack_id" : "LAST UUID HERE",
       "version" : [version, number, here]
        }
      ]
      

    Add as many entries as the amount of addons you have. Make sure to add a , after each } except for the last one.

  1. Back on your device, open the folder you uploaded and open the manifest.json file.

  2. Copy the UUID and version from the header and enter them into the world_resource_packs.json file on your server under pack_id: and version: like shown in the following examples:

screenshot of manifest.json screenshot of world_resource_packs.json

  1. Save the file and return to the home folder of the File Manager.

  2. Locate and open the behavior_packs folder.

  3. Upload your behavior pack to this folder.

  4. Return to the home folder.

  5. Open the Worlds folder and open the folder called Bedrock Level.

  6. Create a new file called world_behavior_packs.json if it doesn’t already exist.

    1. Add the following information to the file, keep the file open so you can fill in the details later:
      [
        {
      "pack_id" : "UUID HERE",
      "version" : [version, number, here]
        }
      ]
      
    1. Add the following information to the file, keep the file open so you can fill in the details later:
      [
        {
      "pack_id" : "FIRST UUID HERE",
      "version" : [version, number, here]
        },
        {
      "pack_id" : "SECOND UUID HERE",
      "version" : [version, number, here]
        },
        {
      "pack_id" : "LAST UUID HERE",
      "version" : [version, number, here]
        }
      ]
      

    Add as many entries as the amount of addons you have. Make sure to add a , after each } except for the last one.

  1. Back on your device, open the folder you uploaded and open the manifest.json file.

  2. Copy the UUID and version from the header section and enter them into your server’s world_behavior_packs.json file under pack_id: and version: like shown in the following examples:

screenshot of manifest.json screenshot of world_behavior_packs.json

  1. Save the file and navigate back to your servers console.

  2. (Re)start your server.