Add-on

Add-on is a video game modding API for game customization in all versions of Minecraft: Bedrock Edition. They allow certain additions and modifications of the game through a combination of resource packs and behavior packs. They are officially supported by Mojang Studios, who provide official Creator Documentation for the community.

Promotional artwork for the introduction of add-ons to the Marketplace.

Behavior packs can modify the content of the game with the ability to change entity behaviors, loot tables, spawn rules, items, recipes, world generation, and much more. They can also be used to create new entities, blocks, and items, and often used in conjunction with resource packs to create unique experiences that wouldn't be possible in the base game.

Previously, standalone add-ons were not available, and needed to be packaged with a world to be sold on the Marketplace. However, as of February 2024, individual add-ons can now be sold separately on the Marketplace. All Marketplace content is submitted by official Minecraft partners and is approved by the Minecraft Content Team. All purchased content instantly syncs to a player's Microsoft account unless they are not signed into their Xbox profile, in which case it is saved locally to the player's device.

In addition to the Marketplace, there are community websites dedicated to hosting community-made add-ons although such add-ons may only loaded on PCs and phones, whereas consoles can only access those add-ons through Realms Plus.

Add-on was hinted at in a post by Searge on August 12, 2016, stating "There will be news about the API at Minecon." The next day it was confirmed by Grum to be a modding API for Bedrock Edition (formerly called Pocket Edition, or MCPE), and at MINECON 2016, the plan and roadmap for the development of add-ons were outlined.

Add-ons are usually added to the Marketplace every Wednesday, although occasionally appearing on other days. Free add-ons are released as part of special events, for occasions such as to promote the release of A Minecraft Movie, for Minecraft's 15 Years celebration and eventful the McDonald's X A Minecraft Movie promotion.

Warnings

An example of a loading tip since 1.20.70.21.

Added in Bedrock Edition 1.20.70.21, loading tips appear if a world has add-ons applied to it. By 1.21.0.23, Eight more of them were introduced which replaced the one from 1.20.70.21.

#	Text	Version Added
1	You're playing in a world with Add-Ons! This will add new features to your Minecraft world.	Preview 1.21.0.23
2	Don't stop with just one! You can load multiple Add-Ons onto a single world at once.	Preview 1.21.0.23
3	Advanced Tip: A Resource Pack can change the textures of different blocks and entities.	Preview 1.21.0.23
4	Advanced Tip: A Behavior Pack can change how different items, entities, or blocks work.	Preview 1.21.0.23
5	Advanced Tip: An Add-On includes both a Behavior Pack and a Resource Pack. Make sure both packs are activated to ensure the Add-On works!	Preview 1.21.0.23
6	Add-Ons add new blocks, items, or mobs to your worlds.	Preview 1.21.0.23
7	Worlds and Add-ons are complex! While some work great together, you might get funky results with others.	Preview 1.21.0.23
8	More Add-Ons mean more fun, but the game might take longer to load.	Preview 1.21.0.23

Quotes

	“	Within Minecraft, there are so many ways to be creative and build the worlds of your dreams. But when you want to extend Minecraft even further and introduce new mobs, items and other artifacts into your world, you’ll want to go to the next level of creation by building new Add-On packs that can transform Minecraft.	„
		— Mike Ammerlaan

Videos

Tutorials from the official Minecraft Creator Channel

Create a Mob using Blockbench and the Minecraft Entity Wizard (view on YouTube) [show]

Customizing Mob Behaviors with JSON Components (view on YouTube) [show]

Build gameplay with TypeScript (view on YouTube) [show]

Building Custom Blocks with Blockbench (view on YouTube) [show]

Change the world with features (view on YouTube) [show]

Gallery

• 

  Promotional artwork released alongside the Change your game, your way! cinematic trailer.

• 

  Render of a "Cake Golem" add-on.

• 

  Artwork of a motorcycle add-on.

• Animation of the Merchant from the Lush Bath Bomb Add-On.

See also

• Mod
• Commands
• Data pack
• Resource pack

External links

Official documentation

• Addons JSON Documentation
• Animation JSON Documentation
• Biome Documentation
• Block JSON Documentation
• Entity JSON Documentation
• Features JSON Documentation
• Item JSON Documentation
• Molang Documentation
• Recipe JSON Documentation
• Particle JSON Documentation
• Schema Documentation
• Script API Documentation

Official tutorials

• Getting Started With Minecraft Add-Ons
• Introduction to Resource Packs
• Introduction to Behavior Packs
• Getting Started with the Minecraft Entity Wizard
• Getting Started with the Minecraft Item Wizard
• Getting Started with the Minecraft Block Wizard

Tools and libraries

• Commonly Used Tools
• Minecraft Creator Tools
• Bedrock Editor
• Snowstorm
• Chunker

Unofficial resources

• Bedrock Wiki

Templates

Resource and Behavior Example Packs

• Bedrock Add-On Sample Files

Script API Example Packs

• Script API @minecraft/server-gametest samples
• Script API @minecraft/server samples