Toggle search
Toggle menu
20.8K
1.7K
7
111.7K
SAS Gaming Wiki
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Minecraft:Add-on: Difference between revisions

From SAS Gaming Wiki
More actions
← Older edit
VisualWikitext
SyncBot (talk | contribs)
Bots
74,239 edits
Fix template calls: add MC/ prefix
SyncBot (talk | contribs)
Bots
74,239 edits
Sync: updated from Minecraft
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{For|similar game customization in {{MC/JE}}|Data pack|Mod}}
{{For|similar game customization in {{JE}}|Data pack|Mod}}
{{MC/Exclusive|bedrock}}
{{exclusive|bedrock}}
[[File:Minecraft Add-Ons Poster.jpg|thumb|right|Promotional artwork for the introduction of add-ons to the [[Marketplace]]]]
[[File:Minecraft Add-Ons Poster.jpg|thumb|right|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 {{MC/W|programming interface}}s used for constructing and customizing certain game objects and elements, such as entities, [[Minecraft:block]]s, [[Minecraft:item]]s, [[Minecraft:biome]]s, [[Minecraft:structure]]s, the user interface, and more. It is officially supported by Mojang Studios, who provide the [https://learn.microsoft.com/en-us/minecraft/creator/ Creator Documentation] for developers.
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 {{w|programming interface}}s used for constructing and [[Minecraft:Game customization|customizing]] certain game objects and elements, such as [[Minecraft:entities]], [[Minecraft:block]]s, [[Minecraft:item]]s, [[Minecraft:biome]]s, [[Minecraft:structure]]s, the [[Minecraft:user interface]], and more. It is officially supported by [[Minecraft:Mojang Studios]], who provide the [https://learn.microsoft.com/en-us/minecraft/creator/ 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 {{MC/W|video game modding}}.
Add-ons consist of three main APIs: a [[Minecraft:resource pack]] for managing assets and resources, a [[Minecraft:behavior pack]] for defining [[Minecraft:w:Data-driven programming|data-driven]] behaviors, and scripting for writing a [[Minecraft:w:Imperative programming|set of procedural instructions]] to perform custom behaviors and interactions. These functions and utilities are used for {{w|video game modding}}.


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:Minecoin]]s. 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.
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:Minecoin]]s. 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 ==
== Overview ==
=== Packs ===
=== 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>{{citation|url=https://learn.microsoft.com/en-us/minecraft/creator/documents/entitybehaviorintroduction?view=minecraft-bedrock-stable|title=Entity Behavior Introduction|website=Microsoft Learn|date=September 19, 2023}}</ref> loot tables,<ref>{{citation|url=https://learn.microsoft.com/en-us/minecraft/creator/documents/introductiontoloottables?view=minecraft-bedrock-stable|title=Introduction to Loot Tables|website=Microsoft Learn|date=March 6, 2025}}</ref> spawn rules,<ref>{{citation|url=https://learn.microsoft.com/en-us/minecraft/creator/reference/content/entityreference/examples/cliententitydocumentation/datadrivenspawning?view=minecraft-bedrock-stable|title=Data-Driven Spawn Rules|website=Microsoft Learn|date=November 8, 2023}}</ref> [[Minecraft:item]] behaviors,<ref>{{citation|url=https://learn.microsoft.com/en-us/minecraft/creator/documents/addcustomitems?view=minecraft-bedrock-stable|title=Custom Items|website=Microsoft Learn|date=September 18, 2024}}</ref> item recipes,<ref>{{citation|url=https://learn.microsoft.com/en-us/minecraft/creator/documents/recipeintroduction?view=minecraft-bedrock-stable|title=Recipe Introduction|website=Microsoft Learn|date=April 19, 2024}}</ref> biome characteristics,<ref name="biome-component-list">{{citation|url=https://learn.microsoft.com/en-us/minecraft/creator/documents/biomes/biomeoverview?view=minecraft-bedrock-stable|title=Biome JSON and Overview|website=Microsoft Learn|date=April 10, 2025}}</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.
Add-ons can be created with two types of data packs: [[Minecraft:behavior pack]]s and [[Minecraft:resource pack]]s. Behavior packs can be used to change [[Minecraft:gameplay]] and allow adding and customizing [[Minecraft:Mob AI|entity behaviors]],<ref>{{citation|url=https://learn.microsoft.com/en-us/minecraft/creator/documents/entitybehaviorintroduction?view=minecraft-bedrock-stable|title=Entity Behavior Introduction|website=Microsoft Learn|date=September 19, 2023}}</ref> [[Minecraft:loot table]]s,<ref>{{citation|url=https://learn.microsoft.com/en-us/minecraft/creator/documents/introductiontoloottables?view=minecraft-bedrock-stable|title=Introduction to Loot Tables|website=Microsoft Learn|date=March 6, 2025}}</ref> [[Minecraft:Mob spawning|spawn rules]],<ref>{{citation|url=https://learn.microsoft.com/en-us/minecraft/creator/reference/content/entityreference/examples/cliententitydocumentation/datadrivenspawning?view=minecraft-bedrock-stable|title=Data-Driven Spawn Rules|website=Microsoft Learn|date=November 8, 2023}}</ref> [[Minecraft:item]] behaviors,<ref>{{citation|url=https://learn.microsoft.com/en-us/minecraft/creator/documents/addcustomitems?view=minecraft-bedrock-stable|title=Custom Items|website=Microsoft Learn|date=September 18, 2024}}</ref> item [[Minecraft:recipe]]s,<ref>{{citation|url=https://learn.microsoft.com/en-us/minecraft/creator/documents/recipeintroduction?view=minecraft-bedrock-stable|title=Recipe Introduction|website=Microsoft Learn|date=April 19, 2024}}</ref> biome characteristics,<ref name="biome-component-list">{{citation|url=https://learn.microsoft.com/en-us/minecraft/creator/documents/biomes/biomeoverview?view=minecraft-bedrock-stable|title=Biome JSON and Overview|website=Microsoft Learn|date=April 10, 2025}}</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.
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 {{MC/Cd|.mcaddon}} file. An add-on file can be automatically imported by the game, which will organize all contents in the dedicated directories in {{MC/Cd|[[Minecraft:com.mojang]]}}.
All contents of an add-on can be packaged together in a zipped {{Cd|.mcaddon}} file. An add-on file can be automatically imported by the game, which will organize all contents in the dedicated directories in {{Cd|[[Minecraft:com.mojang]]}}.


==== Sub-packs ====
==== Sub-packs ====
Resource packs and behavior packs can contain other packs inside the root, known as sub-packs.<ref>{{Cite|url=https://learn.microsoft.com/en-us/minecraft/creator/documents/buildingsubpacks?view=minecraft-bedrock-stable|title=Building Sub-Packs|website=Microsoft Learn|date=August 28, 2025}}</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 {{MC/Cd|[[Minecraft:manifest.json]]}} 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.
Resource packs and behavior packs can contain other packs inside the root, known as sub-packs.<ref>{{Cite|url=https://learn.microsoft.com/en-us/minecraft/creator/documents/buildingsubpacks?view=minecraft-bedrock-stable|title=Building Sub-Packs|website=Microsoft Learn|date=August 28, 2025}}</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 {{Cd|[[Minecraft:manifest.json]]}} 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 ===
=== Molang ===
{{MC/Main|Molang}}
{{main|Molang}}
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 {{MC/In|BE}} 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>[https://docs.microsoft.com/en-us/minecraft/creator/reference/content/molangreference/examples/molangconcepts/molangintroduction "Molang Documentation - Introduction to Molang"]</ref>
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|BE}} 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>[https://docs.microsoft.com/en-us/minecraft/creator/reference/content/molangreference/examples/molangconcepts/molangintroduction "Molang Documentation - Introduction to Molang"]</ref>


=== Scripting ===
=== 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>{{citation |url=https://learn.microsoft.com/en-us/minecraft/creator/documents/scripting/introduction?view=minecraft-bedrock-stable |title=Introduction to Scripting in Minecraft |website=Microsoft Learn |date=July 17, 2025 |archive=1 }}</ref> It lets users control behaviors of entities, blocks, and items; characteristics of the world; or an entire game loop.<ref name="intro-scripting">{{citation |url=https://learn.microsoft.com/en-us/minecraft/creator/documents/scriptingintroduction?view=minecraft-bedrock-stable |title=Introduction to Scripting in Minecraft |website=Microsoft Learn |date=April 17, 2025 |archive=1 }}</ref> It is fundamentally different from the behavior pack system, the latter uses a component system with preset definitions provided by the game.
[[File:Breakpointhit.png|thumb|Scripting in {{w|Visual Studio Code}} 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>{{citation |url=https://learn.microsoft.com/en-us/minecraft/creator/documents/scripting/introduction?view=minecraft-bedrock-stable |title=Introduction to Scripting in Minecraft |website=Microsoft Learn |date=July 17, 2025 |archive=1 }}</ref> It lets users control behaviors of entities, blocks, and items; characteristics of the world; or an entire [[Minecraft:w:Video game programming#Game structure|game loop]].<ref name="intro-scripting">{{citation |url=https://learn.microsoft.com/en-us/minecraft/creator/documents/scriptingintroduction?view=minecraft-bedrock-stable |title=Introduction to Scripting in Minecraft |website=Microsoft Learn |date=April 17, 2025 |archive=1 }}</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 {{MC/W|JavaScript}} programming language and loaded by the game under the {{MC/Cd|scripts}} directory inside an add-on. Users may use {{MC/W|TypeScript}}, a dialect of JavaScript, which provides better error reporting and a static type system.<ref name="intro-scripting"/><ref>{{citation |url=https://www.typescriptlang.org/docs/handbook/typescript-in-5-minutes.html |title=TypeScript for JavaScript Programmers |website=TypeScript |date=June 2, 2025 }}</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>{{citation |url=https://wiki.bedrock.dev/scripting/api-modules |title=API Modules |website=Bedrock Wiki |date=June 8, 2025 }}</ref>
Script files are written in the {{w|JavaScript}} programming language and loaded by the game under the {{cd|scripts}} directory inside an add-on. Users may use {{w|TypeScript}}, a dialect of JavaScript, which provides better error reporting and a [[Minecraft:w:Type system#Static type checking|static type system]].<ref name="intro-scripting"/><ref>{{citation |url=https://www.typescriptlang.org/docs/handbook/typescript-in-5-minutes.html |title=TypeScript for JavaScript Programmers |website=TypeScript |date=June 2, 2025 }}</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>{{citation |url=https://wiki.bedrock.dev/scripting/api-modules |title=API Modules |website=Bedrock Wiki |date=June 8, 2025 }}</ref>
<!-- nitpick some notable ones here for introductory/simplicity, don't include everything -->
* {{MC/Cd|@minecraft/common}} &ndash; provides common resources, such as error classes or interfaces.
* {{MC/Cd|@minecraft/server}} &ndash; provides interactions between the script engine and the game world, such as blocks, entities, items, players, and others.
* {{MC/Cd|@minecraft/server-ui}} &ndash; provides players and server communication through customizable forms.
* {{MC/Cd|@minecraft/server-graphics}} &ndash; allows to dynamically customize graphical settings from [[Minecraft:Vibrant Visuals]] defined in resource packs, at this moment only atmospherics.
* {{MC/Cd|@minecraft/server-net}} &ndash; provides access to the Internet through web requests, such as GET, POST, and others.
* {{MC/Cd|@minecraft/server-gametest}} &ndash; provides the [[Minecraft:GameTest]] framework for testing behaviors and interactions within the game world. See {{slink|GameTest|Bedrock Edition}} for further information.
* And other modules, [https://wiki.bedrock.dev/scripting/api-modules further reading].


The Scripting API also provides a way to define and register custom commands.<ref>{{citation |url=https://learn.microsoft.com/en-us/minecraft/creator/documents/customcommands?view=minecraft-bedrock-stable |title=Scripting Custom Commands Overview |website=Microsoft Learn |date=March 27, 2025 }}</ref>
{| class="wikitable sortable" style="width:100%"
! style="width:30%" | Module
! Description
! style="width:10%" | Latest versions
! Notes
|-
| {{cd|@minecraft/common}}
| Provides common resources, such as error classes or interfaces.
| 1.3.0
| &ndash;
|-
| {{cd|@minecraft/diagnostics}}
| Provides diagnostics functionality for discovering and diagnosing issues with custom content. Currently provides APIs for [https://sentry.io/ Sentry] service.
| 1.0.0-beta
| &ndash;
|-
| {{cd|@minecraft/server}}
| 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.7.0<br>2.9.0-beta
| &ndash;
|-
| {{cd|@minecraft/server-ui}}
| Provides players and server communication through customizable forms.
| 2.0.0<br>2.1.0-beta
| &ndash;
|-
| {{cd|@minecraft/server-graphics}}
| Allows scripts to dynamically customize graphical settings from [[Minecraft:Vibrant Visuals]] defined in resource packs; currently only atmospherics.
| 1.0.0-beta
| Pre-release only.
|-
| {{cd|@minecraft/server-net}}
| Provides access to the Internet through [[Minecraft:w:HTTP#Request methods|web requests]], such as GET, POST, and others.
| 1.0.0-beta
| Pre-release only. Only usable on [[Minecraft:Bedrock Dedicated Server]].
|-
| {{cd|@minecraft/server-gametest}}
| Provides the [[Minecraft:GameTest]] framework for testing behaviors and interactions within the game world. See {{slink|GameTest|Bedrock Edition}} for further information.
| 1.0.0-beta
| Pre-release only. The oldest module for scripting, other names may include: {{cd|mojang-gametest}}.
|-
| {{cd|@minecraft/server-admin}}
| 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]].
|-
| {{cd|@minecraft/server-editor}}
| Provides scripting APIs for [[Minecraft:Bedrock Editor]].{{info needed}}
| 0.1.0-beta
| &ndash;
|-
! colspan=5 | External modules
|-
| {{cd|@minecraft/math}}
| Provides utilities and functions for common math operations.
| 2.4.0
| Notable APIs include: {{cd|Vector3Utils}} and {{cd|Vector3Builder}}.
|-
| {{cd|@minecraft/gameplay-utilities}}
| Provides utilities and functions for common gameplay operations.
| 1.3.0
| Notables APIs include: {{cd|nextEvent()}} and {{cd|EventPromise}}.
|}


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>{{citation |url=https://learn.microsoft.com/en-us/minecraft/creator/documents/scripting/v2-overview?view=minecraft-bedrock-stable |title=Scripting V2 Overview |website=Microsoft Learn| date=July 17, 2025 }}</ref><ref>{{citation |url=https://learn.microsoft.com/en-us/minecraft/creator/documents/customcomponents?view=minecraft-bedrock-stable |title=Introducing Custom Components |website=Microsoft Learn |date=March 27, 2025 }}</ref>
Typing definitions (for use in TypeScript) can be installed via {{w|npm}} package manager from the [https://www.npmjs.com/~mc-npm official packages owned by ''mc-npm'']. There are other built-in modules, [https://wiki.bedrock.dev/scripting/api-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 [https://github.com/Mojang/minecraft-scripting-libraries ''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 [https://esbuild.github.io/getting-started/#your-first-bundle 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>{{citation |url=https://learn.microsoft.com/en-us/minecraft/creator/documents/scripting/v2-overview?view=minecraft-bedrock-stable |title=Scripting V2 Overview |website=Microsoft Learn| date=July 17, 2025 }}</ref><ref>{{citation |url=https://learn.microsoft.com/en-us/minecraft/creator/documents/customcomponents?view=minecraft-bedrock-stable |title=Introducing Custom Components |website=Microsoft Learn |date=March 27, 2025 }}</ref><ref>{{citation |url=https://learn.microsoft.com/en-us/minecraft/creator/documents/customcommands?view=minecraft-bedrock-stable |title=Scripting Custom Commands Overview |website=Microsoft Learn |date=March 27, 2025 }}</ref> Most changes from the Scripting API version 2 are available from {{cd|@minecraft/server}} version 2.0.0.


=== Marketplace ===
=== 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.
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 {{Slink|2=Official add-ons}} for a full list of add-ons officially promoted by Mojang Studios.<!-- adapted from the removed "History" section of [[Special:PermaLink/1777356]] -->
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 [[Minecraft:Movie:McDonald's|McDonald's X ''A Minecraft Movie'']] promotion. See {{Slink|2=Official add-ons}} for a full list of add-ons officially promoted by [[Minecraft:Mojang Studios]].<!-- adapted from the removed "History" section of [[Special:PermaLink/1777356]] -->


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]].
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]].


== Loading tips{{MC/Anchor|Warnings}} ==
=== ''Minecraft Education'' ===
[[File:Bedrock-modified-world-warning.png|thumb|An example of a loading tip since 1.20.70.21.]]
[[File:MCEDU Add-Ons.jpeg|thumb|width=245x245|Logo for add-ons on ''Minecraft Education'']]
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:
In 2026, add-ons were introduced into ''[[Minecraft:Minecraft Education]]''.<ref name=":edu">{{Citation|url=https://education.minecraft.net/en-us/blog/minecraft-add-ons|title=Bring New Ideas to Life with Add-Ons in Minecraft Education|website=Minecraft Education|date=March 17, 2026}}</ref><ref name=":video">{{YouTube link|MvBq9yiC5ho|Add-Ons in Minecraft Education Create Customized Learning|Minecraft Education|March 6, 2026}}</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.
{{#section:Loading tip|add-on-tips}}
{{-}}


== Loading tips{{anchor|Warnings}} ==
[[File:Bedrock-modified-world-warning.png|thumb|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 {{Slink|Loading tips|Add-on tips}}.
{{-}}
== Official add-ons ==
== Official add-ons ==
{{MC/See also|Demo content}}
{{See also|Demo content}}
 
=== ''Bedrock Edition'' ===
{| class="wikitable sortable" width="100%"
{| class="wikitable sortable" width="100%"
! width="135px" |Image
! width="135px" |Image
Line 63: Line 128:
|
|
![[Minecraft:Minecon 2018 New Entity Sample]]
![[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.
|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
|November 19, 2018
| {{MC/Tc|partial|External download}}
| {{tc|partial|External download}}
|-
|-
|
|
![[Minecraft:Minecraft Live 2022 Sample Pack]]
![[Minecraft:Minecraft Live 2022 Sample Pack]]
|A pack to demonstrate the Minecraft Entity Wizard in Blockbench, showcased in Minecraft Live 2022.
|A pack to demonstrate the Minecraft Entity Wizard in [[Minecraft:Blockbench]], showcased in [[Minecraft:Minecraft Live 2022]].
|October 17, 2022
|October 17, 2022
| {{MC/Tc|partial|External download}}
| {{tc|partial|External download}}
|-
|-
|[[File:POIP Thumbnail 0.jpg|width=150x150]]
|[[File:POIP Thumbnail 0.jpg|width=150x150]]
Line 77: Line 142:
|An add-on themed around the [[Minecraft:Poisonous Potato|poisonous potato]] April Fools' Day event in 2024.
|An add-on themed around the [[Minecraft:Poisonous Potato|poisonous potato]] April Fools' Day event in 2024.
|April 1, 2024
|April 1, 2024
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:15 Year Party Supplies Key Art.jpg|width=150x150]]
|[[File:15 Year Party Supplies Key Art.jpg|width=150x150]]
![[Minecraft:15 Year Party Supplies]]
![[Minecraft:15 Year Party Supplies]]
|An add-on themed around the 15th anniversary of ''Minecraft'' with features from [[Minecraft:15 Year Journey]].
|An add-on themed around the [[Minecraft:15th anniversary]] of ''Minecraft'' with features from [[Minecraft:15 Year Journey]].
|May 21, 2024
|May 21, 2024
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:Tet Thumbnail 0.jpg|width=150x150]]
|[[File:Tet Thumbnail 0.jpg|width=150x150]]
![[Minecraft:Tetris Add-On|Tetris]]
![[Minecraft:Tetris Add-On|Tetris]]
|A collaborative add-on with features from ''Tetris''.
|A collaborative add-on with features from ''[[Minecraft:Tetris]]''.
|June 6, 2024
|June 6, 2024
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:LUSH Article DLC Keyart.jpg|width=150x150]]
|[[File:LUSH Article DLC Keyart.jpg|width=150x150]]
![[Minecraft:Lush Bath Bomb Add-On|Lush Bath Bomb]]
![[Minecraft:Lush Bath Bomb Add-On|Lush Bath Bomb]]
|A collaborative add-on to promote bath bombs from Lush.
|A collaborative add-on to promote bath bombs from [[Minecraft:W:Lush (company)|Lush]].
|August 1, 2024
|August 1, 2024
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:Spongebob Squarepants Add-On Key Art.jpg|width=150x150]]
|[[File:Spongebob Squarepants Add-On Key Art.jpg|width=150x150]]
![[Minecraft:SpongeBob SquarePants Add-On|SpongeBob SquarePants]]
![[Minecraft:SpongeBob SquarePants Add-On|SpongeBob SquarePants]]
|A collaborative add-on with features from SpongeBob SquarePants.
|A collaborative add-on with features from [[Minecraft:SpongeBob SquarePants]].
|August 20, 2024
|August 20, 2024
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:Ghost Pets Add-On Key art.webp|width=150x150]]
|[[File:Ghost Pets Add-On Key art.webp|width=150x150]]
![[Minecraft:Ghost Pets Add-On|Ghost Pets]]
![[Minecraft:Ghost Pets Add-On|Ghost Pets]]
|A themed add-on with ghost pet mobs for the Expect the unexpected event around The Garden Awakens.
|A themed add-on with ghost [[Minecraft:pet]] mobs for the [[Minecraft:Expect the unexpected]] event around [[Minecraft:The Garden Awakens]].
|November 4, 2024
|November 4, 2024
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:Majestic Camping Add-On Key Art.jpg|width=150x150]]
|[[File:Majestic Camping Add-On Key Art.jpg|width=150x150]]
Line 113: Line 178:
|A camping-themed add-on for the Expect the unexpected event.
|A camping-themed add-on for the Expect the unexpected event.
|November 4, 2024
|November 4, 2024
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:Phantom Frames Add-On Key art.webp|width=150x150]]
|[[File:Phantom Frames Add-On Key art.webp|width=150x150]]
Line 119: Line 184:
|A themed add-on for the Expect the unexpected event.
|A themed add-on for the Expect the unexpected event.
|December 4, 2024
|December 4, 2024
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:Scary Furniture Add-On Key Art.jpg|width=150x150]]
|[[File:Scary Furniture Add-On Key Art.jpg|width=150x150]]
Line 125: Line 190:
|An add-on for the Expect the unexpected event with haunted ''Minecraft'' furniture blocks.
|An add-on for the Expect the unexpected event with haunted ''Minecraft'' furniture blocks.
|December 10, 2024
|December 10, 2024
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:Mob Lights Add-On key art.webp|width=150x150]]
|[[File:Mob Lights Add-On key art.webp|width=150x150]]
Line 131: Line 196:
|Another themed add-on for the Expect the unexpected event.
|Another themed add-on for the Expect the unexpected event.
|December 10, 2024
|December 10, 2024
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:Monster Food Add-On key art.jpeg|width=150x150]]
|[[File:Monster Food Add-On key art.jpeg|width=150x150]]
Line 137: Line 202:
|An add-on featured for Expect the unexpected with haunted food items and mobs.
|An add-on featured for Expect the unexpected with haunted food items and mobs.
|December 10, 2024
|December 10, 2024
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:Lava Chicken Add-On key art.jpg|width=150x150]]
|[[File:Lava Chicken Add-On key art.jpg|width=150x150]]
![[Minecraft:Lava Chicken Add-On|Lava Chicken]]
![[Minecraft:Lava Chicken Add-On|Lava Chicken]]
|A promotional add-on for ''A Minecraft Movie'' which adds Steve's Lava Chicken shown in the movie.
|A promotional add-on for [[Minecraft:A Minecraft Movie|''A Minecraft Movie'']] which adds Steve's Lava Chicken shown in the movie.
|December 20, 2024
|December 20, 2024
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:Sonic Add-On Key Art.jpg|width=150x150]]
|[[File:Sonic Add-On Key Art.jpg|width=150x150]]
![[Minecraft:Sonic Add-On|Sonic]]
![[Minecraft:Sonic Add-On|Sonic]]
|A collaborative add-on with features from ''Sonic the Hedgehog''.
|A collaborative add-on with features from ''[[Minecraft:Sonic the Hedgehog]]''.
|January 7, 2025
|January 7, 2025
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:A Minecraft Movie Add-on key art.jpg|width=150x150]]
|[[File:AMCM Add-on key art.jpg|width=150x150]]
![[Minecraft:A Minecraft Movie: Add-on|A Minecraft Movie]]
![[Minecraft:A Minecraft Movie: Add-on|A Minecraft Movie]]
|An add-on that adds many features shown in ''A Minecraft Movie''.
|An add-on that adds many features shown in ''A Minecraft Movie''.
|February 26, 2025
|February 26, 2025
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:Jet Pack key art.jpeg|width=150x150]]
|[[File:Jet Pack key art.jpeg|width=150x150]]
Line 161: Line 226:
|A limited promotional add-on for ''A Minecraft Movie'' which could be obtained by purchasing tickets on its opening weekend.
|A limited promotional add-on for ''A Minecraft Movie'' which could be obtained by purchasing tickets on its opening weekend.
|February 27, 2025
|February 27, 2025
| {{MC/Tc|No}}
| {{tc|No}}
|-
|-
|[[File:McDonald's Add-On key art.jpg|width=150x150]]
|[[File:McDonald's Add-On key art.jpg|width=150x150]]
![[Minecraft:McDonald's Add-On|McDonald's]]
![[Minecraft:McDonald's Add-On|McDonald's]]
|An add-on themed around the collaboration of ''A Minecraft Movie'' with McDonald's.
|An add-on themed around the collaboration of ''A Minecraft Movie'' with [[Minecraft:Movie:McDonald's|McDonald's]].
|March 24, 2025
|March 24, 2025
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:Timecapsule Thumbnail 0.jpeg|width=150x150]]
|[[File:Timecapsule Thumbnail 0.jpeg|width=150x150]]
![[Minecraft:Time Capsule Add-On|Time Capsule]]
![[Minecraft:Time Capsule Add-On|Time Capsule]]
|A promotional add-on made for the 15 Days of Minecraft event.
|A promotional add-on made for the [[Minecraft:15 Days of Minecraft]] event.
|May 16, 2025
|May 16, 2025
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:MLBFanCave Thumbnail 0.jpeg|width=150x150]]
|[[File:MLBFanCave Thumbnail 0.jpeg|width=150x150]]
!MLB Fan Cave
![[Minecraft:MLB Fan Cave Add-On|MLB Fan Cave]]
|
|
|June 2, 2025
|June 2, 2025
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:Adidas Thumbnail 0.jpeg|width=150x150]]
|[[File:Adidas Thumbnail 0.jpeg|width=150x150]]
![[Minecraft:Adidas Adventurers Add-On|Adidas Adventurers]]
![[Minecraft:Adidas Adventurers Add-On|Adidas Adventurers]]
|A collaborative add-on with Adidas.
|A collaborative add-on with [[Minecraft:Adidas]].
|June 3, 2025
|June 3, 2025
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:HTTYD thumbnail 0.jpeg|width=150x150]]
|[[File:HTTYD thumbnail 0.jpeg|width=150x150]]
![[Minecraft:How to Train Your Dragon Add-On|How to Train Your Dragon]]
![[Minecraft:How to Train Your Dragon Add-On|How to Train Your Dragon]]
|A collaborative add-on with Universal Studios about the movie ''How to Train Your Dragon''.
|A collaborative add-on with [[Minecraft:Universal Studios]] about the movie ''How to Train Your Dragon''.
|June 10, 2025
|June 10, 2025
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:Minecraft Vibrant Memories.jpeg|width=150x150]]
|[[File:Minecraft Vibrant Memories.jpeg|width=150x150]]
Line 197: Line 262:
|An add-on made to promote [[Minecraft:Vibrant Visuals]] after its release.
|An add-on made to promote [[Minecraft:Vibrant Visuals]] after its release.
|June 18, 2025
|June 18, 2025
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:Claims Adjuster Add-On Cover.jpg|width=150x150]]
|[[File:Claims Adjuster Add-On Cover.jpg|width=150x150]]
![[Minecraft:Claims Adjuster Add-On|Claims Adjuster]]
![[Minecraft:Claims Adjuster Add-On|Claims Adjuster]]
|An official add-on that has been promoted with the Ice Cube Claims Adjuster series.
|An official add-on that has been promoted with the [[Minecraft:Ice Cube Claims Adjuster]] series.
|August 13, 2025
|August 13, 2025
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:Friendly Fishing Add-On Key Art.jpeg|width=150x150]]
|[[File:Friendly Fishing Add-On Key Art.jpeg|width=150x150]]
Line 209: Line 274:
|An official collaborative add-on between Marketplace Partners and Conservation International themed around sea life.
|An official collaborative add-on between Marketplace Partners and Conservation International themed around sea life.
|September 26, 2025
|September 26, 2025
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|
|
!Jurassic World
![[Minecraft:Jurassic World Add-On|Jurassic World]]
|
|
|
|
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|
|
!TRON
![[Minecraft:TRON Add-On|TRON]]
|
|
|
|
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|-
|[[File:Minecraft Mounts of Mayhem Dungeon Descent .net.jpeg|width=150x150]]
|[[File:Minecraft Mounts of Mayhem Dungeon Descent .net.jpeg|width=150x150]]
![[Minecraft:Mounts of Mayhem: Dungeon Descent|Dungeon Descent]]
![[Minecraft:Mounts of Mayhem: Dungeon Descent|Dungeon Descent]]
|An add-on released to promote new features from Mounts of Mayhem.
|An add-on released to promote new features from [[Minecraft:Mounts of Mayhem]].
|January 12, 2026
|January 12, 2026
| {{MC/Tc|Yes}}
| {{tc|Yes}}
|-
|[[File:TinyTakeover MiniMania.jpg|width=150x150]]
![[Minecraft:Tiny Takeover: Mini Mania]]
|A minigame-centric add-on released to promote [[Minecraft:Tiny Takeover]].
|April 21, 2026
| {{tc|Yes}}
|}
 
=== ''Minecraft Education'' ===
{| class="wikitable"
|+
!Image
!Name
!Description
!Release date
!Available
|-
|[[File:MCEDU Dice.jpeg|width=150x150]]
|[[Minecraft:Dice]]
|An add-on which introduces dice blocks.
|April 9, 2026
|{{tc|partial|External download}}
|-
|[[File:MCEDU Math Chests Divison.jpeg|width=150x150]]
|[[Minecraft:Math Chests Division]]
|An add-on which adds chest blocks made for division.
|April 9, 2026
|{{tc|partial|External download}}
|-
|[[File:MCEDU Math Chests Multiplication.jpeg|width=150x150]]
|[[Minecraft:Math Chests Multiplication]]
|An add-on which adds chest blocks made for multiplication.
|April 9, 2026
|{{tc|partial|External download}}
|-
|[[File:MCEDU Roman Balneae.jpeg|width=150x150]]
|[[Minecraft:Roman Balneae Structure Pack]]
|An add-on which adds a Roman structure.{{Info needed}}
|April 9, 2026
|{{tc|partial|External download}}
|-
|[[File:MCEDU Ancient Egypt NPC Pack 1.png|width=150x150]]
|[[Minecraft:Ancient Egypt NPC Pack 1]]
|An add-on which adds NPC skins.
|April 9, 2026
|{{tc|partial|External download}}
|-
|[[File:MCEDU Ancient Greece NPC Pack 1.jpeg|width=150x150]]
|[[Minecraft:Ancient Greece NPC Pack 1]]
|An add-on which adds NPC skins.{{Info needed}}
|April 9, 2026
|{{tc|partial|External download}}
|-
|[[File:MCEDU Number Shaped Blocks.jpeg|width=150x150]]
|[[Minecraft:Number Shaped Blocks]]
|An add-on which adds blocks molded to various numbers.
|April 9, 2026
|{{tc|partial|External download}}
|-
|[[File:MCEDU Number Blocks.jpeg|width=150x150]]
|[[Minecraft:Number Blocks]]
|An add-on which introduces numeric blocks.
|April 9, 2026
|{{tc|partial|External download}}
|-
|[[File:MCEDU Ancient Rome NPC Pack 1.png|width=150x150]]
|[[Minecraft:Ancient Rome NPC Pack 1]]
|An add-on which adds NPC skins.
|April 9, 2026
|{{tc|partial|External download}}
|-
|[[File:MCEDU Non-transitive Dice.jpeg|width=150x150]]
|[[Minecraft:Non-transitive Dice]]
|An add-on which adds non-transitive dice.
|April 9, 2026
|{{tc|partial|External download}}
|}
|}


== History ==
== History ==
{{MC/Expand section|major technical API changes, packs history, the Scripting API version 2 changes}}
{{For|behavior pack JSON-related APIs additions and changes|Behavior pack#History}}
=== General ===
This section includes major additions and milestones of add-ons. It also includes all [[Minecraft:Marketplace]] related history.
{{HistoryTable
{{HistoryTable
|{{HistoryLine||August 12, 2016|link=https://twitter.com/SeargeDP/status/764033531223896064|The concept of add-ons was hinted at in a post by Searge on August 12, 2016, stating "There will be news about the API at Minecon."<ref>{{tweet|searge|764033531223896064|There will be news about the API at Minecon. I'll talk about the things I'm working on and what our plans are. But no more details for now.|August 12, 2016}}</ref> The next day it was confirmed by Grum to be a modding API for {{MC/BE}} (formerly called {{MC/PE}}, or ''MCPE''),<ref>{{tweet|_grum|764417838278926336|the MCPE on, would be nice to say that too.|August 13, 2016}}</ref> and at MINECON 2016, the plan and roadmap for the development of add-ons were outlined.}}
|{{HistoryLine||August 12, 2016|link=https://twitter.com/SeargeDP/status/764033531223896064|The concept of add-ons was hinted at in a post by [[Minecraft:Searge]] on August 12, 2016, stating "There will be news about the API at Minecon."<ref>{{tweet|searge|764033531223896064|There will be news about the API at Minecon. I'll talk about the things I'm working on and what our plans are. But no more details for now.|August 12, 2016}}</ref> The next day it was confirmed by [[Minecraft:Grum]] to be a modding API for {{BE}} (formerly called {{PE}}, or ''MCPE''),<ref>{{tweet|_grum|764417838278926336|the MCPE on, would be nice to say that too.|August 13, 2016}}</ref> and at [[Minecraft:MINECON 2016]], the plan and roadmap for the development of add-ons were outlined.}}
|{{HistoryLine|pocket alpha}}
|{{HistoryLine||v0.16.0|Added user-created [[Minecraft:resource pack]]s that can be installed by world.|Added user-created [[Minecraft:behavior pack]]s. These allow the player to change files coded in JSON to change how the game works.}}
|{{HistoryLine|pocket}}
|{{HistoryLine||1.1.0|dev=alpha 1.1.0.8|Added the [[Minecraft:Minecraft Marketplace]], in which community resource packs, skin packs, and behavior packs (packaged inside worlds) are distributed.}}
|{{HistoryLine|bedrock}}
|{{HistoryLine||February 20, 2024|link=https://www.minecraft.net/en-us/article/introducing-add-ons|Previously, standalone add-ons from the [[Minecraft: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.<ref>{{mcnet|introducing-add-ons|Introducing add-ons|February 20, 2024|Linn Viberg}}</ref>}}
|{{HistoryLine||February 20, 2024|link=https://www.minecraft.net/en-us/article/introducing-add-ons|Previously, standalone add-ons from the [[Minecraft: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.<ref>{{mcnet|introducing-add-ons|Introducing add-ons|February 20, 2024|Linn Viberg}}</ref>}}
|{{MC/HistoryLine|bedrock}}
|{{HistoryLine||1.20.70|dev=Preview 1.20.70.21|Added extra loading tips that appear when a world has add-ons applied.}}
|{{MC/HistoryLine||1.20.70|dev=Preview 1.20.70.21|Added extra loading tips that appear when a world has add-ons applied.}}
|{{HistoryLine||1.21.0|dev=Preview 1.21.0.23|Added eight new extra loading tips that replaced the previous ones.}}
|{{MC/HistoryLine||1.21.0|dev=Preview 1.21.0.23|Added eight new extra loading tips that replaced the previous ones.}}
|{{HistoryLine||March 17, 2026|link=https://education.minecraft.net/en-us/blog/minecraft-add-ons|[[File:MCEDU Add-Ons.jpeg|60px]] Add-ons were introduced into ''[[Minecraft:Minecraft Education]]''.<ref name=":edu">{{Citation|url=https://education.minecraft.net/en-us/blog/minecraft-add-ons|title=Bring New Ideas to Life with Add-Ons in Minecraft Education|website=Minecraft Education|date=March 17, 2026}}</ref><ref name=":video">{{YouTube link|MvBq9yiC5ho|Add-Ons in Minecraft Education Create Customized Learning|Minecraft Education|March 6, 2026}}</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.}}
|{{MC/HistoryLine||unknown|The Scripting API version 2 was added, introducing custom components API and other major changes that aren't compatible with previous version.}}
}}
 
=== Scripting ===
{{HistoryTable
|{{HistoryLine|bedrock}}
|{{HistoryLine||1.9.0|dev=beta 1.9.0.3|Added Minecraft Script Engine, which uses {{w|JavaScript}}.<ref name="minecraft-script-engine">https://www.minecraft.net/en-us/article/scripting-api-now-public-beta</ref>|Scripts can be written and bundled with behavior packs to listen and respond to game events, get and modify data in components that entities have, and affect different parts of the game.|Scripts can be used to create experimental custom UI with {{w|HTML}}.<ref>https://bedrock.dev/docs/1.9.0.0/1.9.0.3/UI</ref>}}
|{{HistoryLine||1.10.0|dev=beta 1.10.0.3|Packs loading custom UI now required {{cd|experimental_custom_ui}} feature flag in [[Minecraft:manifest.json]].|Fixed several scripting issues affecting custom UI loading, spawn events, filters, and entity validation.}}
|{{HistoryLine||1.12.0|dev=beta 1.12.0.2|Added interaction events to the Scripting API for inventory, item, and block.|Added block query APIs ({{cd|getBlock}} function and overrides) for Scripting.|Added {{cd|executeCommand}} API for Scripting.|Added event data API for Scripting which allows creators to create event data, register and pass it to the event function.|Added custom blocks through Scripting and additional JSON scripting (and only placed by commands).|Added a screen to view content log errors.|Enabled content logging on [[Minecraft:Bedrock Dedicated Server]]s.}}
|{{HistoryLine||1.18.10|dev=beta 1.18.10.28|Removed HTML-based experimental custom UI ({{cd|experimental_custom_ui}} features) and its documentation.<ref>The last instance of custom UI documentation is this version: https://bedrock.dev/docs/1.18.0.0/1.18.10.28/UI</ref>}}
|{{HistoryLine||1.20.80|dev=Preview 1.20.80.20|Added blocks {{cd|minecraft:custom_components}} (version 1) under the Beta APIs experiment.}}
|{{HistoryLine|||dev=Preview 1.20.80.23|Added items {{cd|minecraft:custom_components}} (version 1) under the Beta APIs experiment.}}
|{{HistoryLine||1.21.20|dev=Preview 1.21.10.22|Removed items {{cd|minecraft:custom_components}} (version 1) from the Beta APIs experiment. It's enabled by default for JSON formats 1.21.10 and higher.}}
|{{HistoryLine|||dev=Preview 1.21.10.23|Added {{cd|@minecraft/server-ui}} version 1.2.0.|Added {{cd|@minecraft/server-ui}} version 1.3.0-beta.|Removed blocks {{cd|minecraft:custom_components}} (version 1) from the Beta APIs experiment. It's enabled by default.{{info needed|for what versions of JSON format?}}}}
|{{HistoryLine||1.21.70|dev=Preview 1.21.70.20|Added {{cd|@minecraft/server}} version 1.18.0.|Added {{cd|@minecraft/server}} version 2.0.0-beta.}}
|{{HistoryLine||1.21.80|dev=Preview 1.21.80.22|Added Custom Commands under the Beta APIs experiment.}}
|{{HistoryLine|||dev=Preview 1.21.80.25|Added Custom Components V2 experiment.}}
|{{HistoryLine||1.21.90|dev=Preview 1.21.90.20|Added {{cd|@minecraft/server-ui}} version 2.0.0.|Added {{cd|@minecraft/server-ui}} version 2.1.0-beta.|Added {{cd|@minecraft/server}} version 2.1.0-beta.|Removed Custom Components v2 experiment. Custom Components v2 is enabled when using {{cd|@minecraft/server}} version 2.0.0 and above.}}
|{{HistoryLine|||dev=Preview 1.21.90.21|Added {{cd|@minecraft/server}} version 2.0.0. This marked the release of Scripting API version 2.}}
|{{HistoryLine||26.10|dev=Preview 26.10.21|Introduced new UI capabilities called Data-Driven UI (DDUI) under Beta APIs experiment.<ref>{{tweet|CornerHardMC|2019592308178768238|I'm so impressed by what people have been making in the latest Minecraft Preview with the new Data-Driven UI!}}</ref> These APIs introduce a new way to create modal forms with new capabilities and an all new look. APIs are available under {{cd|@minecraft/server-ui}} module.|{{cmd|reload}} command now closes all the Data Driven UI screens as part of the execution.}}
}}
}}


== Videos ==
== Videos ==
Tutorials from the official [https://www.youtube.com/@MinecraftCreatorChannel Minecraft Creator Channel].
Tutorials from the official [https://www.youtube.com/@MinecraftCreatorChannel Minecraft Creator Channel].
{{MC/Yt|OdZlKpLOkj4}}
{{yt|OdZlKpLOkj4}}
{{MC/Yt|TUFeM5P4IwM}}
{{yt|TUFeM5P4IwM}}
{{MC/Yt|kkm8xxqGVvs}}
{{yt|kkm8xxqGVvs}}
{{MC/Yt|bCU8UxIZ-U4}}
{{yt|bCU8UxIZ-U4}}
{{MC/Yt|kzWSItyz5Pk}}
{{yt|kzWSItyz5Pk}}
{{MC/Yt|zMF3JPahrPQ}}
{{yt|zMF3JPahrPQ}}
 
=== 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'''
{{yt|US67Tlb8gyE}}
{{yt|e2MNYIa411k}}
 
'''Early add-ons tutorial and playthrough'''
{{yt|1jgEfxw3SOE}}
{{yt|3yI3Qwbqk_o}}
{{yt|_ooFM5c}}
 
'''Early Scripting API and experimental custom UI'''<ref name="minecraft-script-engine"/>
{{yt|PUMeS8C0IRk}}


== Quotes ==
== Quotes ==
Line 256: Line 437:
== Gallery ==
== Gallery ==
<gallery>
<gallery>
Welcome Add-Ons.jpg|Promotional artwork released alongside the Change your game, your way! cinematic trailer
Welcome Add-Ons.jpg|Promotional artwork released alongside the [[Minecraft:Change your game, your way!]] cinematic trailer
Patrick-rodes-cake-golem.jpg|Render of a "Cake Golem" add-on<ref>{{Citation|url=https://www.artstation.com/artwork/n0od66|title=Cake Golem Blockbench Tutorial|author=Patrick Rodes|website=ArtStation|date=July 15, 2024}}</ref>
Patrick-rodes-cake-golem.jpg|Render of a "Cake Golem" add-on<ref>{{Citation|url=https://www.artstation.com/artwork/n0od66|title=Cake Golem Blockbench Tutorial|author=Patrick Rodes|website=ArtStation|date=July 15, 2024}}</ref>
Patrick-rodes-render-motorcycle-2.jpg|Artwork of a motorcycle add-on<ref>{{Citation|url=https://www.artstation.com/artwork/w0DOmw|title=Animation Presets Blockbench Tutorial|author=Patrick Rodes|website=ArtStation|date=July 15, 2024}}</ref>
Patrick-rodes-render-motorcycle-2.jpg|Artwork of a motorcycle add-on<ref>{{Citation|url=https://www.artstation.com/artwork/w0DOmw|title=Animation Presets Blockbench Tutorial|author=Patrick Rodes|website=ArtStation|date=July 15, 2024}}</ref>
Line 266: Line 447:
*[[Minecraft:Mod]]
*[[Minecraft:Mod]]
*[[Minecraft:Commands]]
*[[Minecraft:Commands]]
*Data pack
*[[Minecraft:Data pack]]
*Resource pack
*[[Minecraft:Resource pack]]
*[[Minecraft:Skin pack]]
*[[Minecraft:Skin pack]]
*World template
*[[Minecraft:World template]]
*[[Minecraft:Mash-up pack]]
*[[Minecraft:Mash-up pack]]


== References ==
== References ==
{{MC/Reflist}}
{{Reflist}}


== External links ==
== External links ==
Line 323: Line 504:


== Navigation ==
== Navigation ==
{{MC/Navbox add-ons}}
{{Navbox add-ons}}
{{MC/Navbox gameplay}}
{{Navbox gameplay}}
{{MC/Navbox Bedrock Edition}}
{{Navbox Bedrock Edition}}
{{MC/Navbox mods}}
{{Navbox mods}}
{{Mojang featured|https://www.minecraft.net/en-us/article/minecraft-bedrock-update}}{{Mojang featured|https://www.minecraft.net/en-us/article/add-ons-whats-name}}{{Mojang featured|https://www.minecraft.net/en-us/article/pandas-cats-and-new-add-features-beta}}{{Mojang featured|https://www.minecraft.net/en-us/article/scripting-api-now-public-beta}}
{{Navbox Marketplace}}
 
[[Category:Add-ons| ]]
[[Category:Add-ons| ]]
[[Category:Game customization]]
[[Category:Game customization]]
[[Category:Experimental]]
[[Category:Experimental]]


{{Former official page now maintained by community}}
[[Minecraft:de:Add-on]]
 
[[Minecraft:es:Add-on]]
de:Add-on
[[Minecraft:fr:Extension]]
es:Add-on
[[Minecraft:ja:Add-on]]
fr:Extension
[[Minecraft:ko:애드온]]
ja:Add-on
[[Minecraft:lzh:附囊]]
ko:애드온
[[Minecraft:pt:Complemento]]
lzh:附囊
[[Minecraft:ru:Дополнения]]
pt:Complemento
[[Minecraft:th:แอดออน]]
ru:Дополнения
[[Minecraft:uk:Доповнення]]
th:แอดออน
[[Minecraft:zh:附加包]]
uk:Доповнення
zh:附加包

Latest revision as of 11:00, 28 May 2026

Template:For Template:Exclusive

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.7.0
2.9.0-beta 		–
Template:Cd Provides players and server communication through customizable forms. 2.0.0
2.1.0-beta 		–
Template:Cd Allows scripts to dynamically customize graphical settings from Minecraft:Vibrant Visuals defined in resource packs; currently only atmospherics. 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.

Official add-ons

Template:See also

Bedrock Edition

Image Name Description Release date Purchasable
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
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
width=150x150 Poisonous Potato An add-on themed around the poisonous potato April Fools' Day event in 2024. April 1, 2024 Template:Tc
width=150x150 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
width=150x150 Tetris A collaborative add-on with features from Minecraft:Tetris. June 6, 2024 Template:Tc
width=150x150 Lush Bath Bomb A collaborative add-on to promote bath bombs from Lush. August 1, 2024 Template:Tc
width=150x150 SpongeBob SquarePants A collaborative add-on with features from Minecraft:SpongeBob SquarePants. August 20, 2024 Template:Tc
width=150x150 Ghost Pets 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
width=150x150 Majestic Camping A camping-themed add-on for the Expect the unexpected event. November 4, 2024 Template:Tc
width=150x150 Minecraft:Phantom Frames A themed add-on for the Expect the unexpected event. December 4, 2024 Template:Tc
width=150x150 Scary Furniture An add-on for the Expect the unexpected event with haunted Minecraft furniture blocks. December 10, 2024 Template:Tc
width=150x150 Mob Lights Another themed add-on for the Expect the unexpected event. December 10, 2024 Template:Tc
width=150x150 Monster Food An add-on featured for Expect the unexpected with haunted food items and mobs. December 10, 2024 Template:Tc
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 Template:Tc
width=150x150 Sonic A collaborative add-on with features from Minecraft:Sonic the Hedgehog. January 7, 2025 Template:Tc
width=150x150 A Minecraft Movie An add-on that adds many features shown in A Minecraft Movie. February 26, 2025 Template:Tc
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 Template:Tc
width=150x150 McDonald's An add-on themed around the collaboration of A Minecraft Movie with McDonald's. March 24, 2025 Template:Tc
width=150x150 Time Capsule A promotional add-on made for the Minecraft:15 Days of Minecraft event. May 16, 2025 Template:Tc
width=150x150 MLB Fan Cave June 2, 2025 Template:Tc
width=150x150 Adidas Adventurers A collaborative add-on with Minecraft:Adidas. June 3, 2025 Template:Tc
width=150x150 How to Train Your Dragon A collaborative add-on with Minecraft:Universal Studios about the movie How to Train Your Dragon. June 10, 2025 Template:Tc
width=150x150 Vibrant Memories An add-on made to promote Minecraft:Vibrant Visuals after its release. June 18, 2025 Template:Tc
width=150x150 Claims Adjuster An official add-on that has been promoted with the Minecraft:Ice Cube Claims Adjuster series. August 13, 2025 Template:Tc
width=150x150 Friendly Fishing An official collaborative add-on between Marketplace Partners and Conservation International themed around sea life. September 26, 2025 Template:Tc
Jurassic World Template:Tc
TRON Template:Tc
width=150x150 Dungeon Descent An add-on released to promote new features from Minecraft:Mounts of Mayhem. January 12, 2026 Template:Tc
width=150x150 Minecraft:Tiny Takeover: Mini Mania A minigame-centric add-on released to promote Minecraft:Tiny Takeover. April 21, 2026 Template:Tc

Minecraft Education

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

History

Template:For

General

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

Scripting

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

See also

References

Template:Reflist

External links

Official documentation

Official tutorials

Tools and libraries

Unofficial resources

Templates

Resource and Behavior Example Packs

Script API Example Packs

Navigation

Template:Navbox add-ons Template:Navbox gameplay Template:Navbox Bedrock Edition Template:Navbox mods Template:Navbox Marketplace

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

Retrieved from "https://wiki.sasgaming.net/index.php?title=Minecraft:Add-on&oldid=134388"