Minecraft:Molang

Template:Hatnote Template:Message box Molang is an expression-based language designed for fast, data-driven calculation of values at run-time, and with a direct connection to in-game values and systems. It is used in Template:Editions in their Add-on system with its purpose being to enable low-level systems like animation to support flexible data-driven behavior for both internal and external creators, while staying highly performant. Molang's syntax is based off the

1. REDIRECT Template:Wikipedia

Template:Redr language.<ref>"Molang Documentation - Introduction to Molang"</ref>

Mojang Studios provides official documentation which goes into details of how the language works and where it is used. The Bedrock Wiki provides more areas of Molang where the official documentation may not cover.

Usage

Molang expressions are used to output values, usually numbers, that can dynamically change. This allows for more complex behavior to be coded for within the restrictions of Minecraft:JSON. Molang can be used in various places within the JSON files of both resource packs (the client) and Minecraft:behavior packs (the server):

• Values in particle components
• Values in the scripts and part_visibility fields of entity definitions
• Values in the scripts field of attachables
• Values in animations
• Conditions in the transitions fields of animation controllers
• Conditions in the permutations field of block behaviors
• Arrays and resource allocations in render controllers
• Values within certain entity components
• Data fields in recipe objects

Guide

Molang expressions are stored as plain text strings in Minecraft:JSON files, enclosed with ". As such, ' must be used instead for any string definitions within the expression. Unlike Minecraft:commands, expressions are case-insensitive, meaning capitalization will not affect how they are interpreted.

For expressions with only a single statement, the terminating symbol ; can be removed. Expressions with multiple statements need ; in order to separate individual statements.

Operators

1. Redirect Template:Empty section

Variables

Variables, prefixed with variable. or v., are values that can be stored for later use within an expression. Most variables can be declared and reassigned using the = operator, for example in v.<name> = <value>;. Variables declared this way can be read and written for the lifetime of their entity or particle and are not maintained when a world is saved and reloaded.

Temporary variables, prefixed with either temp. or t., only exist while the expression they are declared under is executed.

Context variables, prefixed with context. or c., are read-only variables that are only available under the context of where the expression reading the variable is defined. For example, context.owning_entity can only be read from molang expressions added to an attachable file, since the variable returns the entity which has the attachable equipped.

Functions

Queries

Queries, prefixed with q. or query., return information about the world, entity, etc. as either a boolean or numeric value. They are read-only and cannot be modified. For example, query.health returns the current entity's health, or 0 is not used within an entity.

Certain queries can also take arguments, which are placed within enclosed brackets after the query name and separated by commas if there are multiple inputs. Arguments can be read as numbers or as strings, where they can be further used as identifiers for objects such as tags, Minecraft:slots, and entities. For example, q.is_item_name_any('slot.weapon.mainhand', 0, 'minecraft:iron_ingot') evaluates to either 1 (true) or 0 (false) based off whether or not the item name (or rather type ID) of the current entity's first slot of their mainhand (the mainhand only has one slot, unlike the inventory or hotbar. Slot indexes start at 0) matches any of the arguments put after the 2nd one.

While some queries are consistent over both behavior and resource packs, some are exclusive to only one or the other, an example being query.remaining_durability, which can only be used server-side for the item component minecraft:repairable.

Math functions

Math functions, prefixed with math. without a single-letter alias, perform specific mathematic operations, taking data in the same way as certain queries.

For example, math.floor(3.8) evaluates the input value rounded down as 3.0.

References

<references />

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

es:Molang fr:Molang ja:Molang lzh:魔琅 pt:Molang ru:Molang uk:Molang zh:Molang