Minecraft:Behavior pack

The behavior pack system is a data-driven framework used to define behaviors, characteristics, and logic of various things in a Minecraft world.

Overview

Behavior pack serves as the foundational layer for many aspects of the game, dictating 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> Minecraft:world generation, and much more. These 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 behavior pack. Behavior packs are often used in conjunction with resource packs as part of an Minecraft:add-on, which enable them to use custom resources, such as models, animations, textures, sounds, and more.

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

Usage

File:Ore UI - Create New World Screen Menu "Behavior Packs" Tab Settings (Bedrock).png

The behavior packs tab in the Create New World screen.

Similar to resource packs, behavior packs can be created and imported in Template:Editions. Users can download external behavior packs with the

1. REDIRECT Template:Code

Template:Redr file extension, if the game's platform allows file import feature. When these files are opened, they are automatically imported into the behavior_packs folder in Minecraft:com.mojang without accessing the file system. Behavior packs can also be placed manually in the development_behavior_packs folder. Each behavior pack must either be a sub-folder or a .zip file.

One or more behavior packs can be applied to a world from the Create New World and Edit World screens. These behavior packs will be imported into the world files, and are kept when exporting the world. Players joining a Minecraft:multiplayer world with behavior packs get an option to download only the required assets from the behavior pack, or all assets. The game loads behavior packs based on the order of the packs on the list. The bottom-most pack loads first, then each pack placed above are loaded sequentially.

Custom behavior packs permanently disable Minecraft:achievement unlocking for the world. Custom behavior packs cannot be applied to worlds on Minecraft:Realms, but worlds uploaded to Realms or Minecraft:Bedrock Dedicated Server keep the behavior packs applied to the world.

In Bedrock Dedicated Server, behavior packs also can be stored outside of worlds. Packs need to be enabled in the

1. REDIRECT Template:Code

Template:Redr file in a world file.

Behavior packs cannot be edited while the game is active, except for the packs in the development_behavior_packs folder. They will update themselves when joining a world or changing active behavior packs.

Settings

Behavior packs and resource packs can contain custom settings that affect features in the pack.<ref>Template:Cite</ref> Settings need to be specified in

1. REDIRECT Template:Code

Template:Redr, with the options to create an on/off toggle, or a slider with specific values. The settings menu for custom and Marketplace behavior packs can be opened with a button next to the pack button in the edit world screen, and all settings affect the whole world. Custom labels for each setting can be applied, which support text formatting.

How each setting affects the behavior pack can be modified with scripting.

The settings menu can also be used to change the memory tier, which affects the sub-packs being used.<ref>Template:Cite</ref> The memory tier can be set to any specified value from the device's memory tier and lower. Sub-packs are behavior packs within the root of the behavior pack, with the same directory structure. They can be added to the pack in

1. REDIRECT Template:Code

Template:Redr.

Marketplace behavior packs

Add-ons and worlds from the Minecraft:Marketplace often contain or consist entirely of a behavior pack. These packs are stored internally and can't be accessed from Minecraft:com.mojang. Players can only access Marketplace behavior packs or play on worlds with behavior packs applied when they own the pack, by purchasing it in the Marketplace or by owning the Minecraft:Marketplace Pass. Which packs a player owns is stored in the online player profile, so behavior packs can only be accessed when signed in. Marketplace packs can be applied the same way as custom resource packs, and also to Realms, but not to worlds in external servers.

When a player joins a multiplayer world or Realm with Marketplace packs, the player is offered to download these packs to apply them, even when the player does not own the pack.

Marketplace behavior packs update automatically depending on the "Auto Update Unlocked Packs" settings, or can be updated manually from the purchase screen.

Contents

Directory structure

• Template:File or Template:File
  • Template:File
  • Template:File: The picture to display next to the behavior pack in-game.
  • Template:File: A behavior pack with the same directory structure inside the behavior pack. Multiple sub-packs can be used, and need to be specified in Template:File.
  • Template:File
    • Template:File
      • Template:File
    • Template:File
  • Template:File
    • Template:File<ref name="May be inside a directory" group="fn">File may be inside a directory.</ref>
  • Template:File
    • Template:File
  • Template:File
    • Template:File
  • Template:File
    • Template:File
      • Template:File
  • Template:File
    • Template:File
      • Template:File
    • Template:File
  • Template:File
    • Template:File
  • Template:File
    • Template:File
  • Template:File
    • Template:File
      • Template:File
    • Template:File
  • Template:File
    • Template:File
      • Template:File
    • Template:File
  • Template:File
    • Template:File
  • Template:File
    • Template:File
  • Template:File
    • Template:File
      • Template:File
    • Template:File<ref name="May be inside a directory" group="fn">File may be inside a directory.</ref>
  • Template:File
    • Template:File
  • Template:File
    • Template:File
  • Template:File
    • Template:File
  • Template:File
    • Template:File
    • Template:File
    • Template:File
  • Template:File
    • Template:File
  • Template:File
    • Template:File
      • Template:File<ref name="May be inside a directory" group="fn">File may be inside a directory.</ref>
    • Template:File
      • Template:File
    • Template:File
      • Template:File
    • Template:File
      • Template:File<ref name="May be inside a directory" group="fn">File may be inside a directory.</ref>

<references group="fn"></references>

Internal behavior packs

Most entities, biomes, loot tables, and various things from the base game are defined by the vanilla behavior pack, which is built inside the game itself and can be found at

1. REDIRECT Template:Code

Template:Redr. Mojang Studios releases the Bedrock Add-On Sample Files with every new update of Bedrock Edition, which provide the latest vanilla behavior and resource packs from the game.

Multiple internal behavior packs exist for different situations. Each experiment has its own behavior pack, in addition to Minecraft:Minecraft Education features and Minecraft:Minecraft Preview. Each behavior pack contains the same structure and assets as custom behavior packs, defined for the whole game. Some packs also have an icon or description, which is not visible in-game.

Bedrock Editon supports

1. REDIRECT Template:Wikipedia

Template:Redr for add-ons and old worlds. This is done for the

1. REDIRECT Template:Code

Template:Redr and

1. REDIRECT Template:Code

Template:Redr behavior packs since 1.14 and 1.20.50 respectively, with the regular behavior pack supporting the latest version before. Each update with changes to features defined in behavior packs has its own behavior pack, with all the features that changed. Some Marketplace add-ons can lock a world in an older version by disabling internal behavior packs from higher versions.

File name	Pack icon, name, and description	Description
chemistry	width=32x32	Resources for the "Minecraft Education features" cheat setting. Includes several features from the Chemistry Update in Minecraft:Minecraft Education. Multiple versions of this pack are available to support backwards-compatibility.
editor	width=32x32	Resources for Minecraft:Bedrock Editor, applied when the Editor is enabled upon launch. Contains five unique entities exclusive to the Editor, some textures for the GUI, and the main script file which can be customized.
experimental_creator_cameras	Experimental Creator Cameras	Contains a camera preset for the "Experimental Creator Cameras" experiment.
experimental_vanilla_shapes	Vanilla Voxel Shapes Experimental behavior pack for vanilla voxel shapes	Contains vanilla voxel shapes for the experiment, at this point nothing.
experimental_villager_trade	Villager Trade Rebalancing	Contains trade tables for the Villager Trade Rebalancing experiment, as well as different loot tables for mineshafts, ancient cities, desert pyramids, jungle pyramids, and pillager outposts.
experimental_y_2026_drop_1	Drop 1 of 2026 Experimental behavior pack for Drop 1 of 2026 content	Adds features for the Minecraft:Tiny Takeover, including a name tag recipe and some changes to baby mobs.
experimental_y_2026_drop_2	Drop 2 of 2026 Experimental behavior pack for Drop 2 of 2026 content	Adds features for Chaos Cubed, including the sulfur caves, sulfur cube, Minecraft:cinnabar, and Minecraft:sulfur.
server_editor_library	width=32x32 Server Editor Library Library for building server driven Editor UI	Contains scripts for the Editor when used on Minecraft:Bedrock Dedicated Server.
server_library	width=32x32 @minecraft/server TS Library A BP containing all the @minecraft/server typescript code.	Contains typescript code for the Editor. Only available in Minecraft Preview.
server_ui_library	width=32x32 @minecraft/server-ui TS Library A BP containing all the @minecraft/server-ui typescript code.	Contains scripts for the UI in the Editor. Only available in Minecraft Preview.
vanilla	width=32x32	All resources for the default Minecraft game. Multiple versions of this pack are available to support backwards-compatibility.

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

History

{{#vardefine:params|0 }}Template:Hatnote Template:Message boxTemplate:Article other

See also

• Minecraft:Mod
• Minecraft:Commands
• Data pack
• Resource 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
• Schema Documentation

Official tutorials

• Getting Started With Minecraft Add-Ons
• Introduction to Behavior Packs

Tools and libraries

• Commonly Used Tools
• Minecraft Creator Tools

Unofficial resources

• Bedrock Wiki

Templates

• Bedrock Add-On Sample Files

Navigation

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

Help Template:FileLink Historical Template:BlockLink Template:FileLink Template:FileLink Template:ItemLink Menu screens Aspects Template:BlockLink Template:EnvLink Historical Logo Splash Instances Title Screen Select World Create New World Template:BlockLink Loading world screen Template:EnvLink Game customization Template:EnvLink Template:EnvLink Template:FileLink Behavior packs Template:ItemLink Template:EnvLink Template:ItemLink Template:EnvLink Template:PersonaLink Template:PersonaLink Miscellaneous Template:EnvLink Template:EnvLink Template:BlockLink § End Poem Template:BlockLink Template:CharacterLink Template:EnvLink Template:EnvLink Template:EnvLink Template:EnvLink Version formats Version types Game drop Concept art Key art Template:FileLink Template:FileLink

Java Demo Locations Discontinued Template:IconEdition Bedrock Template:IconEdition Merged Template:IconEdition Template:IconEdition Ports to consoles Template:OS Template:Wikipedia Template:OS Template:Wikipedia Template:OS Template:Wikipedia Template:OS Template:Wikipedia Template:OS Template:Wikipedia Discontinued Template:IconEdition Protocol Template:IconEdition Template:IconEdition Template:IconEdition China Game Experience Area Miscellaneous Minecraft Classic Discontinued Template:LC Template:IconEdition Template:IconEdition Template:IconEdition Template:IconEdition Template:IconEdition Template:IconEdition Template:IconEdition Miscellaneous Template:Edition Template:IconEdition

de:Verhaltenspaket pt:Pacote de comportamento ru:Пакет поведения