Skip to main content

How to Install a Behavior Pack

Preparation​

  • Make sure the Behavior Pack or Addon matches the server version.
  • Extract the .mcaddon or .zip file until it becomes a main folder with manifest.json inside it.
  • Note down:
    • header.uuid → the pack's unique ID
    • version → format [major, minor, patch]

Upload to the Server​

  1. Go into the server's root directory.
  2. Upload the Behavior Pack folder to /behavior_packs.
  3. Make sure the folder structure is correct:
behavior_packs/Pack_Name/manifest.json

❌ Avoid having a doubled folder like /behavior_packs/Pack_Name/Pack_Name

Register in the World​

  1. Open the world folder: /worlds/<World Name>/
  2. Edit or create the world_behavior_packs.json file
  3. Add an entry like this:
[
  {
    "pack_id": "UUID-BEHAVIOR",
    "version": [1, 0, 0]
  }
]
  1. Save the changes and restart the server

Using 2 or More​

  • For more than one pack, add each pack as an object inside the JSON array.
  • Separate them with commas.
  • Example:
[
  {
    "pack_id": "UUID-BEHAVIOR-1",
    "version": [1, 0, 0]
  },
  {
    "pack_id": "UUID-BEHAVIOR-2",
    "version": [2, 3, 1]
  }
]

Notes​

  • Order can matter if two packs modify the same thing — the one last in the list tends to override the earlier ones.
  • Make sure all packs are compatible with each other.
  • The folder structure in /behavior_packs must stay tidy.

Tips & Troubleshooting​

  • Addon not detected: Double-check manifest.json, the UUID, and the folder structure.
  • Server error on start: Make sure the pack version matches the server version.
  • Changes not showing up: Ask players to clear the pack cache on their client before rejoining.