Minecraft:Add-on

File:Minecraft Add-Ons Poster.jpg

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

An add-on is a package format and a type of downloadable content that provides additional custom game features beyond the base game in Minecraft. It contains a set of

1. REDIRECT Template:Wikipedia

Template:Redrs used for constructing and customizing certain game objects and elements, such as entities, Minecraft:blocks, Minecraft:items, Minecraft:biomes, Minecraft:structures, the user interface, and more. It is officially supported by Mojang Studios, who provide the Creator Documentation for developers.

Add-ons consist of three main APIs: a resource pack for managing assets and resources, a Minecraft:behavior pack for defining data-driven behaviors, and the Script API for writing a set of procedural instructions to perform custom behaviors and interactions. These functions and utilities are used for

1. REDIRECT Template:Wikipedia

Template:Redr.

Add-ons are officially hosted on the Minecraft:Marketplace, where players can download or purchase them on their devices using an in-game digital currency called Minecraft:Minecoins. They must be submitted by members in the Minecraft:Minecraft Partner Program and approved by the Minecraft Content Team, or made directly in collaboration with Mojang Studios as official DLC. They can also be packaged for external downloading, but these cannot be imported on consoles.

Overview

Packs

Add-ons can be created with two types of data packs: behavior packs and resource packs. Behavior packs can be used to change gameplay and allow adding and customizing entity behaviors,<ref>Template:Citation</ref> loot tables,<ref>Template:Citation</ref> spawn rules,<ref>Template:Citation</ref> Minecraft:item behaviors,<ref>Template:Citation</ref> item recipes,<ref>Template:Citation</ref> biome characteristics,<ref name="biome-component-list">Template:Citation</ref> and much more. Resource packs affect how the game looks and have no effect on gameplay, and they allow adding and customizing textures, models, music, texts, and interfaces.

Definitions are written in Minecraft: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 pack.

All contents of an add-on can be packaged together in a zipped

1. REDIRECT Template:Code

Template:Redr file. An add-on file can be automatically imported by the game, which will organize all contents in the dedicated directories in

1. REDIRECT Template:Code

Template:Redr.

Sub-packs

Resource packs and behavior packs can contain other packs inside the root, known as sub-packs.<ref>Template:Cite</ref> A sub-pack has the same format as the main pack and the directory of a sub-pack can have any name. Sub-packs need to be specified in the

1. REDIRECT Template:Code

Template:Redr file of the main pack, where a name and minimum memory tier can also be added. For example, a pack can have multiple less resource-intensive sub-packs for lower memory tiers, but it can also be used for other types of settings. The memory tier, affecting which sub-pack is used, can be adjusted in the pack's settings menu in-game.

Molang

{{#vardefine:params|0 }}Template:Hatnote Molang is a simple expression-based language designed for fast, data-driven calculation of values at run-time, and with a direct connection to in-game values and systems. It is used in Template:Editions in their add-on system with its purpose being to enable low-level systems like animation to support flexible data-driven behavior for both internal and external creators, while staying highly performant.<ref>"Molang Documentation - Introduction to Molang"</ref>

Scripting

Scripting is an add-on feature used to write a set of procedural instructions for the game to perform custom behaviors and interactions at a certain time or in response to events and actions.<ref>Template:Citation</ref> It lets users control behaviors of entities, blocks, and items; characteristics of the world; or an entire game loop.<ref name="intro-scripting">Template:Citation</ref> It is fundamentally different from the behavior pack system, the latter uses a component system with preset definitions provided by the game.

Script files are written in the

1. REDIRECT Template:Wikipedia

Template:Redr programming language and loaded by the game under the

1. REDIRECT Template:Code

Template:Redr directory inside an add-on. Users may use

1. REDIRECT Template:Wikipedia

Template:Redr, a dialect of JavaScript, which provides better error reporting and a static type system.<ref name="intro-scripting"/><ref>Template:Citation</ref> The Scripting API provides script modules for users to interact with the game, each module must be added as a dependency in the Minecraft:manifest.json, some notable ones are:<ref>Template:Citation</ref>

1. REDIRECT Template:Code

Template:Redr – provides common resources, such as error classes or interfaces.

1. REDIRECT Template:Code

Template:Redr – provides interactions between the script engine and the game world, such as blocks, entities, items, players, and others.

1. REDIRECT Template:Code

Template:Redr – provides players and server communication through customizable forms.

1. REDIRECT Template:Code

Template:Redr – allows to dynamically customize graphical settings from Minecraft:Vibrant Visuals defined in resource packs, at this moment only atmospherics.

1. REDIRECT Template:Code

Template:Redr – provides access to the Internet through web requests, such as GET, POST, and others.

1. REDIRECT Template:Code

Template:Redr – provides the Minecraft:GameTest framework for testing behaviors and interactions within the game world. See Template:Slink for further information.

• And other modules, further reading.

The Scripting API also provides a way to define and register custom commands.<ref>Template:Citation</ref>

The Scripting API version 2 is a major update to the Scripting API, which provides a new API to define custom components along with other major API changes that aren't backward compatible with the previous version.<ref>Template:Citation</ref><ref>Template:Citation</ref>

Marketplace

The Minecraft: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:Minecraft Partner Program and approved by the Minecraft Content Team. 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.

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. See Template:Slink for a full list of add-ons officially promoted by Mojang Studios.

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 Minecraft:Realms.

Loading tips

File:Bedrock-modified-world-warning.png

An example of a loading tip since 1.20.70.21.

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: {{#section:Loading tip|add-on-tips}}

Official add-ons

{{#vardefine:params|0 }}Template:Hatnote

Image	Name	Description	Release date	Purchasable
	Minecraft:Minecon 2018 New Entity Sample	A pack to show the usage of add-ons to add custom entities for creators, showcased in MINECON Earth 2018.	November 19, 2018	REDIRECT Template:Table choice
	Minecraft:Minecraft Live 2022 Sample Pack	A pack to demonstrate the Minecraft Entity Wizard in Blockbench, showcased in Minecraft Live 2022.	October 17, 2022	REDIRECT Template:Table choice
width=150x150	Poisonous Potato	An add-on themed around the poisonous potato April Fools' Day event in 2024.	April 1, 2024	REDIRECT Template:Table choice
width=150x150	Minecraft:15 Year Party Supplies	An add-on themed around the 15th anniversary of Minecraft with features from Minecraft:15 Year Journey.	May 21, 2024	REDIRECT Template:Table choice
width=150x150	Tetris	A collaborative add-on with features from Tetris.	June 6, 2024	REDIRECT Template:Table choice
width=150x150	Lush Bath Bomb	A collaborative add-on to promote bath bombs from Lush.	August 1, 2024	REDIRECT Template:Table choice
width=150x150	SpongeBob SquarePants	A collaborative add-on with features from SpongeBob SquarePants.	August 20, 2024	REDIRECT Template:Table choice
width=150x150	Ghost Pets	A themed add-on with ghost pet mobs for the Expect the unexpected event around The Garden Awakens.	November 4, 2024	REDIRECT Template:Table choice
width=150x150	Majestic Camping	A camping-themed add-on for the Expect the unexpected event.	November 4, 2024	REDIRECT Template:Table choice
width=150x150	Minecraft:Phantom Frames	A themed add-on for the Expect the unexpected event.	December 4, 2024	REDIRECT Template:Table choice
width=150x150	Scary Furniture	An add-on for the Expect the unexpected event with haunted Minecraft furniture blocks.	December 10, 2024	REDIRECT Template:Table choice
width=150x150	Mob Lights	Another themed add-on for the Expect the unexpected event.	December 10, 2024	REDIRECT Template:Table choice
width=150x150	Monster Food	An add-on featured for Expect the unexpected with haunted food items and mobs.	December 10, 2024	REDIRECT Template:Table choice
width=150x150	Lava Chicken	A promotional add-on for A Minecraft Movie which adds Steve's Lava Chicken shown in the movie.	December 20, 2024	REDIRECT Template:Table choice
width=150x150	Sonic	A collaborative add-on with features from Sonic the Hedgehog.	January 7, 2025	REDIRECT Template:Table choice
width=150x150	A Minecraft Movie	An add-on that adds many features shown in A Minecraft Movie.	February 26, 2025	REDIRECT Template:Table choice
width=150x150	A Minecraft Movie: JetPack	A limited promotional add-on for A Minecraft Movie which could be obtained by purchasing tickets on its opening weekend.	February 27, 2025	REDIRECT Template:Table choice
width=150x150	McDonald's	An add-on themed around the collaboration of A Minecraft Movie with McDonald's.	March 24, 2025	REDIRECT Template:Table choice
width=150x150	Time Capsule	A promotional add-on made for the 15 Days of Minecraft event.	May 16, 2025	REDIRECT Template:Table choice
width=150x150	MLB Fan Cave		June 2, 2025	REDIRECT Template:Table choice
width=150x150	Adidas Adventurers	A collaborative add-on with Adidas.	June 3, 2025	REDIRECT Template:Table choice
width=150x150	How to Train Your Dragon	A collaborative add-on with Universal Studios about the movie How to Train Your Dragon.	June 10, 2025	REDIRECT Template:Table choice
width=150x150	Vibrant Memories	An add-on made to promote Minecraft:Vibrant Visuals after its release.	June 18, 2025	REDIRECT Template:Table choice
width=150x150	Claims Adjuster	An official add-on that has been promoted with the Ice Cube Claims Adjuster series.	August 13, 2025	REDIRECT Template:Table choice
width=150x150	Friendly Fishing	An official collaborative add-on between Marketplace Partners and Conservation International themed around sea life.	September 26, 2025	REDIRECT Template:Table choice
	Jurassic World			REDIRECT Template:Table choice
	TRON			REDIRECT Template:Table choice
width=150x150	Dungeon Descent	An add-on released to promote new features from Mounts of Mayhem.	January 12, 2026	REDIRECT Template:Table choice

Videos

Tutorials from the official Minecraft Creator Channel.

1. REDIRECT Template:YouTube

1. REDIRECT Template:YouTube

1. REDIRECT Template:YouTube

1. REDIRECT Template:YouTube

1. REDIRECT Template:YouTube

1. REDIRECT Template:YouTube

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.

Gallery

• Promotional artwork released alongside the Change your game, your way! cinematic trailer
  Promotional artwork released alongside the Change your game, your way! cinematic trailer
• Render of a "Cake Golem" add-on<ref>Template:Citation</ref>
  Render of a "Cake Golem" add-on<ref>Template:Citation</ref>
• Artwork of a motorcycle add-on<ref>Template:Citation</ref>
  Artwork of a motorcycle add-on<ref>Template:Citation</ref>
• Animation of the Merchant from the Minecraft:Lush Bath Bomb Add-On<ref>Template:Tweet</ref>
  Animation of the Merchant from the Minecraft:Lush Bath Bomb Add-On<ref>Template:Tweet</ref>
• Promotional image for Minecraft:achievement compatibility with add-ons
  Promotional image for Minecraft:achievement compatibility with add-ons

See also

• Minecraft:Mod
• Minecraft:Commands
• Data pack
• Resource pack
• Minecraft:Skin pack
• World template
• Minecraft:Mash-up pack

References

<references group="">

 </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
• Minecraft Addons - CurseForge
• Minecraft PE Mods, Maps, Skins, Seeds, Texture Packs | MCPEDL

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

Events	Template:EntityLink Template:ItemLink Template:ItemLink Template:ItemLink Template:ItemLink Template:ItemLink Template:ItemLink Template:ItemLink Template:BlockLink Friendly Fishing
Promotional	Template:ItemLink Template:ItemLink Template:SkinLink Template:MovieLink Template:ItemLink Template:MovieLink Template:MovieLink Template:MovieLink MLB Fan Cave Adidas Adventurers Template:ItemLink Template:ItemLink Template:EntityLink Jurassic World TRON Template:ItemLink Mini Mania
Samples	Template:EntityLink Template:ItemLink Tomatoes Template:EntityLink Template:ItemLink Template:EntityLink
China Edition	Template:EntityLink China Edition Add-ons

General mechanics	Template:EnvLink Template:BlockLink Template:FileLink Template:FileLink Template:EffectLink Template:EnvLink Template:ItemLink Interaction range Template:ItemLink Template:BlockLink Template:ItemLink Template:FileLink Template:BlockLink Template:EnvLink Template:FileLink Template:EnvLink Template:FileLink Template:FileLink Template:BlockLink Template:ItemLink Legacy Template:BlockLink Template:BlockLink Template:FileLink Template:BlockLink Template:FileLink Template:FileLink Template:BlockLink Template:ItemLink Template:BlockLink Template:BlockLink
Technical mechanics	Template:BlockLink Legacy Template:FileLink Template:BlockLink Template:ItemLink Template:EnvLink Legacy
Survival	Template:FileLink Template:ItemLink Template:ItemLink Template:ItemLink Template:ItemLink Template:ItemLink Template:EffectLink Template:ItemLink Template:BlockLink Template:BlockLink Template:FileLink Template:EnvLink Template:ItemLink Template:Healthbar Death Template:EnvLink Template:Healthbar Difficulty Template:EffectLink Template:FileLink Template:EntityLink Template:ItemLink Template:ItemLink Template:EffectLink Template:EffectLink Template:ItemLink Template:EffectLink Template:EffectLink Template:BlockLink Template:EntityLink Template:EntityLink Template:EnvLink Template:EffectLink Template:EffectLink Template:EffectLink Template:EntityLink Template:BlockLink Template:BlockLink Template:EnvLink Template:EnvLink Template:FileLink Template:BlockLink Template:ItemLink Template:EntityLink Template:ItemLink Template:BlockLink Template:EntityLink
Combat	Template:Healthbar Damage Template:EffectLink Template:EffectLink Template:ItemLink Template:EffectLink Template:ItemLink Template:EnvLink Template:ItemLink Template:ItemLink Template:ItemLink Template:ItemLink Template:ItemLink Template:EntityLink Template:ItemLink Template:EntityLink Template:EntityLink More
Environment	Template:EnvLink Template:EnvLink Template:EnvLink Template:EnvLink Template:EnvLink Template:EnvLink Template:EnvLink More
Movement	Template:EnvLink Template:ItemLink Template:ItemLink Template:EffectLink Template:BlockLink Template:EnvLink Template:EnvLink Template:EnvLink Template:EnvLink Template:EnvLink Template:ItemLink Template:EffectLink
User interface	Template:ItemLink Template:EntityLink Template:EnvLink Template:EffectLink Template:ItemLink Template:ItemLink Template:Armorbar Heads-up display Template:EnvLink Template:BlockLink Template:FileLink Template:EnvLink Template:InvLink Template:BlockLink Template:ItemLink
Visuals	Template:EnvLink Template:BlockLink Template:ItemLink Template:ItemLink Template:EnvLink Template:EnvLink Template:ItemLink Template:EffectLink Template:EnvLink Ray Tracing Template:EnvLink Template:ItemLink Template:EntityLink Template:PersonaLink Template:EnvLink Template:EnvLink Template:EnvLink
Removed	Template:ItemLink Template:BlockLink
Unintended	Template:BlockLink Template:BlockLink

Editions	Merged Template:Edition Template:Edition Ports to consoles Template:Wikipedia Template:Wikipedia Template:Wikipedia Template:Wikipedia Template:Wikipedia Discontinued Template:Edition Template:Edition Template:Edition
Development	Version history Template:LegacyBlockLink Template:EntityLink Template:FileLink Template:FileLink Template:EnvLink Template:ItemLink Template:BlockLink Template:InvLink Template:EntityLink Template:FileLink Template:EntityLink
Technical	Template:EffectLink Template:FileLink Template:FileLink Template:File com.mojang Template:FileLink Template:File Installation files Template:FileLink Template:FileLink Template:FileLink Template:FileLink Template:BlockLink Template:File Identifier Template:FileLink Template:ItemLink Template:EnvLink Template:EnvLink Anomalous Template:ItemLink Template:EnvLink § Formatting codes Simulation distance Template:BlockLink Template:FileLink Template:FileLink Template:EnvLink Template:FileLink Template:EntityLink Template:BlockLink Development resources Template:Nbt NBT format Template:Nbt Level format Template:EnvLink Protocol Template:EnvLink RakNet Creator Template:File Official documentation Template:FileLink Template:EntityLink Template:File File extensions Template:FileLink Add-ons Template:ItemLink Template:EnvLink Template:EnvLink Template:EnvLink Template:EnvLink Template:FileLink Template:EnvLink Template:EnvLink Template:BiomeLink Template:EnvLink Family Spawn event Template:ItemLink Template:BlockLink Template:EnvLink Template:BiomeLink Template:EnvLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink manifest.json Template:EnvLink Template:Nbt Molang Template:BlockLink
Multiplayer	Template:FileLink Featured servers Event servers Server list Template:FileLink Template:FileLink Template:FileLink Template:FileLink
Exclusive features	Template:FileLink Template:FileLink Template:FileLink Template:FileLink Template:FileLink Template:EnvLink Template:EnvLink Template:ItemLink Template:FileLink Template:FileLink Template:EnvLink Template:EnvLink Template:EnvLink Template:PersonaLink Template:EnvLink Loading tips Template:FileLink Ray Tracing Template:BiomeLink Template:EnvLink Blocks Template:BlockLink Template:BlockLink Mobs Template:EntityLink Template:EntityLink Effects Template:EffectLink Unused Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:BlockLink Template:EntityLink Template:EntityLink Template:BiomeLink Template:EnvLink
Removed	Template:BlockLink Template:EnvLink Template:EnvLink Template:FileLink Pocket Edition protocol Legacy

Official	Template:FileLink Project Malmö
By Minecraft Wiki	Template:FileLink
Add-ons (BE)	Behavior pack Resource pack Official resources Getting Started Resource Packs Behavior Packs

de:Add-on es:Add-on fr:Extension ja:Add-on ko:애드온 lzh:附囊 pt:Complemento ru:Дополнения th:แอดออน uk:Доповнення zh:附加包