Minecraft Bedrock Edition natively supports add-ons and has a huge community that lets you expand gameplay with your friends. An add-on consists of a Behavior Pack (game behavior) and/or a Resource Pack (textures, sounds, models). In this guide, we'll show you how to install and activate add-ons on your Minecraft Bedrock server in ZapX.
You don't need to do any manual work for most add-ons: In the Add-ons tab, you can browse the Bedrock catalog from CurseForge directly in ZapX and install Add-ons and Texture Packs with a click.
- In ZapX, open your server's Add-ons tab.
- Find the add-on you want and install it. By default, the list only shows versions that match your server version.
- Restart your server.
ZapX extracts the add-on, places the Behavior and Resource Packs in the behavior_packs and resource_packs folders, and adds them to your current world. They will be active after the restart.
Add-ons are added to the world that is active when you install them. If you later switch to another world using the World Folder startup parameter, install the add-ons again in that world.
If your add-on isn't available on CurseForge, install it manually using one of the following two methods.
This is the easiest way to start a new world with add-ons:
- Open the downloaded
.mcaddonor.mcpackfile on your PC. Minecraft Bedrock will launch and import the add-on. - Click Play, then Create New World. Adjust the world settings as desired.
- Before creating the world, go to Behavior Packs and Resource Packs, then click Activate for the add-on in each section. Some add-ons include both packs, in which case you should activate both.
- Click Create.
Then export the world and upload it to your server, as described in our guide Importing a custom world. The packs are already included in the exported world.
If an add-on requires Experiments (Experimental Features), enable them in the world settings on your PC before exporting the world. You can't enable them on the server through server.properties.
This method takes a little more work, but it lets you keep your existing server world and all your progress.
.mcaddon and .mcpack files are ZIP archives. Extract them on your PC, for example with 7-Zip: Right-click the file, then select 7-Zip and Extract to with the file's name as the folder name. An .mcaddon file usually contains additional .mcpack files, which you'll also need to extract.
When you're done, you'll have a folder for each pack with a manifest.json file directly inside it. You can usually tell whether it's a Behavior Pack or a Resource Pack from the folder name: Resource Packs have RP in the name, and Behavior Packs have BP. To confirm, check the manifest.json: In the modules section, Behavior Packs have "type": "data", while Resource Packs have "type": "resources".
Stop your server in ZapX and open the Files tab. Upload the pack folders to these directories:
| Pack | Folder on the server |
|---|---|
Behavior Pack (BP) | behavior_packs |
Resource Pack (RP) | resource_packs |
For larger folders, it's easiest to upload them via SFTP using FileZilla or WinSCP. You can also find your login details in the Files tab. For more information, see our guide Access via SFTP.
Upload the correct folder.
The manifest.json must be directly inside the uploaded pack folder, for example behavior_packs/MyAddon_BP/manifest.json, not in another subfolder.
To make your world load the packs, add them to two files in your world's folder. Your world is located in the worlds folder under the name specified in the World Folder startup parameter. The default is worlds/Bedrock level.
- Open the Behavior Pack's
manifest.jsonand note theuuidandversionvalues in theheadersection. - In your world folder, open the
world_behavior_packs.jsonfile. If it doesn't exist yet, create it. - Add the pack as shown below, replacing the placeholders with your values:
[
{
"pack_id": "UUID HIER",
"version": [1, 0, 0]
}
]
- Repeat these steps for the Resource Pack using the
world_resource_packs.jsonfile in the same folder.
Adding multiple packs Add each additional pack as another entry in the list. Separate entries with a comma, but don't add one after the last entry:
[
{ "pack_id": "UUID PACK 1", "version": [1, 0, 0] },
{ "pack_id": "UUID PACK 2", "version": [2, 1, 0] }
]
If you want all players to use your server's Resource Packs, set the following line in server.properties: texturepack-required=true.
Start your server, connect to it, and check that the add-ons are working. You can see pack-related error messages in the Console at startup. Common causes include an incorrect pack_id or version, a pack folder that's nested one level too deep, or an add-on that's incompatible with your server version.
Installing add-ons on your Minecraft Bedrock server is a great way to expand gameplay and add new content. For more settings, see our guide Server configuration. If you have any other questions or run into problems, our support team is available every day—we're happy to help! 🙂