Add-on

This feature is exclusive to Bedrock Edition.

 

An add-on is a package format and a type of downloadable content which provides additional custom game features beyond the base game in Bedrock Edition. It contains a set of programming interfaces used for constructing and customizing certain game objects and elements, such as entity, block, item, biome, structure, user interface, and more. It's officially supported by Mojang Studios, which provide the Creator Documentation for developers.

Add-ons consist of three main APIs: a resource pack for managing assets and resources, a behavior pack for defining data-driven behaviors, and the Script API for writing a set of procedural instructions to perform custom behaviors and interactions. Many of its functions and utilities can be used for video game modding.

Add-ons are officially hosted on the Marketplace, where players can download or purchase them on their devices. They must be submitted by members in the Minecraft Partner Program and approved by the Minecraft Content Team.

Overview

Behavior pack

Behavior pack is a data-driven framework used to define behaviors, characteristics, and logic of various things in the game world. It serves as the foundational layer for many aspects of the game, dictating entity behaviors,^[1] loot tables,^[2] spawn rules,^[3] item behaviors,^[4] item recipes,^[5] biome characteristics,^[6] and much more. These definitions are written in JSON files, which are organized in multiple folders by their features. This system allows users to override and modify certain features in the base game, or add unique features with their own behavior pack. Behavior packs are often used in conjunction with resource packs, which enable them to use custom resources, such as models, animations, textures, sounds, and more.

Behavior pack provides a component-based system that makes up most entities in the game by describing their unique properties and behaviors — like health, collision box, movement, mob behaviors, and physics — through multiple components.^[7] These components are hard coded in the game, but are commonly shared among entities, and can be used extensively to create or modify existing entities in a behavior pack. A similar feature in Java Edition would be entity attributes, but are very limited in terms of features compared to components. The component-based system is also used to define custom items, blocks, and biomes.^[8][9][6]

Most entities, biomes, loot tables, and various things from the base game are defined by the vanilla behavior pack, which is built inside the game itself. Mojang releases the Bedrock Add-On Sample Files in every new update of Bedrock Edition, which provide the latest vanilla behavior and resource packs from the game.

Scripting

Scripting is an add-on feature used to write a set of procedural instructions for the game to perform custom behaviors and interactions. Compared to preset components and definitions provided by the game, users may control behaviors of entities, blocks, and items; characteristics of the world; or an entire game loop.^[10]

Script files are used in the scripting environment, they are written in the JavaScript programming language, and loaded by the game under the scripts directory inside an add-on. Users may use TypeScript tooling which provide better error reporting and static type system.^[10][11] The Script API provides multiple modules for users to interact with the game, each module must be added as a dependency in the manifest.json, some notable ones are:^[12]

• @minecraft/common – provides common resources, such as error classes or interfaces.
• @minecraft/server – provides interactions between the script engine and the game world, such as blocks, entities, items, players, and others.
• @minecraft/server-ui – provides players and server communication through customizable forms.
• @minecraft/server-net – provides access to the Internet through web requests, such as GET, POST, and others.
• @minecraft/server-gametest – provides the GameTest framework for testing behaviors and interactions within the game world. See GameTest § Bedrock Edition for further information.
• And other modules, further reading.

The Script API also provide interfaces to define custom components, may change based on Scripting API v2.0.0;^[13] with the upcoming API, they can also be used to define custom commands.^[14]

Marketplace

The Marketplace is an in-game platform where creators may sell their add-ons to the player base. All Marketplace content must be submitted by members in the Minecraft Partner Program and approved by the Minecraft Content Team. A purchased content in the Marketplace is synchronized to the player's Microsoft account, and if they are not signed in, it is saved locally on their device.

Add-ons are usually added to the Marketplace every Tuesday (originally 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 the eventful McDonald's X A Minecraft Movie promotion.

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

History

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

Extra loading tips that appear when a world has add-ons applied have been added since Bedrock Edition Preview 1.20.70.21. By Bedrock Edition Preview 1.21.0.23, eight more of them were introduced which replaced the one from 1.20.70.21.

Previously, standalone add-ons from the Marketplace 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.^[17]

Loading tips

Extra loading tip messages would appear if the player is loading a world with add-ons applied. The loading message box is titled "Modified World", and loading tip messages would primarily warn the player about the add-ons or resource packs applied. Here's the list of add-on applied loading tips:

Videos

Tutorials from the official Minecraft Creator Channel

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[18]

Gallery

• 
  Promotional artwork released alongside the Change your game, your way! cinematic trailer.
• 
  Render of a "Cake Golem" add-on.^[19]
• 
  Artwork of a motorcycle add-on.^[20]
• Animation of the Merchant from the Lush Bath Bomb Add-On.^[21]
• 
  Promotional image for achievement compatibility with add-ons.

See also

• Mod
• Commands
• Data pack
• Resource pack

References

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

Navigation

v t e Gameplay
General mechanics	Attribute Commands Distance Effect Potency Explosion Game rules Interaction range Inventory Creative inventory Saved Hotbars Generated loot Hitbox Multiplayer Server Server list Realms Splitscreen Oxidation Rarity Legacy Redstone circuits Conductivity Renewability Renewable Non-renewable Rotation Snowlogging South-east rule Spawn protection Tiers Waterlogging
Survival	Achievements Advancements Archaeology Armor materials Bartering Breaking Instant mining Breeding Brewing Cooking Crafting 2×2 grid Recipe book Dual wield Difficulty Durability Enchanting Experience Farming Fishing Health Healing Hunger Item repair Mob spawning Ominous Event Ominous Trial Raid Patrol Raid captain Smelting Smithing World Spawn Taming Trading Workstations Zombie siege
Combat	Blocking Damage Attack cooldown Critical hit Knockback Sprint-knockback Drops Monster infighting Geared mobs
Environment	Biomes Daylight cycle Dimensions Seeds Structures Weather World generation More
Movement	Crawling Flying Gliding Jumping Lying Riding Sitting Sneaking Sprinting Swimming Walking
User interface	Action bar Bossbar Chat Death messages Game mode switcher Heads-up display Narrator Locator bar Scoreboard Toasts Tutorial hints Tooltip
Visuals	Color Block colors Item colors Effect colors Miscellaneous colors Emotes Enchantment glint Error Light Resource pack Screen effects Skins Character Skin pack Third-person view Vibrant Visuals
Outdated	Sword blocking Materials Update Suppression

This page was formerly used to gather information for use by Mojang staff, but is now maintained by the community.

 

Mojang has stated they consider this information anecdotal and have no particular plans to use or maintain it.