Installation

After downloading the .mcaddon from the Releases page, follow the instructions below to install the pack. The .mcaddon file contains both the behavior and resource packs.

Simple Installation:

1. Open the .mcaddon file. This should automatically open Minecraft and install the pack.
2. You should now see the pack in your behavior and resource packs list.

To add the pack to a world:

1. Open Minecraft and edit the world.
2. Add the behavior and resource packs to the world.
3. Enable the "Beta APIs" experiment toggle.

Once your world is set up, you should see a welcome message in the chat. Many commands can be accessed with a preceding ./, and others with a preceding /. Try ./help to make sure it works!

Manual Installation:

1. Change the .mcaddon file to a zip file and extract it.
2. Place the Canopy [BP] folder in your com.mojang > behavior_packs folder.
3. Place the Canopy [RP] folder in your com.mojang > resource_packs folder.

To manually add the pack to a world:

1. Rename the .mcaddon file to a .zip file and extract it.
2. Place the Canopy [BP] folder in your world_folder > behavior_packs folder.
3. Open the Canopy [BP] > manifest.json and copy the uuid and version from the "header" section.
4. Open the world_folder > world_behavior_packs.json and paste the uuid and version into the "pack_id" and "version" fields.
   • For example, your world_behavior_packs.json may look like this:

[
	{
		"pack_id" : "7f6b23df-a583-476b-b0e4-87457e65f7c0",
		"version" : [ 1, 3, 10 ]
	}
]

5. Place the Canopy [RP] folder in your world_folder > resource_packs folder.
6. Open the Canopy [RP] > manifest.json and copy the uuid and version from the "header" section.
7. Open the world_folder > world_resource_packs.json and paste the uuid and version into the "pack_id" and "version" fields.

Adding Canopy to Servers

Make sure you add "@minecraft/debug-utilities" to your server's config/default/permissions.json. This is not possible on Realms, and is why Canopy has a separate Realms version.

Updating

To update the pack:

1. Download the .mcaddon from the Releases page.
2. Either open the file to have it automatically installed, or replace the pack folders manually in your com.mojang folder.

If an old version of the pack is causing issues, you can try the following:

1. Removing the old packs (Canopy [BP] and Canopy [RP]) through the Minecraft settings.
2. Clearing your pack cache through the Minecraft settings.
3. Removing the old packs from your com.mojang > behavior_packs & com.mojang > resource_packs folders.
4. Removing the old packs from your world folders (world_folder > behavior_packs & world_folder > resource_packs).