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 Minecraft:downloadable content that provides additional custom game features beyond the base game in Minecraft. It contains a set of Template:Ws used for constructing and customizing certain game objects and elements, such as Minecraft:entities, Minecraft:blocks, Minecraft:items, Minecraft:biomes, Minecraft:structures, the Minecraft:user interface, and more. It is officially supported by Minecraft:Mojang Studios, who provide the Creator Documentation for developers.

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

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 Minecraft: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: Minecraft:behavior packs and Minecraft:resource packs. Behavior packs can be used to change Minecraft:gameplay and allow adding and customizing entity behaviors,<ref>Template:Citation</ref> Minecraft:loot tables,<ref>Template:Citation</ref> spawn rules,<ref>Template:Citation</ref> Minecraft:item behaviors,<ref>Template:Citation</ref> item Minecraft: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 Minecraft:textures, Minecraft:models, Minecraft: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 Template:Cd file. An add-on file can be automatically imported by the game, which will organize all contents in the dedicated directories in Template:Cd.

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 Template:Cd 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

Template:Main 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 Template:In 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

File:Breakpointhit.png

Scripting in Template:W with Minecraft debugger enabled

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 Template:W programming language and loaded by the game under the Template:Cd directory inside an add-on. Users may use Template:W, 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>

Module	Description	Latest versions	Notes
Template:Cd	Provides common resources, such as error classes or interfaces.	1.3.0	–
Template:Cd	Provides diagnostics functionality for discovering and diagnosing issues with custom content. Currently provides APIs for Sentry service.	1.0.0-beta	–
Template:Cd	Provides interactions between the script engine and the game world, such as blocks, entities, items, players, and others; additionally provides Custom Components V2 and Custom Commands.	2.9.0 2.11.0-beta	–
Template:Cd	Provides players and server communication through customizable forms. See Minecraft:DDUI for information about the Data-Driven UI framework.	2.1.0 2.3.0-beta	–
Template:Cd	Allows scripts to dynamically customize graphical settings from Minecraft:Vibrant Visuals defined in resource packs.	1.0.0-beta	Pre-release only.
Template:Cd	Provides access to the Internet through web requests, such as GET, POST, and others.	1.0.0-beta	Pre-release only. Only usable on Minecraft:Bedrock Dedicated Server.
Template:Cd	Provides the Minecraft:GameTest framework for testing behaviors and interactions within the game world. See Template:Slink for further information.	1.0.0-beta	Pre-release only. The oldest module for scripting, other names may include: Template:Cd.
Template:Cd	Provides APIs useful for Minecraft:dedicated server administration, such as whitelist management, and managing player permissions.	1.0.0-beta	Pre-release only. Only usable on Minecraft:Bedrock Dedicated Server.
Template:Cd	Provides scripting APIs for Minecraft:Bedrock Editor.Template:Info needed	0.1.0-beta	–
External modules
Template:Cd	Provides utilities and functions for common math operations.	2.4.0	Notable APIs include: Template:Cd and Template:Cd.
Template:Cd	Provides utilities and functions for common gameplay operations.	1.3.0	Notables APIs include: Template:Cd and Template:Cd.

Typing definitions (for use in TypeScript) can be installed via Template:W package manager from the official packages owned by mc-npm. There are other built-in modules, further reading.

External modules are not built directly into the game and act as a helpers or utilities for development; they are available on minecraft-scripting-libraries GitHub and can only be installed through npm. They need to be merged with the scripting project through a bundler; Mojang recommends esbuild for simplicity.

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

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 Minecraft: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 Minecraft: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 Windows and mobile, whereas consoles can only access those add-ons through Minecraft:Realms.

Minecraft Education

File:MCEDU Add-Ons.jpeg

Logo for add-ons on Minecraft Education

In 2026, add-ons were introduced into Minecraft:Minecraft Education.<ref name=":edu">Template:Citation</ref><ref name=":video">Template:YouTube link</ref> These add-ons are all free, and designed to be optional utilities for teachers. All DLC of this nature are referred to as add-ons, however several function as Minecraft:skin packs instead.

Loading tipsTemplate:Anchor

File:Bedrock-modified-world-warning.png

An example of an add-on loading tip

Extra Minecraft:loading tip messages 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. For a full list, see Template:Slink.

List of official add-ons

Bedrock Edition

Image	Name	Description	Release date	Purchasable
File:Spider illager screenshot.jpeg	Minecraft:Minecon 2018 New Entity Sample	A pack to show the usage of add-ons to add custom Minecraft:entities for creators, showcased in Minecraft:MINECON Earth 2018.	November 19, 2018	Template:Tc
File:MCL22 CreatorTools.jpg	Minecraft:Minecraft Live 2022 Sample Pack	A pack to demonstrate the Minecraft Entity Wizard in Minecraft:Blockbench, showcased in Minecraft:Minecraft Live 2022.	October 17, 2022	Template:Tc
File:POIP Thumbnail 0.jpg	Minecraft:Poisonous Potato Add-On	An add-on themed around the poisonous potato April Fools' Day event in 2024.	April 1, 2024	Template:Tc
File:15 Year Party Supplies Key Art.jpg	Minecraft:15 Year Party Supplies	An add-on themed around the Minecraft:15th anniversary of Minecraft with features from Minecraft:15 Year Journey.	May 21, 2024	Template:Tc
File:Tet Thumbnail 0.jpg	Minecraft:Tetris Add-On	A collaborative add-on with features from Minecraft:Tetris.	June 6, 2024	Template:Tc
File:Lush Bath Bomb Add-On key art.jpg	Minecraft:Lush Bath Bomb Add-On	A collaborative add-on to promote bath bombs from Lush.	August 1, 2024	Template:Tc
File:Spongebob Squarepants Add-On Key Art.jpg	Minecraft:SpongeBob SquarePants Add-On	A collaborative add-on with features from Minecraft:SpongeBob SquarePants.	August 20, 2024	Template:Tc
File:Ghost Pets Add-On key art.jpg	Minecraft:Ghost Pets Add-On	A themed add-on with ghost Minecraft:pet mobs for the Minecraft:Expect the unexpected event around Minecraft:The Garden Awakens.	November 4, 2024	Template:Tc
File:Majestic Camping Add-On key art.jpg	Minecraft:Majestic Camping Add-On	A camping-themed add-on for the Expect the unexpected event.	November 4, 2024	Template:Tc
File:Phantom Frames key art.jpg	Minecraft:Phantom Frames	A themed add-on for the Expect the unexpected event.	December 4, 2024	Template:Tc
File:Scary Furniture Add-On Key Art.jpg	Minecraft:Scary Furniture Add-On	An add-on for the Expect the unexpected event with haunted Minecraft furniture blocks.	December 10, 2024	Template:Tc
File:Mob Lights Add-On key art.jpg	Minecraft:Mob Lights Add-On	Another themed add-on for the Expect the unexpected event.	December 10, 2024	Template:Tc
File:Monster Food Add-On thumbnail.jpg	Minecraft:Monster Food Add-On	An add-on featured for Expect the unexpected with haunted food items and mobs.	December 10, 2024	Template:Tc
File:Lava Chicken Add-On key art.jpg	Minecraft:Lava Chicken Add-On	A promotional add-on for A Minecraft Movie which adds Steve's Lava Chicken shown in the movie.	December 20, 2024	Template:Tc
File:Sonic Add-On Key Art.jpg	Minecraft:Sonic Add-On	A collaborative add-on with features from Minecraft:Sonic the Hedgehog.	January 7, 2025	Template:Tc
File:AMCM Add-On thumbnail.jpg	Minecraft:A Minecraft Movie: Add-On	An add-on that adds many features shown in A Minecraft Movie.	February 26, 2025	Template:Tc
File:Jet Pack key art.jpeg	Minecraft: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	Template:Tc
File:McDonald's Add-On key art.jpg	Minecraft:McDonald's Add-On	An add-on themed around the collaboration of A Minecraft Movie with McDonald's.	March 24, 2025	Template:Tc
File:Timecapsule Thumbnail 0.jpeg	Minecraft:Time Capsule Add-On	A promotional add-on made for the Minecraft:15 Days of Minecraft event.	May 16, 2025	Template:Tc
File:MLBFanCave Thumbnail 0.jpeg	Minecraft:MLB Fan Cave Add-On		June 2, 2025	Template:Tc
File:Adidas Adventurers Add-On key art.jpg	Minecraft:adidas Adventurers Add-On	A collaborative add-on with Minecraft:Adidas.	June 3, 2025	Template:Tc
File:HTTYD thumbnail 0.jpeg	Minecraft:How to Train Your Dragon Add-On	A collaborative add-on with Minecraft:Universal Studios about the movie How to Train Your Dragon.	June 10, 2025	Template:Tc
File:Minecraft Vibrant Memories.jpeg	Minecraft:Vibrant Memories Add-On	An add-on made to promote Minecraft:Vibrant Visuals after its release.	June 18, 2025	Template:Tc
File:Claims Adjuster Add-On Cover.jpg	Minecraft:Claims Adjuster Add-On	An official add-on that has been promoted with the Minecraft:Ice Cube Claims Adjuster series.	August 13, 2025	Template:Tc
File:Jurassic World Add-On key art.jpg	Minecraft:Jurassic World Add-On	A collaborative add-on with the Minecraft:Jurassic Park franchise.	September 16, 2025	Template:Tc
File:Friendly Fishing Add-On Key Art.jpeg	Minecraft:Friendly Fishing Add-On	An official collaborative add-on between Marketplace Partners and Conservation International themed around sea life.	September 26, 2025	Template:Tc
File:TRON Add-On key art.jpg	Minecraft:TRON Add-On	A collaborative add-on between Minecraft and the Tron: Ares movie.	October 16, 2025	Template:Tc
File:Minecraft Mounts of Mayhem Dungeon Descent key art.jpg	Minecraft:Mounts of Mayhem: Dungeon Descent	An add-on released to promote new features from Minecraft:Mounts of Mayhem.	January 12, 2026	Template:Tc
File:Tiny Takeover Mini Mania key art.jpg	Minecraft:Tiny Takeover: Mini Mania	A minigame-centric add-on released to promote Minecraft:Tiny Takeover.	April 21, 2026	Template:Tc
File:LEGO Minecraft ChickenMounts Thumbnail 0.jpg	Minecraft:LEGO Minecraft Chicken Mounts		May 30, 2026	Template:Tc
File:Herschel Backpack Trials Add-On key art.jpg	Minecraft:Herschel Backpack Trials Add-On		June 23, 2026	Template:Tc
File:Chaos Cubed Cursed Cubes Add-On Key Art.jpg	Minecraft:Chaos Cubed: Cursed Cube Add-On	An add-on released to promote Minecraft:Chaos Cubed.	June 24, 2026	Template:Tc
File:Chaos Cubed Pixel Party key art.jpg	Minecraft:Chaos Cubed: Pixel Party		June 24, 2026	Template:Tc
File:Hive of Harmony Thumbnail.jpg	Minecraft:Hive of Harmony Add-On		July 27, 2026	Template:Tc
File:Hello Kitty and Friends Furniture key art.jpg	Minecraft:Hello Kitty and Friends Furniture		July 28, 2026	Template:Tc
File:Transformers Add-On key art.jpg	Minecraft:Transformers Add-On		September 12, 2026	Template:Tc
File:Avatar Legends Add-On key art.jpg	Minecraft:Avatar Legends Add-On	A collaborative add-on with features from the Minecraft:Avatar Legends franchise	October 16, 2026	Template:Tc
	Minecraft:Music Features Add-On	A built-in add-on that allows players to create custom Minecraft:music discs with the disc press block.	October 18, 2026	Template:Tc

Minecraft Education

Image	Name	Description	Release date	Purchasable
File:MCEDU Dice.jpeg	Minecraft:Dice	An add-on which introduces dice blocks.	April 9, 2026	Template:Tc
File:MCEDU Math Chests Divison.jpeg	Minecraft:Math Chests Division	An add-on which adds chest blocks made for division.	April 9, 2026	Template:Tc
File:MCEDU Math Chests Multiplication.jpeg	Minecraft:Math Chests Multiplication	An add-on which adds chest blocks made for multiplication.	April 9, 2026	Template:Tc
File:MCEDU Roman Balneae.jpeg	Minecraft:Roman Balneae Structure Pack	An add-on which adds a Roman structure.Template:Info needed	April 9, 2026	Template:Tc
File:MCEDU Ancient Egypt NPC Pack 1.png	Minecraft:Ancient Egypt NPC Pack 1	An add-on which adds NPC skins.	April 9, 2026	Template:Tc
File:MCEDU Ancient Greece NPC Pack 1.jpeg	Minecraft:Ancient Greece NPC Pack 1	An add-on which adds NPC skins.Template:Info needed	April 9, 2026	Template:Tc
File:MCEDU Number Shaped Blocks.jpeg	Minecraft:Number Shaped Blocks	An add-on which adds blocks molded to various numbers.	April 9, 2026	Template:Tc
File:MCEDU Number Blocks.jpeg	Number Blocks	An add-on which introduces numeric blocks.	April 9, 2026	Template:Tc
File:MCEDU Ancient Rome NPC Pack 1.png	Minecraft:Ancient Rome NPC Pack 1	An add-on which adds NPC skins.	April 9, 2026	Template:Tc
File:MCEDU Non-transitive Dice.jpeg	Minecraft:Non-transitive Dice	An add-on which adds non-transitive dice.	April 9, 2026	Template:Tc

History

General

This section includes major additions and milestones of add-ons. It also includes all Minecraft:Marketplace related history. Template:HistoryTable

Videos

Tutorials from the official Minecraft Creator Channel. Template:Yt Template:Yt Template:Yt Template:Yt Template:Yt Template:Yt

Historical videos

These videos were uploaded when add-ons were first introduced. They demonstrate how add-ons could create customized gameplay and modify existing entities.

The first introduction of add-ons Template:Yt Template:Yt

Early add-ons tutorial and playthrough Template:Yt Template:Yt Template:Yt

Early Scripting API and experimental custom UI<ref name="minecraft-script-engine"/> Template:Yt

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 Minecraft:Change your game, your way! cinematic trailer
  Promotional artwork released alongside the Minecraft: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
• Minecraft:Data pack
• Minecraft:Resource pack
• Minecraft:Skin pack
• Minecraft:World template
• Minecraft:Mash-up 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
• Minecraft Addons - CurseForge
• Minecraft PE Mods, Maps, Skins, Seeds, Texture Packs | MCPEDL
• Modbay | Everything for Minecraft PE

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