---
title: "How to install an addon on a Bedrock server"
icon: lucide/puzzle
description: "How to upload behavior packs and resource packs to a Bedrock server and link them to the active world via manifest.json."
---

# How to install an addon on a Bedrock server

On a Bedrock dedicated server, behavior packs and resource packs are usually installed by placing them in the server's pack folders and then linking them to the active world.

!!! warning "Before you start"
    Back up your world first. Make sure the addon is actually compatible with your server's Bedrock version.

## Upload the pack to the right folder

1. Open `https://panel.nexuscloud.id/`.
2. Select your Bedrock server.
3. Go to **Files**.
4. Upload the pack to the matching folder:
   - `behavior_packs/` for behavior packs
   - `resource_packs/` for resource packs
5. Extract the file if it is still a `.zip` or `.mcpack`.

## Check `manifest.json`

Each Bedrock pack has a `manifest.json`. From that file, note down:

- The pack's UUID in the header
- The pack version

The UUID must be a valid UUID in the format, for example:

```text
12345678-1234-1234-1234-1234567890ab
```

## Link the pack to the world

Bedrock worlds usually need a reference file for active packs, such as `world_behavior_packs.json` or `world_resource_packs.json` in the active world's folder.

Example file contents:

```json
[
  {
    "pack_id": "12345678-1234-1234-1234-1234567890ab",
    "version": [1, 0, 0]
  }
]
```

The `pack_id` and `version` must match what is in the pack's `manifest.json`.

## Restart the server

Once the pack files and reference files are in place:

1. Save your changes.
2. Restart the server.
3. Check the console if the addon is not detected.

## Troubleshooting

- Make sure the UUID is valid and not made up.
- Make sure the version in the world file matches the version in `manifest.json`.
- Make sure the pack is in the correct folder.
- Make sure the active world is the one actually referencing that JSON file.

---

!!! tip "Help us out"
    If you found this tutorial useful, please leave a review on [Trustpilot](https://www.trustpilot.com/evaluate/nexuscloud.id)! Your rating helps us make more useful guides :sparkles:

**Cheers, Team NexusCloud**

---