Client entity definitions are contained within a Resource Pack. To start, create a new folder and name it "entity" inside the root of the Resource Pack. In the entity folder create a JSON file and give it a name.The JSON file needs a format version and minecraft:client_entity information.The minecraft:client_entity section contains the description for the entity. Under description there are a number of things that you can set about an entity. Generally, this file is defining what resources a mob requires and gives a friendly name to each, that the other definition files can use.
Example client entity definitions JSON for the pig
"format_version": "1.8.0", "minecraft:client_entity": { "description": { "identifier": "minecraft:pig", "min_engine_version": "1.8.0", "materials": { "default": "pig" }, "textures": { "default": "textures/entity/pig/pig", "saddled": "textures/entity/pig/pig_saddle" }, "geometry": { "default": "geometry.pig.v1.8" }, "animations": { "setup": "animation.pig.setup", "walk": "animation.quadruped.walk", "look_at_target": "animation.common.look_at_target", "baby_transform": "animation.pig.baby_transform" }, "animation_controllers": [ { "setup": "controller.animation.pig.setup" }, { "move": "controller.animation.pig.move" }, { "baby": "controller.animation.pig.baby" } ], "render_controllers": [ "controller.render.pig" ], "locators": { "lead": { "head": [ 0.0, 14.0, -6.0 ] } }, "spawn_egg": { "texture": "spawn_egg", "texture_index": 2 } } }
This sets the color or texture used for the entity Spawn Egg. There are 2 ways to do this. The first is to use the hex value for the base color and the overlay color.
Example Spawn Egg using hex value
"spawn_egg": { "base_color": "#53443E", "overlay_color": "#2E6854" }
The other way is to specify a texture.Example Spawn Egg specifying a texture. The texture is located in the "items_texture" JSON in the textures folder of the Resource Pack. When there are more than one texture associated with a texture name you can use an index to pick the one that you want. If no index is specified than it is assumed to be 0 and the first texture in the list is used.
Example Spawn Egg specifying a texture
"spawn_egg": { "texture": "spawn_egg", "texture_index": 2 }
Animation controllers decide which animations to play when. Each Controller contains a list of states that play one or more animations. Allows the player to assign names to reference the long names for animation controllers. Names are required and need to be unique from all other names in the animation controllers for that mob. Players can reference animation controllers from the vanilla Minecraft Resource Pack or create their own. Custom animation controllers should be in the animation_controllers folder at the root of the Resource Pack.
Allows the player to assign names to reference the long name for animations. These names are used by the animation controller JSON. Players can reference animations from the vanilla Minecraft Resource Pack or create their own. Custom animations should be in the animation folder at the root of the Resource Pack.
This determines if the entity can equip attachables when this is set to true. This allows the entity to render armor and weapons.
"enable_attachables": true
This determines if the item held by an entity should render fully lit up (if true), or depending on surrounding lighting.
"held_item_ignores_lighting": true
This determines if the armor attached to an entity should be hidden when set to true. This overrides the rendering settings specified by 'enable_attachables'
"hide_armor": true
The identifier is used to register the entity with the server. In the Client Entity Definitions JSON the identifier sets the appearance of the entity(materials, textures, geometry, etc.) The matching identifier in the Entity Behavior JSON in the Behavior Pack is what gives the entity its behaviors.
Locator offsets are specified in model space. An example of a locator is the "lead" locator used to specify where the lead will attach to graphically.
"locators": { "lead": { "head": [ 0.0, 14.0, -6.0 ] } }
Players can set the materials, texture and geometry used for the entity in this section. Players can set one or more materials, textures, and geometries that can be used by the mob. Players must set user defined names for them. These names are used in the Render Controllers JSON. Players can reference materials, textures, and geometry from the vanilla Minecraft Resource Pack or create their own. Custom materials, textures, and geometry should be in the corresponding folder at the root of the Resource Pack.
When present, players can set the min version needed to allow the JSON to be parsed. The version in the definition is compared to the engine version for which the top resource pack was built.If a definition's min_engine_version is newer than that pack's engine version then the definition is not parsed.Multiple definition files may use the same identifier, in which case only one of those definitions will be loaded. The definition with the same or closest and not greater min_engine_version, as compared to the top resource pack's engine version, will be parsed; all other definitions with the same identifier will not be parsed.This can be useful for continuing to support an older version of an entity, when an older resource pack is used at the top of the resource pack stack, while also supporting a newer version of the entity in all other cases.
Allows the player to assign a key to reference the long name for particles. When these are present, the particle is created when the entity is spawned. Keys are required and need to be unique from all other keys in the animation controllers. Players can reference particles from the vanilla Minecraft Resource Pack or create their own. Custom particles should be in the particle folder at the root of the Resource Pack.
Specifies the names of render controllers. This name needs to match the name of a corresponding JSON located in the Render Controllers folder. Players can reference Render Controllers from the vanilla Minecraft Resource Pack or create their own. Custom Render Controllers should be in the textures folder at the root of the Resource Pack.
Scripts allow players to use Molang to compute calculations once and store that value. This value than can be used over and over again without the need to constantly recompute the calculations. Scripts currently support pre - animation and scale.More script types will be added later.-Pre-animation scripts are evaluated immediately before animations are processed.-Scale sets the scale of the mob's geometry.
Example pre-animation script for cod
"scripts": { "pre_animation": [ "variable.ZRot = !query.is_in_water ? Math.cos((query.time_stamp + global.frame_alpha) * 14.32) * 90 : 0.0;", "variable.AnimationAmountBlend = Math.lerp(variable.AnimationAmountPrev, variable.AnimationAmount, global.frame_alpha);" ] },
Example scale script for the bat
"scripts": { "scale": "0.35" },
Data-Driven spawning allows you to adjust the spawn conditions of mobs, including new mobs added to the game to spawn naturally in biomes, add / remove a mob's spawn egg to the creative inventory and set the mob's spawn egg, and add / remove a to the / summon command
Each biome in the game has one or more tags. These are used to determine what biomes mobs spawn in. Here is the list of Biome tags that can be used:
| Tag |
|---|
| animal |
| beach |
| birch |
| cold |
| dark_oak |
| deep |
| desert |
| edge |
| extreme_hills |
| flower_forest |
| forest |
| frozen |
| hills |
| ice |
| ice_plains |
| jungle |
| lakes |
| lukewarm |
| mega |
| mesa |
| monster |
| mooshroom_island |
| mountain |
| mutated |
| nether |
| ocean |
| plains |
| plateau |
| river |
| roofed |
| savanna |
| shore |
| stone |
| swamp |
| taiga |
| the_end |
| warm |
Conditions contain different components that players can use to customize natural biome spawning.
| Name | Description | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| minecraft:biome_filter | This component allows the players to specify which biomes the mob spawns in. Check below to see which Biome Tags exist, and what each biome is tagged as. | ||||||||||||||||||||
| minecraft:brightness_filter | This component allows players to set the light level range that causes the mob to spawn.
|
||||||||||||||||||||
| minecraft:density_limit | This component allows players to determine the density cap limits for the specified mob type.
|
||||||||||||||||||||
| minecraft:difficulty_filter | This component allows players determine what mobs spawn when certain difficulty levels are set.
|
||||||||||||||||||||
| minecraft:herd | This component allows players to determine the herd size of animals.
|
||||||||||||||||||||
| minecraft:spawns_on_surface | This component allows the mob to spawn on the ground. Adding the component causes it to be true, removing it causes the mob to stop spawning on the surface. | ||||||||||||||||||||
| minecraft:spawns_underwater | This component allows the mob to spawn underwater. Adding the component causes it to be true, removing it causes the mob to stop spawning underwater. | ||||||||||||||||||||
| minecraft:weight | This component allows players to give a priority to how often that mob should spawn. Mobs with lower weight values have a higher chance to spawn than mobs with higher weight values.
|
New Spawn Rules are contained within a Behavior Pack. To begin, create a new folder named "spawn_rules" in the root of the Behavior Pack that you want to add the new biome spawn rules in. In the spawn_rules folder, create a JSON file and give it a name. The JSON file needs a format, description and conditions.Spawn rules contain description and conditionsAll Spawn Rules JSON need to have an ID (located under the description section). Similar to other identifiers, it follows the convention "namespace:name". The minecraft namespace is reserved for the vanilla Minecraft rules.When changing an existing mob use the ID that appears in the entity JSON for that entity. When creating your own mob, make sure the mobs have the same ID in all the entity's JSON files.Spawn Rules also needs to define the pool that is used for population control.Each pool has their own spawn limit, By setting an entity to a pool it will spawn as long as that pool hasn't reached the spawn limit.There are 3 pools that entities can be assigned to :-animal-water_animal-monster
| Biome | Tags |
|---|---|
| Beach | monster, beach, warm |
| Birch Forest | animal, monster, birch, forest |
| Birch Forest Hills | animal, monster, birch, forest, hills |
| Birch Forest Hills M | animal, monster, forest, birch, mutated, hills |
| Birch Forest M | animal, monster, forest, birch, mutated |
| Cold Ocean | ocean, cold, monster |
| Cold Taiga M | animal, monster, taiga, cold, mutated |
| Dark Forest | animal, monster, forest, roofed |
| Dark Forest M | animal, monster, roofed, forest, mutated |
| Deep Cold Ocean | ocean, cold, monster, deep |
| Deep Frozen Ocean | ocean, frozen, monster, deep |
| Deep Lukewarm Ocean | ocean, lukewarm, monster, deep |
| Deep Ocean | ocean, monster, deep |
| Deep Warm Ocean | ocean, warm, monster, deep |
| Desert | monster, desert |
| Desert Hills | monster, desert, hills |
| Desert M | monster, desert, mutated |
| Forest | animal, monster, forest |
| Forest Hills | animal, monster, hills |
| Forest M | monster, flower_forest, forest, mutated |
| Frozen Ocean | ocean, frozen, monster |
| Frozen River | river, frozen |
| Giant Tree Taiga | animal, monster, taiga, mega |
| Giant Tree Taiga Hills | animal, monster, taiga, mega, hills |
| Giant Tree Taiga Hills M | animal, monster, taiga, mega, hills, mutated |
| Giant Trees Taiga M | animal, monster, mutated, mega |
| Jungle | animal, monster, jungle |
| Jungle Edge | animal, monster, jungle, edge |
| Jungle Edge M | animal, monster, jungle, edge, mutated |
| Jungle Hills | animal, monster, jungle, hills |
| Jungle M | animal, monster, jungle, mutated |
| Lukewarm Ocean | ocean, lukewarm, monster |
| Mesa | monster |
| Mesa M | animal, monster, mesa, mutated |
| Mesa Plateau | monster, mesa |
| Mesa Plateau M | monster, mesa, plateau, mutated |
| Mesa Plateau Stone | monster, plateau |
| Mesa Plateau Stone M | monster, mesa, plateau, mutated, stone |
| Mountain | animal, monster, extreme_hills |
| Mountain + M | animal, monster, extreme_hills, mutated, forest |
| Mountain Edge | animal, monster, extreme_hills, edge, mountain |
| Mountain M | animal, monster, extreme_hills, mutated |
| Mushroom Fields | mooshroom_island |
| Mushroom Fields Shore | mooshroom_island, shore |
| Nether | nether |
| Ocean | ocean, monster |
| Plains | animal, monster, plains |
| Plains M | animal, monster, plains, mutated |
| River | river |
| Savanna | animal, monster, savanna |
| Savanna M | animal, monster, savanna, mutated |
| Savanna Plateau | animal, monster, savanna |
| Savanna Plateau M | animal, monster, savanna, plateau, mutated |
| Snowy Beach | monster, beach, cold |
| Snowy Mountains | frozen, ice, mountain |
| Snowy Taiga | animal, monster, taiga, cold |
| Snowy Taiga Hills | animal, monster, taiga, cold, hills |
| Snowy Tundra | frozen, ice_plain, ice |
| Snowy Tundra M | monster, frozen, ice_plains, mutated |
| Stone Shore | monster, beach, stone |
| Swamp | animal, monster, swamp |
| Swamp M | animal, monster, swamp, mutated |
| Taiga | animal, monster, taiga |
| Taiga Hills | animal, monster, taiga, hills |
| Taiga M | animal, monster, taiga, mutated |
| The End | the_end |
| Warm Ocean | ocean, warm, monster |
| Wooded Mountain | animal, monster, extreme_hills, forest, mountain |
Example Spawn Rules for the zombie
"format_version": "1.8.0", "minecraft:spawn_rules": { "description": { "identifier": "minecraft:zombie", "population_control": "monster" }, "conditions": [ { "minecraft:spawns_on_surface": {}, "minecraft:brightness_filter": { "min": 0, "max": 7, "adjust_for_weather": true }, "minecraft:difficulty_filter": { "min": "easy", "max": "hard" }, "minecraft:weight": { "default": 100 }, "minecraft:herd": { "min_size": 2, "max_size": 4 }, "minecraft:permute_type": [ { "weight": 95 }, { "weight": 5, "entity_type": "minecraft:zombie_villager" } ], "minecraft:biome_filter": { "test": "has_biome_tag", "operator": "==", "value": "monster" } } ] }
Filters allow data objects to specify test criteria which allows their use.For example, a model that includes a filter will only be used when the filter criteria is true.A typical filter consists of four parameters: name: the name of the test to apply. domain: the domain the test should be performed in. An armor slot, for example. This parameter is only used by a few tests. operator: the comparison to apply with the value, such as 'equal' or 'greater'. value: the value being compared with the test.A typical filter looks like the following: { "test" : "moon_intensity", "subject" : "self", "operator" : "greater", "value" : "0.5" } Which results in the calling entity (self) calculating the moon_intensity at its location and returning true if the result is greater than 0.5.Tests can be combined into groups using the collections 'all_of', 'any_of', or 'none_of'. All tests in an 'all_of' group must pass in order for the group to pass. One or more tests in an 'any_of' group must pass in order for the group to pass. All tests in a 'none_of' group must fail in order for the group to pass.
Tests the health of the subject.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Integer | (Required) An integer value. |
Full..
{ "test": "actor_health", "subject": "self", "operator": "equals", "value": "0" }
Short (using Defaults)..
{ "test": "actor_health", "value": "0" }
Returns true when the designated equipment location for the subject entity is completely empty.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | any | (Optional) The equipment location to test
|
Full..
{ "test": "all_slots_empty", "subject": "self", "operator": "equals", "value": "any" }
Short (using Defaults)..
{ "test": "all_slots_empty" }
Returns true when the designated equipment location for the subject entity has any empty slot.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | any | (Optional) The equipment location to test
|
Full..
{ "test": "any_slot_empty", "subject": "self", "operator": "equals", "value": "any" }
Short (using Defaults)..
{ "test": "any_slot_empty" }
Returns true when the bool actor property matches the value provided.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| domain | String | (Required) The property name to look for | |||||||||||||||||||||||
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "bool_property", "subject": "self", "domain": "minecraft:can_climb", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "bool_property", "domain": "minecraft:can_climb" }
Compares the current time with a float value in the range (0.0, 1.0). 0.0= Noon 0.25= Sunset 0.5= Midnight 0.75= Sunrise
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Decimal | (Required) A floating point value. |
Full..
{ "test": "clock_time", "subject": "self", "operator": "equals", "value": "0.00" }
Short (using Defaults)..
{ "test": "clock_time", "value": "0.00" }
Compares the distance to the nearest Player with a float value.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Decimal | (Required) A floating point value. |
Full..
{ "test": "distance_to_nearest_player", "subject": "self", "operator": "equals", "value": "0.00" }
Short (using Defaults)..
{ "test": "distance_to_nearest_player", "value": "0.00" }
Returns true when the enum actor property matches the value provided.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| domain | String | (Required) The property name to look for | |||||||||||||||||||||||
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | (Required) A string value. |
Full..
{ "test": "enum_property", "subject": "self", "domain": "minecraft:can_climb", "operator": "equals", "value": "" }
Short (using Defaults)..
{ "test": "enum_property", "domain": "minecraft:can_climb", "value": "" }
Returns true when the float actor property matches the value provided.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| domain | String | (Required) The property name to look for | |||||||||||||||||||||||
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Decimal | (Required) A floating point value. |
Full..
{ "test": "float_property", "subject": "self", "domain": "minecraft:can_climb", "operator": "equals", "value": "0.00" }
Short (using Defaults)..
{ "test": "float_property", "domain": "minecraft:can_climb", "value": "0.00" }
Returns true when the subject entity has the named ability.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | (Required) The Ability type to test
|
Full..
{ "test": "has_ability", "subject": "self", "operator": "equals", "value": "instabuild" }
Short (using Defaults)..
{ "test": "has_ability", "value": "instabuild" }
Tests whether the biome the subject is in has the specified tag.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | (Required) The tag to look for |
Full..
{ "test": "has_biome_tag", "subject": "self", "operator": "equals", "value": " " }
Short (using Defaults)..
{ "test": "has_biome_tag", "value": " " }
Returns true when the subject entity contains the named component.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | (Required) The component name to look for |
Full..
{ "test": "has_component", "subject": "self", "operator": "equals", "value": "minecraft:explode" }
Short (using Defaults)..
{ "test": "has_component", "value": "minecraft:explode" }
Returns true when the subject Player entity has opened a container.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "has_container_open", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "has_container_open" }
Returns true when the subject entity receives the named damage type.
| Name | Type | Default | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| value | String | (Required) The Damage type to test
|
Full..
{ "test": "has_damage", "subject": "self", "operator": "equals", "value": "fatal" }
Short (using Defaults)..
{ "test": "has_damage", "value": "fatal" }
Tests for the presence of a damaged named item in the designated slot of the subject entity.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| domain | String | any | (Optional) The equipment location to test
|
||||||||||||||||||||||
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | (Required) The item name to look for |
Full..
{ "test": "has_damaged_equipment", "subject": "self", "domain": "any", "operator": "equals", "value": "dirt" }
Short (using Defaults)..
{ "test": "has_damaged_equipment", "value": "dirt" }
Tests for the presence of a named item in the designated slot of the subject entity.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| domain | String | any | (Optional) The equipment location to test
|
||||||||||||||||||||||
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | (Required) The item name to look for |
Full..
{ "test": "has_equipment", "subject": "self", "domain": "any", "operator": "equals", "value": "dirt" }
Short (using Defaults)..
{ "test": "has_equipment", "value": "dirt" }
Tests whether the Subject has the specified mob effect.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | (Optional) A string value. |
Full..
{ "test": "has_mob_effect", "subject": "self", "operator": "equals", "value": "" }
Short (using Defaults)..
{ "test": "has_mob_effect" }
Tests if the subject has been given a custom name.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "has_nametag", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "has_nametag" }
Tests for the presence of a property of the subject entity.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | (Required) The property name to look for |
Full..
{ "test": "has_property", "subject": "self", "operator": "equals", "value": "minecraft:can_climb" }
Short (using Defaults)..
{ "test": "has_property", "value": "minecraft:can_climb" }
Returns true when the subject entity is holding a ranged weapon like a bow or crossbow.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "has_ranged_weapon", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "has_ranged_weapon" }
Tests if the subject is holding an item with silk touch.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "has_silk_touch", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "has_silk_touch" }
Returns true if the subject entity has the tag provided.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | (Optional) A string value. |
Full..
{ "test": "has_tag", "subject": "self", "operator": "equals", "value": "" }
Short (using Defaults)..
{ "test": "has_tag" }
Returns true if the subject entity has a valid target.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "has_target", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "has_target" }
Tests whether the target has any trade supply left. Will return false if the target cannot be traded with.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "has_trade_supply", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "has_trade_supply" }
Compares the current 24 hour time with an int value in the range[0, 24000]
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Integer | (Required) An integer value. |
Full..
{ "test": "hourly_clock_time", "subject": "self", "operator": "equals", "value": "0" }
Short (using Defaults)..
{ "test": "hourly_clock_time", "value": "0" }
Returns true when the subject entity is inside a specified Block type.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | (Optional) A string value. |
Full..
{ "test": "in_block", "subject": "self", "operator": "equals", "value": "" }
Short (using Defaults)..
{ "test": "in_block" }
Returns true if the subject entity is in a caravan.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "in_caravan", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "in_caravan" }
Returns true when the subject entity is in the clouds.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "in_clouds", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "in_clouds" }
Returns true when the subject entity in contact with any water: water, rain, splash water bottle.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "in_contact_with_water", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "in_contact_with_water" }
Returns true when the subject entity is in lava.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "in_lava", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "in_lava" }
Returns true when the subject entity is in Nether.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "in_nether", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "in_nether" }
Returns true when the subject entity is in Overworld.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "in_overworld", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "in_overworld" }
Returns true when the subject entity is in water.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "in_water", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "in_water" }
Returns true when the subject entity is in water or rain.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "in_water_or_rain", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "in_water_or_rain" }
Tests if the specified duration in seconds of inactivity for despawning has been reached.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Integer | (Required) An integer value. |
Full..
{ "test": "inactivity_timer", "subject": "self", "operator": "equals", "value": "0" }
Short (using Defaults)..
{ "test": "inactivity_timer", "value": "0" }
Returns true when the int actor property matches the value provided.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| domain | String | (Required) The property name to look for | |||||||||||||||||||||||
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Integer | (Required) An integer value. |
Full..
{ "test": "int_property", "subject": "self", "domain": "minecraft:can_climb", "operator": "equals", "value": "0" }
Short (using Defaults)..
{ "test": "int_property", "domain": "minecraft:can_climb", "value": "0" }
Tests the current altitude against a provided value. 0= bedrock elevation.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Integer | (Required) The altitude value to compare with |
Full..
{ "test": "is_altitude", "subject": "self", "operator": "equals", "value": "0" }
Short (using Defaults)..
{ "test": "is_altitude", "value": "0" }
Returns true if the subject entity is fleeing from other mobs.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_avoiding_mobs", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_avoiding_mobs" }
Returns true when the subject entity is a baby.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_baby", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_baby" }
Tests whether the Subject is currently in the named biome.
| Name | Type | Default | Description | ||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||||||||||||||||||
| value | String | (Required) The Biome type to test
|
Full..
{ "test": "is_biome", "subject": "self", "operator": "equals", "value": "beach" }
Short (using Defaults)..
{ "test": "is_biome", "value": "beach" }
Returns true when the block has the given name.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | (Required) The Family name to look for |
Full..
{ "test": "is_block", "subject": "self", "operator": "equals", "value": "player" }
Short (using Defaults)..
{ "test": "is_block", "value": "player" }
Tests the current brightness against a provided value in the range (0.0f, 1.0f).
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Decimal | (Required) The brightness value to compare with. |
Full..
{ "test": "is_brightness", "subject": "self", "operator": "equals", "value": "0.50" }
Short (using Defaults)..
{ "test": "is_brightness", "value": "0.50" }
Returns true if the subject entity is climbing.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_climbing", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_climbing" }
Returns true if the subject entity is the named color.
| Name | Type | Default | Description | ||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||||||||||||||
| value | String | (Required) The Palette Color to test
|
Full..
{ "test": "is_color", "subject": "self", "operator": "equals", "value": "white" }
Short (using Defaults)..
{ "test": "is_color", "value": "white" }
Returns true during the daylight hours.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_daytime", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_daytime" }
Tests the current difficulty level of the game.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | (Required) The game's difficulty level to test
|
Full..
{ "test": "is_difficulty", "subject": "self", "operator": "equals", "value": "normal" }
Short (using Defaults)..
{ "test": "is_difficulty", "value": "normal" }
Returns true when the subject entity is a member of the named family.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | (Required) The Family name to look for |
Full..
{ "test": "is_family", "subject": "self", "operator": "equals", "value": "player" }
Short (using Defaults)..
{ "test": "is_family", "value": "player" }
Tests whether a named game rule is active.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| domain | String | (Required) The Game Rule to test. | |||||||||||||||||||||||
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_game_rule", "subject": "self", "domain": "domobspawning", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_game_rule", "domain": "domobspawning" }
Tests whether the Subject is in an area with humidity
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_humid", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_humid" }
Returns true if the subject entity is immobile. An entity is immobile if it lacks AI goals, has just changed dimensions or if it is a mob and has no health.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_immobile", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_immobile" }
Tests whether the Subject is inside the bounds of a village.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_in_village", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_in_village" }
Returns true if the subject entity is leashed.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_leashed", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_leashed" }
Returns true if the subject entity leashed to the calling entity.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_leashed_to", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_leashed_to" }
Returns true if the subject entity is the mark variant number provided.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Integer | (Required) An integer value. |
Full..
{ "test": "is_mark_variant", "subject": "self", "operator": "equals", "value": "0" }
Short (using Defaults)..
{ "test": "is_mark_variant", "value": "0" }
Tests if the subject is not at full health.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_missing_health", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_missing_health" }
Returns true if the subject entity is moving.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_moving", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_moving" }
Returns true if the subject entity is the owner of the calling entity.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_owner", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_owner" }
Tests if the subject is panicking.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_panicking", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_panicking" }
Tests if the subject's persistence matches the bool value passed in.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_persistent", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_persistent" }
Tests if the subject is a raider.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_raider", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_raider" }
Returns true if the subject entity is riding on another entity.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_riding", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_riding" }
Tests if the subject is sitting.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_sitting", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_sitting" }
Returns true if the subject entity is the skin id number provided.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Integer | (Required) An integer value. |
Full..
{ "test": "is_skin_id", "subject": "self", "operator": "equals", "value": "0" }
Short (using Defaults)..
{ "test": "is_skin_id", "value": "0" }
Tests whether the Subject is sleeping.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_sleeping", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_sleeping" }
Returns true if the subject entity has the sneak input held.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_sneak_held", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_sneak_held" }
Returns true if the subject entity is sneaking.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_sneaking", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_sneaking" }
Tests whether the Subject is in an area with snow cover
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_snow_covered", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_snow_covered" }
Tests if the subject is sprinting.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_sprinting", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_sprinting" }
Returns true if the subject entity is the target of the calling entity.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_target", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_target" }
Tests whether the current temperature is a given type.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | (Required) The Biome temperature catagory to test
|
Full..
{ "test": "is_temperature_type", "subject": "self", "operator": "equals", "value": "cold" }
Short (using Defaults)..
{ "test": "is_temperature_type", "value": "cold" }
Tests the current temperature against a provided value in the range (0.0, 1.0) where 0.0f is the coldest temp and 1.0f is the hottest.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Decimal | (Required) The Biome temperature value to compare with. |
Full..
{ "test": "is_temperature_value", "subject": "self", "operator": "equals", "value": "0.50" }
Short (using Defaults)..
{ "test": "is_temperature_value", "value": "0.50" }
Returns true when the subject entity is underground. An entity is considered underground if there are non-solid blocks above it.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_underground", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_underground" }
Returns true when the subject entity is under water. An entity is considered underwater if it is completely submerged in water blocks.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_underwater", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_underwater" }
Returns true if the subject entity is the variant number provided.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Integer | (Required) An integer value. |
Full..
{ "test": "is_variant", "subject": "self", "operator": "equals", "value": "0" }
Short (using Defaults)..
{ "test": "is_variant", "value": "0" }
Returns true if the subject entity is visible.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "is_visible", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_visible" }
Tests if the subject block is submerged in water.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | (Required) true or false. |
Full..
{ "test": "is_waterlogged", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "is_waterlogged", "value": "true" }
DEPRECATED
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | (Required) The Family name to look for |
Full..
{ "test": "is_weather", "subject": "self", "operator": "equals", "value": "player" }
Short (using Defaults)..
{ "test": "is_weather", "value": "player" }
Tests is the mob is outside of the specified light level range (0, 16).
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Integer | (Required) An integer value. |
Full..
{ "test": "light_level", "subject": "self", "operator": "equals", "value": "0" }
Short (using Defaults)..
{ "test": "light_level", "value": "0" }
Compares the current moon intensity with a float value in the range (0.0, 1.0)
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Decimal | (Required) A floating point value. |
Full..
{ "test": "moon_intensity", "subject": "self", "operator": "equals", "value": "0.00" }
Short (using Defaults)..
{ "test": "moon_intensity", "value": "0.00" }
Compares the current moon phase with an integer value in the range (0, 7).
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Integer | (Required) An integer value. |
Full..
{ "test": "moon_phase", "subject": "self", "operator": "equals", "value": "0" }
Short (using Defaults)..
{ "test": "moon_phase", "value": "0" }
Tests if the subject is on fire.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "on_fire", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "on_fire" }
Returns true when the subject entity is on ground.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "on_ground", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "on_ground" }
Tests if the subject is on a hot block.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "on_hot_block", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "on_hot_block" }
Returns true when the subject entity is on a ladder.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "on_ladder", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "on_ladder" }
Returns true if the random chance rolls 0 out of a specified max range.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Integer | (Required) An integer value. |
Full..
{ "test": "random_chance", "subject": "self", "operator": "equals", "value": "0" }
Short (using Defaults)..
{ "test": "random_chance", "value": "0" }
Returns the number of riders on this entity.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Integer | (Required) An integer value. |
Full..
{ "test": "rider_count", "subject": "self", "operator": "equals", "value": "0" }
Short (using Defaults)..
{ "test": "rider_count", "value": "0" }
Tests if the subject is a surface mob.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "surface_mob", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "surface_mob" }
Tests if the subject is taking fire damage. Requires the damage_sensor component
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "taking_fire_damage", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "taking_fire_damage" }
Tests the distance between the calling entity and its target.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Decimal | (Required) A floating point value. |
Full..
{ "test": "target_distance", "subject": "self", "operator": "equals", "value": "0.00" }
Short (using Defaults)..
{ "test": "target_distance", "value": "0.00" }
Returns true if the subject is trusted by entity.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "trusts", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "trusts" }
Tests if the subject is the last player who attacked the entity in the last 400 seconds, or the last mob to do so in the last 60 seconds.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | Boolean | true | (Optional) true or false. |
Full..
{ "test": "was_last_hurt_by", "subject": "self", "operator": "equals", "value": "true" }
Short (using Defaults)..
{ "test": "was_last_hurt_by" }
Tests the current weather in the dimension against a provided weather value.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | (Required) The Family name to look for |
Full..
{ "test": "weather", "subject": "self", "operator": "equals", "value": "player" }
Short (using Defaults)..
{ "test": "weather", "value": "player" }
Tests the current weather, at the actor's position, against a provided weather value.
| Name | Type | Default | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| operator | String | equals | (Optional) The comparison to apply with 'value'.
|
||||||||||||||||||||||
| subject | String | self | (Optional) The subject of this filter test.
|
||||||||||||||||||||||
| value | String | (Required) The Family name to look for |
Full..
{ "test": "weather_at_position", "subject": "self", "operator": "equals", "value": "player" }
Short (using Defaults)..
{ "test": "weather_at_position", "value": "player" }
This filter group will pass only when the moon_intensity is greater than 0.5 AND the caller's target entity is standing in water.
"all_of" : [ : { "test" : "moon_intensity", "subject" : "self", "operator" : "greater", "value" : "0.5" }, : { "test" : "in_water", "subject" : "target", "operator" : "equal", "value" : "true" } : ]
Enables the mob to admire items that have been configured as admirable. Must be used in combination with the admire_item component
| Name | Type | Default Value | Description |
|---|---|---|---|
| admire_item_sound | String | The sound event to play when admiring the item | |
| sound_interval | Range [a, b] | 0 | The range of time in seconds to randomly wait before playing the sound again. |
Allows this entity to avoid certain blocks.
| Name | Type | Default Value | Description |
|---|---|---|---|
| avoid_block_sound | String | The sound event to play when the mob is avoiding a block. | |
| on_escape | Trigger | Escape trigger. | |
| search_height | Integer | 0 | Maximum distance to look for a block in y. |
| search_range | Integer | 0 | Maximum distance to look for a block in xz. |
| sound_interval | Range [a, b] | [3.0, 8.0] | The range of time in seconds to randomly wait before playing the sound again. |
| sprint_speed_modifier | Decimal | 1.0 | Modifier for sprint speed. 1.0 means keep the regular speed, while higher numbers make the sprint speed faster. |
| target_blocks | List | List of block types this mob avoids. | |
| target_selection_method | String | nearest | Block search method. |
| tick_interval | Integer | 1 | Should start tick interval. |
| walk_speed_modifier | Decimal | 1.0 | Modifier for walking speed. 1.0 means keep the regular speed, while higher numbers make the walking speed faster. |
Allows the entity to run away from other entities that meet the criteria specified.
| Name | Type | Default Value | Description |
|---|---|---|---|
| avoid_mob_sound | String | The sound event to play when the mob is avoiding another mob. | |
| avoid_target_xz | Integer | 16 | The next target position the entity chooses to avoid another entity will be chosen within this XZ Distance. |
| avoid_target_y | Integer | 7 | The next target position the entity chooses to avoid another entity will be chosen within this Y Distance. |
| entity_types | Minecraft Filter | The list of conditions another entity must meet to be a valid target to avoid. | |
| ignore_visibilty | Boolean | false | Whether or not to ignore direct line of sight while this entity is running away from other specified entities. |
| max_dist | Decimal | 3.0 | Maximum distance to look for an avoid target for the entity. |
| max_flee | Decimal | 10.0 | How many blocks away from its avoid target the entity must be for it to stop fleeing from the avoid target. |
| on_escape_event | Trigger | Event that is triggered when escaping from a mob. | |
| probability_per_strength | Decimal | 1.0 | Percent chance this entity will stop avoiding another entity based on that entity's strength, where 1.0 = 100%. |
| remove_target | Boolean | false | Determine if we should remove target when fleeing or not. |
| sound_interval | Range [a, b] | [3.0, 8.0] | The range of time in seconds to randomly wait before playing the sound again. |
| sprint_distance | Decimal | 7.0 | How many blocks within range of its avoid target the entity must be for it to begin sprinting away from the avoid target. |
| sprint_speed_multiplier | Decimal | 1.0 | Multiplier for sprint speed. 1.0 means keep the regular speed, while higher numbers make the sprint speed faster. |
| walk_speed_multiplier | Decimal | 1.0 | Multiplier for walking speed. 1.0 means keep the regular speed, while higher numbers make the walking speed faster. |
Enables the mob to barter for items that have been configured as barter currency. Must be used in combination with the barter component
Allows this mob to look at and follow the player that holds food they like.
| Name | Type | Default Value | Description |
|---|---|---|---|
| items | List | List of items that this mob likes | |
| look_distance | Decimal | 8.0 | Distance in blocks the mob will beg from |
| look_time | Range [a, b] | [2, 4] | The range of time in seconds this mob will stare at the player holding a food they like, begging for it |
Allows this mob to break doors.
Allows this mob to breed with other mobs.
| Name | Type | Default Value | Description |
|---|---|---|---|
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows this entity to celebrate surviving a raid by making celebration sounds and jumping.
| Name | Type | Default Value | Description |
|---|---|---|---|
| celebration_sound | String | The sound event to trigger during the celebration. | |
| duration | Decimal | 30.000000 | The duration in seconds that the celebration lasts for. |
| jump_interval | Range [a, b] | [1, 3.5] | Minimum and maximum time between jumping (positive, in seconds). |
| on_celebration_end_event | Trigger | The event to trigger when the goal's duration expires. | |
| sound_interval | Range [a, b] | [2, 7] | Minimum and maximum time between sound events (positive, in seconds). |
Allows this entity to celebrate surviving a raid by shooting fireworks.
| Name | Type | Default Value | Description |
|---|---|---|---|
| duration | Decimal | 30.000000 | The duration in seconds that the celebration lasts for. |
| fireworks_interval | Range [a, b] | [10, 20] | Minimum and maximum time between firework (positive, in seconds). |
| on_celebration_end_event | Trigger | The event to trigger when the goal's duration expires. |
Allows this entity to damage a target by using a running attack.
| Name | Type | Default Value | Description |
|---|---|---|---|
| max_distance | Decimal | 3 | A charge attack cannot start if the entity is farther than this distance to the target. |
| min_distance | Decimal | 2 | A charge attack cannot start if the entity is closer than this distance to the target. |
| speed_multiplier | Decimal | 1 | Modifies the entity's speed when charging toward the target. |
| success_rate | Decimal | 0.1428 | Percent chance this entity will start a charge attack, if not already attacking (1.0 = 100%) |
Allows an entity to charge and use their held item.
| Name | Type | Default Value | Description |
|---|---|---|---|
| items | Array | NA | The list of items that can be used to charge the held item. This list is required and must have at least one item in it. |
Causes an entity to circle around an anchor point placed near a point or target.
| Name | Type | Default Value | Description |
|---|---|---|---|
| angle_change | Decimal | 15.0 | Number of degrees to change this entity's facing by, when the entity selects its next anchor point. |
| goal_radius | Decimal | 0.5 | Maximum distance from the anchor-point in which this entity considers itself to have reached the anchor point. This is to prevent the entity from bouncing back and forth trying to reach a specific spot. |
| height_above_target_range | Range [a, b] | [ 0.0, 0.0 ] | The number of blocks above the target that the next anchor point can be set. This value is used only when the entity is tracking a target. |
| height_adjustment_chance | Decimal | 0.002857 | Percent chance to determine how often to increase or decrease the current height around the anchor point. 1 = 100%. "height_change_chance" is deprecated and has been replaced with "height_adjustment_chance". |
| height_offset_range | Range [a, b] | [ 0.0, 0.0 ] | Vertical distance from the anchor point this entity must stay within, upon a successful height adjustment. |
| radius_adjustment_chance | Decimal | 0.004 | Percent chance to determine how often to increase the size of the current movement radius around the anchor point. 1 = 100%. "radius_change_chance" is deprecated and has been replaced with "radius_adjustment_chance". |
| radius_change | Decimal | 1.0 | The number of blocks to increase the current movement radius by, upon successful "radius_adjustment_chance". If the current radius increases over the range maximum, the current radius will be set back to the range minimum and the entity will change between clockwise and counter-clockwise movement.. |
| radius_range | Range [a, b] | [ 5.0, 15.0 ] | Horizontal distance from the anchor point this entity must stay within upon a successful radius adjustment. |
| speed_multiplier | Decimal | 1.0 | Multiplies the speed at which this entity travels to its next desired position. |
Allows the entity to be controlled by the player using an item in the item_controllable property (required). Also requires the minecraft:movement property, and the minecraft:rideable property. On every tick, the entity will attempt to rotate towards where the player is facing with the control item whilst simultaneously moving forward.
| Name | Type | Default Value | Description |
|---|---|---|---|
| fractional_rotation | Decimal | 0.5 | The entity will attempt to rotate to face where the player is facing each tick. The entity will target this percentage of their difference in their current facing angles each tick (from 0.0 to 1.0 where 1.0 = 100%). This is limited by FractionalRotationLimit. A value of 0.0 will result in the entity no longer turning to where the player is facing. |
| fractional_rotation_limit | Decimal | 5.0 | Limits the total degrees the entity can rotate to face where the player is facing on each tick. |
| mount_speed_multiplier | Decimal | 1.0 | Speed multiplier of mount when controlled by player. |
Allows the entity to croak at a random time interval with configurable conditions.
| Name | Type | Default Value | Description |
|---|---|---|---|
| duration | Range [a, b] | [4.5, 4.5] | Random range in seconds after which the croaking stops. Can also be a constant. |
| filters | Minecraft Filter | Conditions for the behavior to start and keep running. The interval between runs only starts after passing the filters. | |
| interval | Range [a, b] | [10, 20] | Random range in seconds between runs of this behavior. Can also be a constant. |
Allows the mob to target another mob that hurts an entity it trusts.
| Name | Type | Default Value | Description | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| aggro_sound | String | Sound to occasionally play while defending. | |||||||||||||||||||||||||||||||||||||
| attack_interval | Integer | 0 | Time in seconds between attacks | ||||||||||||||||||||||||||||||||||||
| entity_types | JSON Object | List of entity types that this mob considers valid targets
|
|||||||||||||||||||||||||||||||||||||
| must_see | Boolean | false | If true, only entities in this mob's viewing range can be selected as targets | ||||||||||||||||||||||||||||||||||||
| must_see_forget_duration | Decimal | 3.0 | Determines the amount of time in seconds that this mob will look for a target before forgetting about it and looking for a new one when the target isn't visible any more | ||||||||||||||||||||||||||||||||||||
| within_radius | Decimal | 0.0 | Distance in blocks that the target can be within to launch an attack |
Allows the entity to stay in a village and defend the village from aggressors. If a player is in bad standing with the village this goal will cause the entity to attack the player regardless of filter conditions.
| Name | Type | Default Value | Description |
|---|---|---|---|
| attack_chance | Decimal | 0.05 | The percentage chance that the entity has to attack aggressors of its village, where 1.0 = 100%. |
Allows an entity to attack, while also delaying the damage-dealt until a specific time in the attack animation.
| Name | Type | Default Value | Description |
|---|---|---|---|
| attack_duration | Decimal | 0.75 | The entity's attack animation will play out over this duration (in seconds). Also controls attack cooldown. |
| attack_once | Boolean | false | Allows the entity to use this attack behavior, only once EVER. |
| attack_types | String | N/A | Defines the entity types this entity will attack. |
| can_spread_on_fire | Boolean | false | If the entity is on fire, this allows the entity's target to catch on fire after being hit. |
| hit_delay_pct | Decimal | 0.5 | The percentage into the attack animation to apply the damage of the attack (1.0 = 100%). |
| inner_boundary_time_increase | Decimal | 0.25 | Time (in seconds) to add to attack path recalculation when the target is beyond the "path_inner_boundary". |
| max_dist | Decimal | N/A | Unused. No effect on "minecraft:behavior.melee_attack". |
| max_path_time | Decimal | 0.55 | Maximum base time (in seconds) to recalculate new attack path to target (before increases applied). |
| melee_fov | Decimal | 90 | Field of view (in degrees) when using the sensing component to detect an attack target. |
| min_path_time | Decimal | 0.2 | Minimum base time (in seconds) to recalculate new attack path to target (before increases applied). |
| on_attack | Trigger | N/A | Defines the event to trigger when this entity successfully attacks. |
| outer_boundary_time_increase | Decimal | 0.5 | Time (in seconds) to add to attack path recalculation when the target is beyond the "path_outer_boundary". |
| path_fail_time_increase | Decimal | 0.75 | Time (in seconds) to add to attack path recalculation when this entity cannot move along the current path. |
| path_inner_boundary | Decimal | 16 | Distance at which to increase attack path recalculation by "inner_boundary_tick_increase". |
| path_outer_boundary | Decimal | 32 | Distance at which to increase attack path recalculation by "outer_boundary_tick_increase". |
| random_stop_interval | Integer | 0 | This entity will have a 1 in N chance to stop it's current attack, where N = "random_stop_interval". |
| reach_multiplier | Decimal | 1.5 | Used with the base size of the entity to determine minimum target-distance before trying to deal attack damage. |
| require_complete_path | Boolean | false | Toggles (on/off) the need to have a full path from the entity to the target when using this melee attack behavior. |
| set_persistent | Boolean | false | Allows the actor to be set to persist upon targeting a player |
| speed_multiplier | Decimal | 1 | This multiplier modifies the attacking entity's speed when moving toward the target. |
| target_dist | Decimal | N/a | Unused. No effect on "minecraft:behavior.melee_attack". |
| track_target | Boolean | true | Allows the entity to track the attack target, even if the entity has no sensing. |
| x_max_rotation | Decimal | 30 | Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target. |
| y_max_head_rotation | Decimal | 30 | Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target. |
Allows this entity to dig into the ground before despawning.
| Name | Type | Default Value | Description |
|---|---|---|---|
| allow_dig_when_named | Boolean | false | If true, this behavior can run when this entity is named. Otherwise not. |
| digs_in_daylight | Boolean | false | Indicates that the actor should start digging when it sees daylight |
| duration | Decimal | 0.0 | Goal duration in seconds |
| idle_time | Decimal | The minimum idle time in seconds between the last detected disturbance to the start of digging. | |
| on_start | Trigger | Event(s) to run when the goal starts. | |
| suspicion_is_disturbance | Boolean | false | If true, finding new suspicious locations count as disturbances that may delay the start of this goal. |
| vibration_is_disturbance | Boolean | false | If true, vibrations count as disturbances that may delay the start of this goal. |
Allows the mob to open and close doors.
Allows this entity to attack a player by charging at them. The player is chosen by the "minecraft:behavior.dragonscanning". Can only be used by the Ender Dragon.
| Name | Type | Default Value | Description |
|---|---|---|---|
| active_speed | Decimal | 3 | The speed this entity moves when this behavior has started or while it's active. |
| continue_charge_threshold_time | Decimal | 0.5 | If the dragon is outside the "target_zone" for longer than "continue_charge_threshold_time" seconds, the charge is canceled. |
| flight_speed | Decimal | 0.6 | The speed this entity moves while this behavior is not active. |
| target_zone | Range [a, b] | [10, 150] | Minimum and maximum distance, from the target, this entity can use this behavior. |
| turn_speed | Decimal | 0.7 | The speed at which this entity turns while using this behavior. |
Allows the dragon to go out with glory. This controls the Ender Dragon's death animation and can't be used by other mobs.
Allows this entity to use a flame-breath attack. Can only be used by the Ender Dragon.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_time | Decimal | 10 | Time (in seconds), after roar, to breath flame. |
| flame_time | Decimal | 0.5 | Time (in seconds), after roar, to breath flame. |
| ground_flame_count | Integer | 4 | Number of ground flame-breath attacks to use before flight-takeoff. |
| roar_time | Decimal | 2 | Time (in seconds) to roar, before breathing flame. |
Allows the Dragon to fly around in a circle around the center podium. Can only be used by the Ender Dragon.
Allows the Dragon to stop flying and transition into perching mode. Can only be used by the Ender Dragon.
Allows the dragon to look around for a player to attack while in perch mode. Can only be used by the Ender Dragon.
Allows this entity to fly around looking for a player to shoot fireballs at. Can only be used by the Ender Dragon.
| Name | Type | Default Value | Description |
|---|---|---|---|
| active_speed | Decimal | 0.6 | The speed this entity moves when this behavior has started or while it's active. |
| fireball_range | Decimal | 64 | Maximum distance of this entity's fireball attack while strafing. |
| flight_speed | Decimal | 0.6 | The speed this entity moves while this behavior is not active. |
| switch_direction_probability | Decimal | 0.125 | Percent chance to to switch this entity's strafe direction between clockwise and counterclockwise. Switch direction chance occurs each time a new target is chosen (1.0 = 100%). |
| target_in_range_and_in_view_time | Decimal | 0.25 | Time (in seconds) the target must be in fireball range, and in view [ie, no solid terrain in-between the target and this entity], before a fireball can be shot. |
| target_zone | Range [a, b] | [10, 150] | Minimum and maximum distance, from the target, this entity can use this behavior. |
| turn_speed | Decimal | 0.7 | The speed at which this entity turns while using this behavior. |
| view_angle | Decimal | 10 | The target must be within "view_angle" degrees of the dragon's current rotation before a fireball can be shot. |
Allows the dragon to leave perch mode and go back to flying around. Can only be used by the Ender Dragon.
Allows the mob to drink milk based on specified environment conditions.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_seconds | Decimal | 5.00 | Time (in seconds) that the goal is on cooldown before it can be used again. |
| filters | Minecraft Filter | Conditions that need to be met for the behavior to start. |
Allows the mob to drink potions based on specified environment conditions.
| Name | Type | Default Value | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| potions | List | A list of potions that this entity can drink. Each potion entry has the following parameters:
|
|||||||||||||||||
| speed_modifier | Decimal | 0.0 | The movement speed modifier to apply to the entity while it is drinking a potion. A value of 0 represents no change in speed. |
Allows the entity to move toward a target, and drop an item near the target. This goal requires a "minecraft:navigation" to execute.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown | Decimal | 0.2 | Total time that the goal is on cooldown before it can be used again. |
| drop_item_chance | Decimal | 1.0 | The percent chance the entity will drop an item when using this goal. |
| entity_types | Minecraft Filter | The list of conditions another entity must meet to be a valid target to drop an item for. | |
| goal_radius | Decimal | 0.50 | Distance in blocks within the entity considers it has reached it's target position. |
| loot_table | String | The loot table that contains the possible loot the entity can drop with this goal. | |
| max_head_look_at_height | Decimal | 10.0 | The maximum height the entities head will look at when dropping the item. The entity will always be looking at its target. |
| minimum_teleport_distance | Decimal | 2.0 | If the target position is farther away than this distance on any tick, the entity will teleport to the target position. |
| offering_distance | Decimal | 1.0 | The preferred distance the entity tries to be from the target it is dropping an item for. |
| on_drop_attempt | Trigger | The event to trigger when the entity attempts to drop an item. | |
| search_count | Integer | 0 | The number of blocks each tick that the entity will check within its search range and height for a valid block to move to. A value of 0 will have the mob check every block within range in one tick. |
| search_height | Integer | 1 | The Height in blocks the entity will search within to find a valid target position. |
| search_range | Integer | 0 | The distance in blocks the entity will search within to find a valid target position. |
| seconds_before_pickup | Decimal | 0.0 | The numbers of seconds that will pass before the dropped entity can be picked up from the ground. |
| speed_multiplier | Decimal | 1.00 | Movement speed multiplier of the entity when using this Goal. |
| target_range | Vector [a, b, c] | [1, 1, 1] | The range in blocks within which the entity searches to find a target to drop an item for. |
| teleport_offset | Vector [a, b, c] | [0, 1, 0] | When the entity teleports, offset the teleport position by this many blocks in the X, Y, and Z coordinate. |
| time_of_day_range | Range [a, b] | [0, 1] | The valid times of day that this goal can be used. For reference: noon is 0.0, sunset is 0.25, midnight is 0.5, and sunrise is 0.75, and back to noon for 1.0. |
Allows the entity to consume a block, replace the eaten block with another block, and trigger an event as a result.
| Name | Type | Default Value | Description |
|---|---|---|---|
| eat_and_replace_block_pairs | List | N/A | A collection of pairs of blocks; the first ("eat_block")is the block the entity should eat, the second ("replace_block") is the block that should replace the eaten block. |
| on_eat | Trigger | N/A | The event to trigger when the block eating animation has completed. |
| success_chance | Molang | 0.02 | A molang expression defining the success chance the entity has to consume a block. |
| time_until_eat | Decimal | 1.8 | The amount of time (in seconds) it takes for the block to be eaten upon a successful eat attempt. |
If the mob is carrying a food item, the mob will eat it and the effects will be applied to the mob.
| Name | Type | Default Value | Description |
|---|---|---|---|
| delay_before_eating | Decimal | Time in seconds the mob should wait before eating the item. |
Allows the entity to eat a specified Mob.
| Name | Type | Default Value | Description |
|---|---|---|---|
| eat_animation_time | Decimal | 1.000000 | Sets the time in seconds the eat animation should play for. |
| eat_mob_sound | String | Sets the sound that should play when eating a mob. | |
| loot_table | String | The loot table for loot to be dropped when eating a mob. | |
| pull_in_force | Decimal | 1.000000 | Sets the force which the mob-to-be-eaten is pulled towards the eating mob. |
| reach_mob_distance | Decimal | 1.000000 | Sets the desired distance to be reached before eating the mob. |
| run_speed | Decimal | 1.000000 | Sets the entity's speed when running toward the target. |
Allows this entity to emerge from the ground
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_time | Integer | 0.50 | Time in seconds the mob has to wait before using the goal again |
| duration | Decimal | 5.00 | Goal duration in seconds |
| on_done | Trigger | Trigger to be executed when the goal execution is about to end |
Allows the enderman to drop a block they are carrying. Can only be used by Endermen.
Allows the enderman to take a block and carry it around. Can only be used by Endermen.
The entity puts on the desired equipment.
Allows the entity to first travel to a random point on the outskirts of the village, and then explore random points within a small distance. This goal requires "minecraft:dweller" and "minecraft:navigation" to execute.
| Name | Type | Default Value | Description |
|---|---|---|---|
| dist_from_boundary | Vector [a, b, c] | [5, 0, 5] | The distance from the boundary the villager must be within in to explore the outskirts. |
| explore_dist | Decimal | 5.00 | Total distance in blocks the the entity will explore beyond the village bounds when choosing its travel point. |
| max_travel_time | Decimal | 60.0 | This is the maximum amount of time an entity will attempt to reach it's travel point on the outskirts of the village before the goal exits. |
| max_wait_time | Decimal | 0.0 | The wait time in seconds between choosing new explore points will be chosen on a random interval between this value and the minimum wait time. This value is also the total amount of time the entity will explore random points before the goal stops. |
| min_dist_from_target | Decimal | 2.2 | The entity must be within this distance for it to consider it has successfully reached its target. |
| min_perimeter | Decimal | 1.0 | The minimum perimeter of the village required to run this goal. |
| min_wait_time | Decimal | 3.0 | The wait time in seconds between choosing new explore points will be chosen on a random interval between this value and the maximum wait time. |
| next_xz | Integer | 5 | A new explore point will randomly be chosen within this XZ distance of the current target position when navigation has finished and the wait timer has elapsed. |
| next_y | Integer | 3 | A new explore point will randomly be chosen within this Y distance of the current target position when navigation has finished and the wait timer has elapsed. |
| speed_multiplier | Decimal | 1.0 | The multiplier for speed while using this goal. 1.0 maintains the speed. |
| timer_ratio | Decimal | 2.0 | Each new explore point will be chosen on a random interval between the minimum and the maximum wait time, divided by this value. This does not apply to the first explore point chosen when the goal runs. |
Allows the mob to search within an area for a growable crop block. If found, the mob will use any available fertilizer in their inventory on the crop. This goal will not execute if the mob does not have a fertilizer item in its inventory.
| Name | Type | Default Value | Description |
|---|---|---|---|
| goal_radius | Decimal | 1.50 | Distance in blocks within the mob considers it has reached it's target position. |
| max_fertilizer_usage | Integer | 1 | The maximum number of times the mob will use fertilzer on the target block. |
| search_cooldown_max_seconds | Decimal | 8.0 | The maximum amount of time in seconds that the goal can take before searching again. The time is chosen between 0 and this number. |
| search_count | Integer | 9 | The number of randomly selected blocks each tick that the mob will check within its search range and height for a valid block to move to. A value of 0 will have the mob check every block within range in one tick. |
| search_height | Integer | 1 | The Height in blocks the mob will search within to find a valid target position. |
| search_range | Integer | 1 | The distance in blocks the mob will search within to find a valid target position. |
| speed_multiplier | Decimal | 0.50 | Movement speed multiplier of the mob when using this Goal. |
Allows the mob to seek shade.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_time | Decimal | 0.0 | Time in seconds the mob has to wait before using the goal again |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows the mob to look around for another mob to ride atop it.
| Name | Type | Default Value | Description |
|---|---|---|---|
| avoid_water | Boolean | false | If true, the mob will not go into water blocks when going towards a mount |
| mount_distance | Decimal | -1.0 | This is the distance the mob needs to be, in blocks, from the desired mount to mount it. If the value is below 0, the mob will use its default attack distance |
| start_delay | Integer | 0 | Time the mob will wait before starting to move towards the mount |
| target_needed | Boolean | false | If true, the mob will only look for a mount if it has a target |
| within_radius | Decimal | 0.0 | Distance in blocks within which the mob will look for a mount |
Allows the mob to move towards the nearest underwater ruin or shipwreck.
| Name | Type | Default Value | Description |
|---|---|---|---|
| search_range | Integer | 0 | The range that the mob will search for a treasure chest within a ruin or shipwreck to move towards. |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
| stop_distance | Decimal | 2.0 | The distance the mob will move before stopping. |
Allows the mob to run away from direct sunlight and seek shade.
| Name | Type | Default Value | Description |
|---|---|---|---|
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows the mob to stay afloat while swimming. Passengers will be kicked out the moment the mob's head goes underwater, which may not happen for tall mobs.
| Name | Type | Default Value | Description |
|---|---|---|---|
| sink_with_passengers | Boolean | false | If true, the mob will keep sinking as long as it has passengers. |
Allows the mob to float around like the Ghast.
| Name | Type | Default Value | Description |
|---|---|---|---|
| float_duration | Range [a, b] | [0.0, 0.0] | Range of time in seconds the mob will float around before landing and choosing to do something else |
| must_reach | Boolean | false | If true, the point has to be reachable to be a valid target |
| random_reselect | Boolean | false | If true, the mob will randomly pick a new point while moving to the previously selected one |
| xz_dist | Integer | 10 | Distance in blocks on ground that the mob will look for a new spot to move to. Must be at least 1 |
| y_dist | Integer | 7 | Distance in blocks that the mob will look up or down for a new spot to move to. Must be at least 1 |
| y_offset | Decimal | 0.0 | Height in blocks to add to the selected target position |
Allows the mob to follow mobs that are in a caravan.
| Name | Type | Default Value | Description | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| entity_count | Integer | 1 | Number of entities that can be in the caravan | ||||||||||||||||||||||||||||||||||||
| entity_types | JSON Object | List of entity types that this mob can follow in a caravan
|
|||||||||||||||||||||||||||||||||||||
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows the mob to follow other mobs.
| Name | Type | Default Value | Description |
|---|---|---|---|
| search_range | Integer | 0 | The distance in blocks it will look for a mob to follow |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
| stop_distance | Decimal | 2.0 | The distance in blocks this mob stops from the mob it is following |
Allows the mob to follow the player that owns them.
| Name | Type | Default Value | Description |
|---|---|---|---|
| can_teleport | Boolean | true | Specify if the mob can teleport to the player if it is too far away |
| ignore_vibration | Boolean | true | Specify if the mob will follow the owner if it has heard a vibration lately |
| max_distance | Decimal | 60.0 | The maximum distance in blocks this mob can be from its owner to start following, only used when canTeleport is false |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
| start_distance | Decimal | 10.0 | The distance in blocks that the owner can be away from this mob before it starts following it |
| stop_distance | Decimal | 2.0 | The distance in blocks this mob will stop from its owner while following it |
Allows the mob to follow their parent around.
| Name | Type | Default Value | Description |
|---|---|---|---|
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows mob to move towards its current target captain.
| Name | Type | Default Value | Description |
|---|---|---|---|
| follow_distance | Decimal | 0.0 | Defines the distance in blocks the mob will stay from its target while following. |
| within_radius | Decimal | 0.0 | Defines the maximum distance in blocks a mob can get from its target captain before giving up trying to follow it. |
The entity will attempt to toss the items from its inventory to a nearby recently played noteblock.
| Name | Type | Default Value | Description |
|---|---|---|---|
| listen_time | Integer | 0.000000 | Sets the time an entity should continue delivering items to a noteblock after hearing it. |
| on_item_throw | Trigger | Event(s) to run when this mob throws items. | |
| reach_block_distance | Decimal | 3.000000 | Sets the desired distance to be reached before throwing the items towards the block. |
| run_speed | Decimal | 1.000000 | Sets the entity's speed when running toward the block. |
| throw_force | Decimal | 0.200000 | Sets the throw force. |
| throw_sound | String | Sound to play when this mob throws an item. | |
| vertical_throw_mul | Decimal | 1.500000 | Sets the vertical throw multiplier that is applied on top of the throw force in the vertical direction. |
The entity will attempt to toss the items from its inventory to its owner.
| Name | Type | Default Value | Description |
|---|---|---|---|
| on_item_throw | Trigger | Event(s) to run when this mob throws items. | |
| reach_mob_distance | Decimal | 3.000000 | Sets the desired distance to be reached before giving items to owner. |
| run_speed | Decimal | 1.000000 | Sets the entity's speed when running toward the owner. |
| throw_force | Decimal | 0.200000 | Sets the throw force. |
| throw_sound | String | item_thrown | Sound to play when this mob throws an item. |
| vertical_throw_mul | Decimal | 1.500000 | Sets the vertical throw multiplier that is applied on top of the throw force in the vertical direction. |
Allows the mob to move back to the position they were spawned.
| Name | Type | Default Value | Description |
|---|---|---|---|
| calculate_new_path_radius | Decimal | 2.00 | Distance in blocks that the mob is considered close enough to the end of the current path. A new path will then be calculated to continue toward home. |
| goal_radius | Decimal | 0.50 | Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot. |
| interval | Integer | 120 | A random value to determine when to randomly move somewhere. This has a 1/interval chance to choose this goal. |
| on_failed | Trigger | Event(s) to run when this goal fails. | |
| on_home | Trigger | Event(s) to run when this mob gets home. | |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal. |
Allows this entity to use a laser beam attack. Can only be used by Guardians and Elder Guardians.
| Name | Type | Default Value | Description |
|---|---|---|---|
| elder_extra_magic_damage | Integer | 2 | Amount of additional damage dealt from an elder guardian's magic attack. |
| hard_mode_extra_magic_damage | Integer | 2 | In hard difficulty, amount of additional damage dealt from a guardian's magic attack. |
| magic_damage | Integer | 1 | Amount of damage dealt from a guardian's magic attack. Magic attack damage is added to the guardian's base attack damage. |
| min_distance | Decimal | 3 | Guardian attack behavior stops if the target is closer than this distance (doesn't apply to elders). |
| sound_delay_time | Decimal | 0.5 | Time (in seconds) to wait after starting an attack before playing the guardian attack sound. |
| x_max_rotation | Decimal | 90 | Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target. |
| y_max_head_rotation | Decimal | 90 | Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target. |
Allows the entity to search within an area for farmland with air above it. If found, the entity will replace the air block by planting a seed item from its inventory on the farmland block. This goal requires "minecraft:inventory" and "minecraft:navigation" to execute. This goal will not execute if the entity does not have an item in its inventory.
| Name | Type | Default Value | Description |
|---|---|---|---|
| goal_radius | Decimal | 1.50 | Distance in blocks within the entity considers it has reached it's target position. |
| max_seconds_before_search | Decimal | 1.0 | The maximum amount of time in seconds that the goal can take before searching for the first harvest block. The time is chosen between 0 and this number. |
| search_cooldown_max_seconds | Decimal | 8.0 | The maximum amount of time in seconds that the goal can take before searching again, after failing to find a a harvest block already. The time is chosen between 0 and this number. |
| search_count | Integer | 0 | The number of randomly selected blocks each tick that the entity will check within its search range and height for a valid block to move to. A value of 0 will have the mob check every block within range in one tick. |
| search_height | Integer | 1 | The Height in blocks the entity will search within to find a valid target position. |
| search_range | Integer | 16 | The distance in blocks the entity will search within to find a valid target position. |
| seconds_until_new_task | Decimal | 0.5 | The amount of time in seconds that the goal will cooldown after a successful reap/sow, before it can start again. |
| speed_multiplier | Decimal | 0.50 | Movement speed multiplier of the entity when using this Goal. |
Allows a mob with the hide component to attempt to move to - and hide at - an owned or nearby POI.
| Name | Type | Default Value | Description |
|---|---|---|---|
| duration | Decimal | 1.0 | Amount of time in seconds that the mob reacts. |
| poi_type | String | Defines what POI type to hide at. | |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
| timeout_cooldown | Decimal | 8.0 | The cooldown time in seconds before the goal can be reused after a internal failure or timeout condition. |
The mob freezes and looks at the mob they are targeting.
| Name | Type | Default Value | Description |
|---|---|---|---|
| broadcast | Boolean | false | Whether to broadcast out the mob's target to other mobs of the same type. |
| broadcast_range | Decimal | 0.0f | Range in blocks for how far to broadcast. |
| min_radius | Decimal | 10.0f | Minimum distance the target must be for the mob to run this goal. |
| within_radius_event | String | Event to run when target is within the radius. This event is broadcasted if broadcast is true. |
Allows the mob to target another mob that hurts them.
| Name | Type | Default Value | Description | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| alert_same_type | Boolean | false | If true, nearby mobs of the same type will be alerted about the damage | ||||||||||||||||||||||||||||||||||||
| entity_types | JSON Object | List of entity types that this mob can target when hurt by them
|
|||||||||||||||||||||||||||||||||||||
| hurt_owner | Boolean | false | If true, the mob will hurt its owner and other mobs with the same owner as itself |
Allows the mob to inspect bookshelves.
| Name | Type | Default Value | Description |
|---|---|---|---|
| goal_radius | Decimal | 0.5 | Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot |
| search_count | Integer | 10 | The number of blocks each tick that the mob will check within its search range and height for a valid block to move to. A value of 0 will have the mob check every block within range in one tick |
| search_height | Integer | 1 | The height that the mob will search for bookshelves |
| search_range | Integer | 0 | Distance in blocks the mob will look for books to inspect |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows this entity to move towards a "suspicious" position based on data gathered in minecraft:suspect_tracking
| Name | Type | Default Value | Description |
|---|---|---|---|
| goal_radius | Decimal | 1.5 | Distance in blocks within the entity considers it has reached it's target position. |
| speed_multiplier | Decimal | 1 | Movement speed multiplier |
Allows an entity to jump to another random block.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_range | Range [a, b] | [10, 20] | Minimum and maximum cooldown time-range (positive, in seconds) between each attempted jump. |
| forbidden_blocks | Array | Blocks that the mob can't jump to. | |
| max_velocity | Decimal | 1.500000 | The maximum velocity with which the mob can jump. |
| minimum_distance | Integer | 2 | The minimum distance (in blocks) from the mob to a block, in order to consider jumping to it. |
| minimum_path_length | Integer | 5 | The minimum length (in blocks) of the mobs path to a block, in order to consider jumping to it. |
| preferred_blocks | Array | Blocks that the mob prefers jumping to. | |
| preferred_blocks_chance | Decimal | 1.000000 | Chance (between 0.0 and 1.0) that the mob will jump to a preferred block, if in range. Only matters if preferred blocks are defined. |
| scale_factor | Decimal | 0.700000 | The scalefactor of the bounding box of the mob while it is jumping. |
| search_height | Integer | 10 | The height (in blocks, in range [2, 15]) of the search box, centered around the mob. |
| search_width | Integer | 8 | The width (in blocks, in range [2, 15]) of the search box, centered around the mob. |
Allows the mob to perform a damaging knockback that affects all nearby entities.
| Name | Type | Default Value | Description |
|---|---|---|---|
| attack_time | Decimal | 0.5 | The delay after which the knockback occurs (in seconds). |
| cooldown_time | Decimal | 0.10 | Time (in seconds) the mob has to wait before using the goal again. |
| damage_filters | Minecraft Filter | The list of conditions another entity must meet to be a valid target to apply damage to. | |
| duration | Decimal | 1.0 | The max duration of the roar (in seconds). |
| knockback_damage | Integer | 6 | The damage dealt by the knockback roar. |
| knockback_filters | Minecraft Filter | The list of conditions another entity must meet to be a valid target to apply knockback to. | |
| knockback_height_cap | Decimal | 0.40 | The maximum height for vertical knockback. |
| knockback_horizontal_strength | Integer | 4 | The strength of the horizontal knockback. |
| knockback_range | Integer | 4 | The radius (in blocks) of the knockback effect. |
| knockback_vertical_strength | Integer | 4 | The strength of the vertical knockback. |
| on_roar_end | Trigger | Event that is triggered when the roar ends. |
Allows mobs to lay down at times
| Name | Type | Default Value | Description |
|---|---|---|---|
| interval | Integer | 120 | A random value to determine at what intervals something can occur. This has a 1/interval chance to choose this goal |
| random_stop_interval | Integer | 120 | a random value in which the goal can use to pull out of the behavior. This is a 1/interval chance to play the sound |
Allows the mob to lay an egg block on certain types of blocks if the mob is pregnant.
| Name | Type | Default Value | Description |
|---|---|---|---|
| allow_laying_from_below | Boolean | false | Allows the mob to lay its eggs from below the target if it can't get there. This is useful if the target block is water with air above, since mobs may not be able to get to the air block above water. |
| egg_type | String | minecraft:turtle_egg | Block type for the egg to lay. If this is a turtle egg, the number of eggs in the block is randomly set. |
| goal_radius | Decimal | 0.5 | Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot |
| lay_egg_sound | String | lay_egg | Name of the sound event played when laying the egg. Defaults to lay_egg, which is used for Turtles. |
| lay_seconds | Decimal | 10.0f | Duration of the laying egg process in seconds. |
| on_lay | Trigger | Event to run when this mob lays the egg. | |
| search_height | Integer | 1 | Height in blocks the mob will look for a target block to move towards |
| search_range | Integer | 0 | The distance in blocks it will look for a target block to move towards |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
| target_blocks | Array | [ minecraft:sand ] | Blocks that the mob can lay its eggs on top of. |
| target_materials_above_block | Array | [ Air ] | Types of materials that can exist above the target block. Valid types are Air, Water, and Lava. |
| use_default_animation | Boolean | true | Specifies if the default lay-egg animation should be played when the egg is placed or not. |
Allows monsters to jump at and attack their target. Can only be used by hostile mobs.
| Name | Type | Default Value | Description |
|---|---|---|---|
| must_be_on_ground | Boolean | true | If true, the mob will only jump at its target if its on the ground. Setting it to false will allow it to jump even if its already in the air |
| set_persistent | Boolean | false | Allows the actor to be set to persist upon targeting a player |
| yd | Decimal | 0.0 | The height in blocks the mob jumps when leaping at its target |
Allows the mob to look at nearby entities.
| Name | Type | Default Value | Description |
|---|---|---|---|
| angle_of_view_horizontal | Integer | 360 | The angle in degrees that the mob can see in the Y-axis (up-down). |
| angle_of_view_vertical | Integer | 360 | The angle in degrees that the mob can see in the X-axis (left-right). |
| filters | Minecraft Filter | Filter to determine the conditions for this mob to look at the entity | |
| look_distance | Decimal | 8.0 | The distance in blocks from which the entity will look at the nearest entity. |
| look_time | Range [a, b] | [2, 4] | Time range to look at the nearest entity. |
| probability | Decimal | 0.02 | The probability of looking at the target. A value of 1.00 is 100%. |
Allows the mob to look at the player when the player is nearby.
| Name | Type | Default Value | Description |
|---|---|---|---|
| angle_of_view_horizontal | Integer | 360 | The angle in degrees that the mob can see in the Y-axis (up-down). |
| angle_of_view_vertical | Integer | 360 | The angle in degrees that the mob can see in the X-axis (left-right). |
| look_distance | Decimal | 8.0 | The distance in blocks from which the entity will look at the nearest player. |
| look_time | Range [a, b] | [2, 4] | Time range to look at the nearest player. |
| probability | Decimal | 0.02 | The probability of looking at the target. A value of 1.00 is 100%. |
Allows the mob to look at the entity they are targetting.
| Name | Type | Default Value | Description |
|---|---|---|---|
| angle_of_view_horizontal | Integer | 360 | The angle in degrees that the mob can see in the Y-axis (up-down). |
| angle_of_view_vertical | Integer | 360 | The angle in degrees that the mob can see in the X-axis (left-right). |
| look_distance | Decimal | 8.0 | The distance in blocks from which the entity will look at this mob's current target. |
| look_time | Range [a, b] | [2, 4] | Time range to look at this mob's current target. |
| probability | Decimal | 0.02 | The probability of looking at the target. A value of 1.00 is 100%. |
Allows the mob to look at the player they are trading with.
| Name | Type | Default Value | Description |
|---|---|---|---|
| angle_of_view_horizontal | Integer | 360 | The angle in degrees that the mob can see in the Y-axis (up-down). |
| angle_of_view_vertical | Integer | 360 | The angle in degrees that the mob can see in the X-axis (left-right). |
| look_distance | Decimal | 8.0 | The distance in blocks from which the entity will look at the player this mob is trading with. |
| look_time | Range [a, b] | [2, 4] | Time range to look at the player this mob is trading with. |
| probability | Decimal | 0.02 | The probability of looking at the target. A value of 1.00 is 100%. |
Allows the villager to look for a mate to spawn other villagers with. Can only be used by Villagers.
Allows an entity to deal damage through a melee attack.
| Name | Type | Default Value | Description |
|---|---|---|---|
| attack_once | Boolean | false | Allows the entity to use this attack behavior, only once EVER. |
| attack_types | String | N/A | Defines the entity types this entity will attack. |
| can_spread_on_fire | Boolean | false | If the entity is on fire, this allows the entity's target to catch on fire after being hit. |
| cooldown_time | Decimal | 1 | Cooldown time (in seconds) between attacks. |
| inner_boundary_time_increase | Decimal | 0.25 | Time (in seconds) to add to attack path recalculation when the target is beyond the "path_inner_boundary". |
| max_dist | Decimal | N/A | Unused. No effect on "minecraft:behavior.melee_attack". |
| max_path_time | Decimal | 0.55 | Maximum base time (in seconds) to recalculate new attack path to target (before increases applied). |
| melee_fov | Decimal | 90 | Field of view (in degrees) when using the sensing component to detect an attack target. |
| min_path_time | Decimal | 0.2 | Minimum base time (in seconds) to recalculate new attack path to target (before increases applied). |
| on_attack | Trigger | N/A | Defines the event to trigger when this entity successfully attacks. |
| outer_boundary_time_increase | Decimal | 0.5 | Time (in seconds) to add to attack path recalculation when the target is beyond the "path_outer_boundary". |
| path_fail_time_increase | Decimal | 0.75 | Time (in seconds) to add to attack path recalculation when this entity cannot move along the current path. |
| path_inner_boundary | Decimal | 16 | Distance at which to increase attack path recalculation by "inner_boundary_tick_increase". |
| path_outer_boundary | Decimal | 32 | Distance at which to increase attack path recalculation by "outer_boundary_tick_increase". |
| random_stop_interval | Integer | 0 | This entity will have a 1 in N chance to stop it's current attack, where N = "random_stop_interval". |
| reach_multiplier | Decimal | 2 | Used with the base size of the entity to determine minimum target-distance before trying to deal attack damage. |
| require_complete_path | Boolean | false | Toggles (on/off) the need to have a full path from the entity to the target when using this melee attack behavior. |
| set_persistent | Boolean | false | Allows the actor to be set to persist upon targeting a player |
| speed_multiplier | Decimal | 1 | This multiplier modifies the attacking entity's speed when moving toward the target. |
| target_dist | Decimal | N/a | Unused. No effect on "minecraft:behavior.melee_attack". |
| track_target | Boolean | false | Allows the entity to track the attack target, even if the entity has no sensing. |
| x_max_rotation | Decimal | 30 | Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target. |
| y_max_head_rotation | Decimal | 30 | Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target. |
Allows an entity to deal damage through a melee attack with reach calculations based on bounding boxes.
| Name | Type | Default Value | Description |
|---|---|---|---|
| attack_once | Boolean | false | Allows the entity to use this attack behavior, only once EVER. |
| attack_types | String | N/A | Defines the entity types this entity will attack. |
| can_spread_on_fire | Boolean | false | If the entity is on fire, this allows the entity's target to catch on fire after being hit. |
| cooldown_time | Decimal | 1 | Cooldown time (in seconds) between attacks. |
| horizontal_reach | Decimal | 0.8 | The attack reach of the mob will be a box with the size of the mobs bounds increased by this value in all horizontal directions. |
| inner_boundary_time_increase | Decimal | 0.25 | Time (in seconds) to add to attack path recalculation when the target is beyond the "path_inner_boundary". |
| max_dist | Decimal | N/A | Unused. No effect on "minecraft:behavior.melee_attack". |
| max_path_time | Decimal | 0.55 | Maximum base time (in seconds) to recalculate new attack path to target (before increases applied). |
| melee_fov | Decimal | 90 | Field of view (in degrees) when using the sensing component to detect an attack target. |
| min_path_time | Decimal | 0.2 | Minimum base time (in seconds) to recalculate new attack path to target (before increases applied). |
| on_attack | Trigger | N/A | Defines the event to trigger when this entity successfully attacks. |
| outer_boundary_time_increase | Decimal | 0.5 | Time (in seconds) to add to attack path recalculation when the target is beyond the "path_outer_boundary". |
| path_fail_time_increase | Decimal | 0.75 | Time (in seconds) to add to attack path recalculation when this entity cannot move along the current path. |
| path_inner_boundary | Decimal | 16 | Distance at which to increase attack path recalculation by "inner_boundary_tick_increase". |
| path_outer_boundary | Decimal | 32 | Distance at which to increase attack path recalculation by "outer_boundary_tick_increase". |
| random_stop_interval | Integer | 0 | This entity will have a 1 in N chance to stop it's current attack, where N = "random_stop_interval". |
| require_complete_path | Boolean | false | Toggles (on/off) the need to have a full path from the entity to the target when using this melee attack behavior. |
| set_persistent | Boolean | false | Allows the actor to be set to persist upon targeting a player |
| speed_multiplier | Decimal | 1 | This multiplier modifies the attacking entity's speed when moving toward the target. |
| target_dist | Decimal | N/a | Unused. No effect on "minecraft:behavior.melee_attack". |
| track_target | Boolean | false | Allows the entity to track the attack target, even if the entity has no sensing. |
| x_max_rotation | Decimal | 30 | Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target. |
| y_max_head_rotation | Decimal | 30 | Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target. |
Allows an entity to go to the village bell and mingle with other entities
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_time | Decimal | 0.0 | Time in seconds the mob has to wait before using the goal again |
| duration | Decimal | 1.0 | Amount of time in seconds that the entity will chat with another entity |
| mingle_distance | Decimal | 2.0f | The distance from its partner that this entity will mingle. If the entity type is not the same as the entity, this value needs to be identical on both entities. |
| mingle_partner_type | List | empty | The entity type that this entity is allowed to mingle with |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows the mob to move around on its own while mounted seeking a target to attack.
| Name | Type | Default Value | Description |
|---|---|---|---|
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
| target_dist | Decimal | 0.0 | The distance at which this mob wants to be away from its target |
| track_target | Boolean | false | If true, this mob will chase after the target as long as it's a valid target |
Allows this entity to move indoors.
| Name | Type | Default Value | Description |
|---|---|---|---|
| speed_multiplier | Decimal | 0.800000 | The movement speed modifier to apply to the entity while it is moving indoors. |
| timeout_cooldown | Decimal | 8.000000 | The cooldown time in seconds before the goal can be reused after pathfinding fails |
Allows this entity to move outdoors.
| Name | Type | Default Value | Description |
|---|---|---|---|
| goal_radius | Decimal | 0.500000 | The radius away from the target block to count as reaching the goal. |
| search_count | Integer | 0.000000 | The amount of times to try finding a random outdoors position before failing. |
| search_height | Integer | 0.000000 | The y range to search for an outdoors position for. |
| search_range | Integer | 0.000000 | The x and z range to search for an outdoors position for. |
| speed_multiplier | Decimal | 0.500000 | The movement speed modifier to apply to the entity while it is moving outdoors. |
| timeout_cooldown | Decimal | 8.000000 | The cooldown time in seconds before the goal can be reused after pathfinding fails |
Can only be used by Villagers. Allows the villagers to create paths around the village.
| Name | Type | Default Value | Description |
|---|---|---|---|
| only_at_night | Boolean | false | If true, the mob will only move through the village during night time |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows mob to move towards a block.
| Name | Type | Default Value | Description |
|---|---|---|---|
| goal_radius | Decimal | 0.5 | Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot |
| on_reach | Trigger | Event to run on block reached. | |
| on_stay_completed | Trigger | Event to run on completing a stay of stay_duration at the block. | |
| search_height | Integer | 1 | The height in blocks that the mob will look for the block. |
| search_range | Integer | 0 | The distance in blocks that the mob will look for the block. |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
| start_chance | Decimal | 1.0 | Chance to start the behavior (applied after each random tick_interval). |
| stay_duration | Decimal | 0.0 | Number of ticks needed to complete a stay at the block. |
| target_blocks | List | Block types to move to. | |
| target_offset | Vector [a, b, c] | [0, 0, 0] | Offset to add to the selected target position. |
| target_selection_method | String | nearest | Kind of block to find fitting the specification. Valid values are "random" and "nearest". |
| tick_interval | Integer | 20 | Average interval in ticks to try to run this behavior. |
Allows the mob to move back onto land when in water.
| Name | Type | Default Value | Description |
|---|---|---|---|
| goal_radius | Decimal | 0.5 | Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot |
| search_count | Integer | 10 | The number of blocks each tick that the mob will check within its search range and height for a valid block to move to. A value of 0 will have the mob check every block within range in one tick |
| search_height | Integer | 1 | Height in blocks the mob will look for land to move towards |
| search_range | Integer | 0 | The distance in blocks it will look for land to move towards |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows the mob to move back into lava when on land.
| Name | Type | Default Value | Description |
|---|---|---|---|
| goal_radius | Decimal | 0.5 | Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot |
| search_count | Integer | 10 | The number of blocks each tick that the mob will check within its search range and height for a valid block to move to. A value of 0 will have the mob check every block within range in one tick |
| search_height | Integer | 1 | Height in blocks the mob will look for lava to move towards |
| search_range | Integer | 0 | The distance in blocks it will look for lava to move towards |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows the mob to move into a liquid when on land.
| Name | Type | Default Value | Description |
|---|---|---|---|
| goal_radius | Decimal | 0.5 | Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot |
| material_type | String | Any | The material type of the liquid block to find. Valid values are "Any", "Water", and "Lava". |
| search_count | Integer | 10 | The number of blocks each tick that the mob will check within its search range and height for a valid block to move to. A value of 0 will have the mob check every block within range in one tick |
| search_height | Integer | 1 | Height in blocks the mob will look for the liquid block to move towards |
| search_range | Integer | 0 | The distance in blocks it will look for the liquid block to move towards |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows the mob to move to a POI if able to
| Name | Type | Default Value | Description |
|---|---|---|---|
| poi_type | String | Tells the goal what POI type it should be looking for | |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows mob to move towards a random block.
| Name | Type | Default Value | Description |
|---|---|---|---|
| block_distance | Decimal | 16.0 | Defines the distance from the mob, in blocks, that the block to move to will be chosen. |
| within_radius | Decimal | 0.0 | Defines the distance in blocks the mob has to be from the block for the movement to be finished. |
Allows the mob to move into a random location within a village.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_time | Decimal | 0.0 | Time in seconds the mob has to wait before using the goal again |
| goal_radius | Decimal | 0.5 | Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot |
| search_range | Integer | 0 | The distance in blocks to search for villages. If <= 0, find the closest village regardless of distance. |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows the mob to move back into water when on land.
| Name | Type | Default Value | Description |
|---|---|---|---|
| goal_radius | Decimal | 0.5 | Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot |
| search_count | Integer | 10 | The number of blocks each tick that the mob will check within its search range and height for a valid block to move to. A value of 0 will have the mob check every block within range in one tick |
| search_height | Integer | 1 | Height in blocks the mob will look for water to move towards |
| search_range | Integer | 0 | The distance in blocks it will look for water to move towards |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows mobs with the dweller component to move toward their Village area that the mob should be restricted to.
| Name | Type | Default Value | Description |
|---|---|---|---|
| speed_multiplier | Decimal | 1.0 | This multiplier modifies the entity's speed when moving towards it's restriction. |
Allows mobs with the home component to move toward their pre-defined area that the mob should be restricted to.
| Name | Type | Default Value | Description |
|---|---|---|---|
| speed_multiplier | Decimal | 1.0 | This multiplier modifies the entity's speed when moving towards it's restriction. |
Allows mob to move towards its current target.
| Name | Type | Default Value | Description |
|---|---|---|---|
| within_radius | Decimal | 0.0 | Defines the radius in blocks that the mob tries to be from the target. A value of 0 means it tries to occupy the same block as the target |
Allows mobs to occassionally stop and take a nap under certain conditions.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_max | Decimal | 0.0 | Maximum time in seconds the mob has to wait before using the goal again |
| cooldown_min | Decimal | 0.0 | Minimum time in seconds the mob has to wait before using the goal again |
| mob_detect_dist | Decimal | 6.0 | The block distance in x and z that will be checked for mobs that this mob detects |
| mob_detect_height | Decimal | 6.0 | The block distance in y that will be checked for mobs that this mob detects |
Allows an entity to attack the closest target within a given subset of specific target types.
| Name | Type | Default Value | Description | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| attack_interval | Integer | 0 | Time range (in seconds) between searching for an attack target, range is in (0, "attack_interval"]. Only used if "attack_interval" is greater than 0, otherwise "scan_interval" is used. | ||||||||||||||||||||||||
| attack_interval_min | Integer | 0 | Alias for "attack_interval"; provides the same functionality as "attack_interval". | ||||||||||||||||||||||||
| attack_owner | Boolean | false | If true, this entity can attack its owner. | ||||||||||||||||||||||||
| entity_types | JSON Object | Filters which types of targets are valid for this entity.
|
|||||||||||||||||||||||||
| must_reach | Boolean | false | If true, this entity requires a path to the target. | ||||||||||||||||||||||||
| must_see | Boolean | false | Determines if target-validity requires this entity to be in range only, or both in range and in sight. | ||||||||||||||||||||||||
| must_see_forget_duration | Decimal | 3.0 | Time (in seconds) the target must not be seen by this entity to become invalid. Used only if "must_see" is true. | ||||||||||||||||||||||||
| persist_time | Decimal | 0.0 | Time (in seconds) this entity can continue attacking the target after the target is no longer valid. | ||||||||||||||||||||||||
| reselect_targets | Boolean | false | Allows the attacking entity to update the nearest target, otherwise a target is only reselected after each "scan_interval" or "attack_interval". | ||||||||||||||||||||||||
| scan_interval | Integer | 10 | If "attack_interval" is 0 or isn't declared, then between attacks: scanning for a new target occurs every amount of ticks equal to "scan_interval", minimum value is 1. Values under 10 can affect performance. | ||||||||||||||||||||||||
| set_persistent | Boolean | false | Allows the actor to be set to persist upon targeting a player | ||||||||||||||||||||||||
| target_invisible_multiplier | Decimal | 0.70 | Multiplied with the target's armor coverage percentage to modify "max_dist" when detecting an invisible target. | ||||||||||||||||||||||||
| target_search_height | Decimal | -1.00 | Maximum vertical target-search distance, if it's greater than the target type's "max_dist". A negative value defaults to "entity_types" greatest "max_dist". | ||||||||||||||||||||||||
| target_sneak_visibility_multiplier | Decimal | 0.80 | Multiplied with the target type's "max_dist" when trying to detect a sneaking target. | ||||||||||||||||||||||||
| within_radius | Decimal | 0.0 | Maximum distance this entity can be from the target when following it, otherwise the target becomes invalid. This value is only used if the entity doesn't declare "minecraft:follow_range". |
Allows the mob to check for and pursue the nearest valid target.
| Name | Type | Default Value | Description | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| attack_interval | Integer | 0 | Time in seconds before selecting a target | ||||||||||||||||||||||||||||||||||||
| cooldown | Decimal | 0.0 | The amount of time in seconds that the mob has to wait before selecting a target of the same type again | ||||||||||||||||||||||||||||||||||||
| entity_types | JSON Object | List of entity types that this mob considers valid targets
|
|||||||||||||||||||||||||||||||||||||
| must_reach | Boolean | false | If true, only entities that this mob can path to can be selected as targets | ||||||||||||||||||||||||||||||||||||
| must_see | Boolean | false | If true, only entities in this mob's viewing range can be selected as targets | ||||||||||||||||||||||||||||||||||||
| must_see_forget_duration | Decimal | 3.0 | Determines the amount of time in seconds that this mob will look for a target before forgetting about it and looking for a new one when the target isn't visible any more | ||||||||||||||||||||||||||||||||||||
| persist_time | Decimal | 0.0f | Time in seconds for a valid target to stay targeted when it becomes and invalid target. | ||||||||||||||||||||||||||||||||||||
| priority | Integer | 0 | Specifies the priority in which filtered enemy types should be attacked. Lower number means higher priority. | ||||||||||||||||||||||||||||||||||||
| reselect_targets | Boolean | false | If true, the target will change to the current closest entity whenever a different entity is closer | ||||||||||||||||||||||||||||||||||||
| scan_interval | Integer | 10 | How many ticks to wait between scanning for a target. | ||||||||||||||||||||||||||||||||||||
| set_persistent | Boolean | false | Allows the actor to be set to persist upon targeting a player | ||||||||||||||||||||||||||||||||||||
| target_search_height | Decimal | -1.0f | Height in blocks to search for a target mob. -1.0f means the height does not matter. | ||||||||||||||||||||||||||||||||||||
| within_radius | Decimal | 0.0 | Distance in blocks that the target can be within to launch an attack |
Allows to mob to be able to sit in place like the ocelot.
| Name | Type | Default Value | Description |
|---|---|---|---|
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows an entity to attack by sneaking and pouncing.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_time | Decimal | 1 | Time (in seconds) between attacks. |
| max_distance | Decimal | 15 | Max distance from the target, this entity will use this attack behavior. |
| max_sneak_range | Decimal | 15 | Max distance from the target, this entity starts sneaking. |
| max_sprint_range | Decimal | 4 | Max distance from the target, this entity starts sprinting (sprinting takes priority over sneaking). |
| reach_multiplier | Decimal | 2 | Used with the base size of the entity to determine minimum target-distance before trying to deal attack damage. |
| sneak_speed_multiplier | Decimal | 0.6 | Modifies the attacking entity's movement speed while sneaking. |
| sprint_speed_multiplier | Decimal | 1.33 | Modifies the attacking entity's movement speed while sprinting. |
| walk_speed_multiplier | Decimal | 0.8 | Modifies the attacking entity's movement speed when not sneaking or sprinting, but still within attack range. |
| x_max_rotation | Decimal | 30 | Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target. |
| y_max_head_rotation | Decimal | 30 | Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target. |
Allows the mob to offer a flower to another mob with the minecraft:take_flower behavior.
| Name | Type | Default Value | Description |
|---|---|---|---|
| chance_to_start | Decimal | 0.00 | Percent chance that the mob will start this goal from 0.0 to 1.0 (where 1.0 = 100%). |
| filters | Minecraft Filter | Conditions that need to be met for the behavior to start. | |
| max_head_rotation_y | Decimal | 30 | Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target. |
| max_offer_flower_duration | Decimal | 20.00 | The max amount of time (in seconds) that the mob will offer the flower for before exiting the Goal. |
| max_rotation_x | Decimal | 30 | Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target. |
| search_area | Vector [a, b, c] | [6, 2, 6] | The dimensions of the AABB used to search for a potential mob to offer flower to. |
Allows the mob to open doors. Requires the mob to be able to path through doors, otherwise the mob won't even want to try opening them.
| Name | Type | Default Value | Description |
|---|---|---|---|
| close_door_after | Boolean | true | If true, the mob will close the door after opening it and going through it |
Allows the mob to target another mob that hurts their owner.
| Name | Type | Default Value | Description | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| entity_types | JSON Object | List of entity types that this mob can target if they hurt their owner
|
Allows the mob to target a mob that is hurt by their owner.
| Name | Type | Default Value | Description | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| entity_types | JSON Object | List of entity types that this entity can target if the potential target is hurt by this mob's owner
|
Allows the mob to enter the panic state, which makes it run around and away from the damage source that made it enter this state.
| Name | Type | Default Value | Description |
|---|---|---|---|
| damage_sources | List | [campfire, entity_attack, entity_explosion, fire, fire_tick, fireworks, freezing, lava, lightning, magic, magma, projectile, ram_attack, sonic_boom, soul_campfire, temperature, wither] | The list of Entity Damage Sources that will cause this mob to panic |
| force | Boolean | false | If true, this mob will not stop panicking until it can't move anymore or the goal is removed from it |
| ignore_mob_damage | Boolean | false | If true, the mob will not panic in response to damage from other mobs. This overrides the damage types in "damage_sources" |
| prefer_water | Boolean | false | If true, the mob will prefer water over land |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows the mob to peek out. This is what the shulker uses to look out of its shell.
Allows the pet mob to move onto a bed with its owner while sleeping.
| Name | Type | Default Value | Description |
|---|---|---|---|
| goal_radius | Decimal | 0.5 | Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot |
| search_height | Integer | 1 | Height in blocks from the owner the pet can be to sleep with owner. |
| search_range | Integer | 0 | The distance in blocks from the owner the pet can be to sleep with owner. |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows the mob to pick up items on the ground.
| Name | Type | Default Value | Description |
|---|---|---|---|
| can_pickup_any_item | Boolean | false | If true, the mob can pickup any item |
| can_pickup_to_hand_or_equipment | Boolean | true | If true, the mob can pickup items to its hand or armor slots |
| excluded_items | List | List of items this mob will not pick up | |
| goal_radius | Decimal | 0.5 | Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot |
| max_dist | Decimal | 0.0 | Maximum distance this mob will look for items to pick up |
| pickup_based_on_chance | Boolean | false | If true, depending on the difficulty, there is a random chance that the mob may not be able to pickup items |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
| track_target | Boolean | false | If true, this mob will chase after the target as long as it's a valid target |
Allows the mob to play with other mobs by chasing each other and moving around randomly.
| Name | Type | Default Value | Description |
|---|---|---|---|
| chance_to_start | Decimal | 0.00 | Percent chance that the mob will start this goal, from 0 to 1. |
| follow_distance | Integer | 2 | The distance (in blocks) that the mob tries to be in range of the friend it's following. |
| friend_search_area | Vector [a, b, c] | [6, 3, 6] | The dimensions of the AABB used to search for a potential friend to play with. |
| friend_types | Array | The entity type(s) to consider when searching for a potential friend to play with. | |
| max_play_duration_seconds | Decimal | 50.00 | The max amount of seconds that the mob will play for before exiting the Goal. |
| random_pos_search_height | Integer | 3 | The height (in blocks) that the mob will search within to find a random position position to move to. Must be at least 1. |
| random_pos_search_range | Integer | 16 | The distance (in blocks) on ground that the mob will search within to find a random position to move to. Must be at least 1. |
| speed_multiplier | Decimal | 1.00 | Movement speed multiplier of the mob when using this AI Goal. |
Allows this entity to pretend to be dead to avoid being targeted by attackers.
| Name | Type | Default Value | Description |
|---|---|---|---|
| apply_regeneration | Boolean | true | Whether the mob will receive the regeneration effect while playing dead. |
| damage_sources | Array | all | The list of Entity Damage Sources that will cause this mob to play dead. |
| duration | Decimal | 1.000000 | The amount of time the mob will remain playing dead (in seconds). |
| filters | Minecraft Filter | The list of other triggers that are required for the mob to activate play dead | |
| force_below_health | Integer | 0 | The amount of health at which damage will cause the mob to play dead. |
| random_damage_range | Range [a, b] | [0, 0] | The range of damage that may cause the goal to start depending on randomness. Damage taken below the min will never cause the goal to start. Damage taken above the max will always cause the goal to start. |
| random_start_chance | Decimal | 1.000000 | The likelihood of this goal starting upon taking damage. |
Allows the mob to be ridden by the player after being tamed.
Allows the mob to eat/raid crops out of farms until they are full.
| Name | Type | Default Value | Description |
|---|---|---|---|
| blocks | List | Blocks that the mob is looking for to eat/raid | |
| eat_delay | Integer | 2 | Time in seconds between each time it eats/raids |
| full_delay | Integer | 100 | Amount of time in seconds before this mob wants to eat/raid again after eating its maximum |
| goal_radius | Decimal | 0.5 | Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot |
| initial_eat_delay | Integer | 0 | Time in seconds before starting to eat/raid once it arrives at it |
| max_to_eat | Integer | 6 | Maximum number of crops this entity wants to eat/raid. If set to zero or less then it doesn't have a maximum |
| search_range | Integer | 0 | Distance in blocks the mob will look for crops to eat |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows this entity to damage a target by using a running attack.
| Name | Type | Default Value | Description |
|---|---|---|---|
| baby_knockback_modifier | Decimal | 0.333333 | The modifier to knockback that babies have. |
| cooldown_range | Range [a, b] | [10, 20] | Minimum and maximum cooldown time-range (positive, in seconds) between each attempted ram attack. |
| knockback_force | Decimal | 5.000000 | The force of the knockback of the ram attack. |
| knockback_height | Decimal | 0.100000 | The height of the knockback of the ram attack. |
| min_ram_distance | Decimal | 0.000000 | The minimum distance at which the mob can start a ram attack. |
| on_start | Trigger | The event to trigger when attacking | |
| pre_ram_sound | String | The sound to play when an entity is about to perform a ram attack. | |
| ram_distance | Decimal | 0.000000 | The distance at which the mob start to run with ram speed. |
| ram_impact_sound | String | The sound to play when an entity is impacting on a ram attack. | |
| ram_speed | Decimal | 2.000000 | Sets the entity's speed when charging toward the target. |
| run_speed | Decimal | 1.000000 | Sets the entity's speed when running toward the target. |
Allows the mob to randomly break surface of the water.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_time | Decimal | 0.0 | Time in seconds the mob has to wait before using the goal again |
| interval | Integer | 120 | A random value to determine when to randomly move somewhere. This has a 1/interval chance to choose this goal |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
| xz_dist | Integer | 10 | Distance in blocks on ground that the mob will look for a new spot to move to. Must be at least 1 |
| y_dist | Integer | 7 | Distance in blocks that the mob will look up or down for a new spot to move to. Must be at least 1 |
Allows a mob to randomly fly around.
| Name | Type | Default Value | Description |
|---|---|---|---|
| can_land_on_trees | Boolean | true | If true, the mob can stop flying and land on a tree instead of the ground |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
| xz_dist | Integer | 10 | Distance in blocks on ground that the mob will look for a new spot to move to. Must be at least 1 |
| y_dist | Integer | 7 | Distance in blocks that the mob will look up or down for a new spot to move to. Must be at least 1 |
Allows the mob to hover around randomly, close to the surface
| Name | Type | Default Value | Description |
|---|---|---|---|
| hover_height | Range [a, b] | The height above the surface which the mob will try to maintain | |
| interval | Integer | 120 | A random value to determine when to randomly move somewhere. This has a 1/interval chance to choose this goal |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
| xz_dist | Integer | 10 | Distance in blocks on ground that the mob will look for a new spot to move to. Must be at least 1 |
| y_dist | Integer | 7 | Distance in blocks that the mob will look up or down for a new spot to move to. Must be at least 1 |
| y_offset | Decimal | 0.0 | Height in blocks to add to the selected target position |
Allows the mob to randomly look around.
| Name | Type | Default Value | Description |
|---|---|---|---|
| look_time | Range [a, b] | [2, 4] | The range of time in seconds the mob will stay looking in a random direction before looking elsewhere |
| max_angle_of_view_horizontal | Integer | 30 | The rightmost angle a mob can look at on the horizontal plane with respect to its initial facing direction. |
| min_angle_of_view_horizontal | Integer | -30 | The leftmost angle a mob can look at on the horizontal plane with respect to its initial facing direction. |
Allows the mob to randomly sit and look around for a duration. Note: Must have a sitting animation set up to use this.
| Name | Type | Default Value | Description |
|---|---|---|---|
| continue_if_leashed | Boolean | false | If the goal should continue to be used as long as the mob is leashed. |
| continue_sitting_on_reload | Boolean | false | The mob will stay sitting on reload. |
| max_angle_of_view_horizontal | Decimal | 30.0 | The rightmost angle a mob can look at on the horizontal plane with respect to its initial facing direction. |
| max_look_count | Integer | 2 | The max amount of unique looks a mob will have while looking around. |
| max_look_time | Integer | 40 | The max amount of time (in ticks) a mob will stay looking at a direction while looking around. |
| min_angle_of_view_horizontal | Decimal | -30.0 | The leftmost angle a mob can look at on the horizontal plane with respect to its initial facing direction. |
| min_look_count | Integer | 1 | The min amount of unique looks a mob will have while looking around. |
| min_look_time | Integer | 20 | The min amount of time (in ticks) a mob will stay looking at a direction while looking around. |
| probability | Decimal | 0.02 | The probability of randomly looking around/sitting. |
| random_look_around_cooldown | Integer | 0 | The cooldown in seconds before the goal can be used again. |
Allows this entity to locate a random target block that it can path find to. Once found, the entity will move towards it and dig up an item. [Default target block types: Dirt, Grass, Podzol, DirtWithRoots, MossBlock, Mud, MuddyMangroveRoots].
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_range | Range [a, b] | [0.000000, 0.000000] | Goal cooldown range in seconds. |
| digging_duration_range | Range [a, b] | [0.000000, 0.000000] | Digging duration in seconds. |
| find_valid_position_retries | Decimal | 0.000000 | Amount of retries to find a valid target position within search range. |
| goal_radius | Decimal | 1.500000 | Distance in blocks within the entity to considers it has reached it's target position. |
| item_table | String | File path relative to the resource pack root for items to spawn list (loot table format). | |
| on_digging_start | Trigger | Event to run when the goal ends searching has begins digging. | |
| on_fail_during_digging | Trigger | Event to run when the goal failed while in digging state. | |
| on_fail_during_searching | Trigger | Event to run when the goal failed while in searching state. | |
| on_item_found | Trigger | Event to run when the goal find a item. | |
| on_searching_start | Trigger | Event to run when the goal starts searching. | |
| on_success | Trigger | Event to run when searching and digging has ended. | |
| search_range_xz | Decimal | 0.000000 | Width and length of the volume around the entity used to find a valid target position |
| search_range_y | Decimal | 0.000000 | Height of the volume around the entity used to find a valid target position |
| spawn_item_after_seconds | Decimal | 0.000000 | Digging duration before spawning item in seconds. |
| spawn_item_pos_offset | Decimal | 0.000000 | Distance to offset the item's spawn location in the direction the mob is facing. |
| speed_multiplier | Decimal | 1.000000 | Searching movement speed multiplier. |
| target_blocks | List | List of target block types the goal will look to dig on. Overrides the default list. | |
| target_dig_position_offset | Decimal | 2.250000 | Dig target position offset from the feet position of the mob in their facing direction. |
Allows the mob to randomly sit for a duration.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_time | Decimal | 0.0 | Time in seconds the mob has to wait before using the goal again |
| min_sit_time | Decimal | 10 | The minimum amount of time in seconds before the mob can stand back up |
| start_chance | Decimal | 0.1 | This is the chance that the mob will start this goal, from 0 to 1 |
| stop_chance | Decimal | 0.3 | This is the chance that the mob will stop this goal, from 0 to 1 |
Allows a mob to randomly stroll around.
| Name | Type | Default Value | Description |
|---|---|---|---|
| interval | Integer | 120 | A random value to determine when to randomly move somewhere. This has a 1/interval chance to choose this goal |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
| xz_dist | Integer | 10 | Distance in blocks on ground that the mob will look for a new spot to move to. Must be at least 1 |
| y_dist | Integer | 7 | Distance in blocks that the mob will look up or down for a new spot to move to. Must be at least 1 |
Allows an entity to randomly move through water
| Name | Type | Default Value | Description |
|---|---|---|---|
| avoid_surface | Boolean | true | If true, the mob will avoid surface water blocks by swimming below them |
| interval | Integer | 120 | A random value to determine when to randomly move somewhere. This has a 1/interval chance to choose this goal |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
| xz_dist | Integer | 10 | Distance in blocks on ground that the mob will look for a new spot to move to. Must be at least 1 |
| y_dist | Integer | 7 | Distance in blocks that the mob will look up or down for a new spot to move to. Must be at least 1 |
Allows an entity to attack by using ranged shots. "charge_shoot_trigger" must be greater than 0 to enable charged up burst-shot attacks. Requires minecraft:shooter to define projectile behaviour.
| Name | Type | Default Value | Description |
|---|---|---|---|
| attack_interval | Decimal | 0 | Alternative to "attack_interval_min" & "attack_interval_max". Consistent reload-time (in seconds), when not using a charged shot. Does not scale with target-distance. |
| attack_interval_max | Decimal | 0 | Maximum bound for reload-time range (in seconds), when not using a charged shot. Reload-time range scales with target-distance. |
| attack_interval_min | Decimal | 0 | Minimum bound for reload-time range (in seconds), when not using a charged shot. Reload-time range scales with target-distance. |
| attack_radius | Decimal | 0 | Minimum distance to target before this entity will attempt to shoot. |
| attack_radius_min | Decimal | 0 | Minimum distance the target can be for this mob to fire. If the target is closer, this mob will move first before firing |
| burst_interval | Decimal | 0 | Time (in seconds) between each individual shot when firing a burst of shots from a charged up attack. |
| burst_shots | Integer | 1 | Number of shots fired every time the attacking entity uses a charged up attack. |
| charge_charged_trigger | Decimal | 0 | Time (in seconds, then add "charge_shoot_trigger"), before a charged up attack is done charging. Charge-time decays while target is not in sight. |
| charge_shoot_trigger | Decimal | 0 | Amount of time (in seconds, then doubled) a charged shot must be charging before reloading burst shots. Charge-time decays while target is not in sight. |
| ranged_fov | Decimal | 90 | Field of view (in degrees) when using sensing to detect a target for attack. |
| set_persistent | Boolean | false | Allows the actor to be set to persist upon targeting a player |
| speed_multiplier | Decimal | 1 | During attack behavior, this multiplier modifies the entity's speed when moving toward the target. |
| swing | Boolean | false | If a swing animation (using variable.attack_time) exists, this causes the actor to swing their arm(s) upon firing the ranged attack. |
| target_in_sight_time | Decimal | 1 | Minimum amount of time (in seconds) the attacking entity needs to see the target before moving toward it. |
| x_max_rotation | Decimal | 30 | Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target. |
| y_max_head_rotation | Decimal | 30 | Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target. |
Allows the villager to stop so another villager can breed with it. Can only be used by a Villager.
Allows the mob to stay indoors during night time.
Allows the mob to automatically start avoiding the sun when its a clear day out.
Allows the mob to stay at a certain level when in liquid.
| Name | Type | Default Value | Description |
|---|---|---|---|
| liquid_y_offset | Decimal | 0.0 | Target distance down from the liquid surface. i.e. Positive values move the target Y down. |
| rise_delta | Decimal | 0.0 | Movement up in Y per tick when below the liquid surface. |
| sink_delta | Decimal | 0.0 | Movement down in Y per tick when above the liquid surface. |
Allows this entity to roar at another entity based on data in minecraft:anger_level. Once the anger threshold specified in minecraft:anger_level has been reached, this entity will roar for the specified amount of time, look at the other entity, apply anger boost towards it, and finally target it.
| Name | Type | Default Value | Description |
|---|---|---|---|
| duration | Decimal | 0.0 | The amount of time to roar for. |
This allows the mob to roll forward.
| Name | Type | Default Value | Description |
|---|---|---|---|
| probability | Decimal | [1.0] | The probability that the mob will use the goal. |
Allows the mob to run around aimlessly.
| Name | Type | Default Value | Description |
|---|---|---|---|
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows the a mob to become scared when the weather outside is thundering
| Name | Type | Default Value | Description |
|---|---|---|---|
| sound_interval | Integer | 0 | The interval in which a sound will play when active in a 1/delay chance to kick off |
Allows the mob to send an event to another mob.
| Name | Type | Default Value | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| cast_duration | Decimal | Total delay of the steps | Time in seconds for the entire event sending process | ||||||||||||||||
| look_at_target | Boolean | true | If true, the mob will face the entity it sends an event to | ||||||||||||||||
| sequence | List | List of events to send
|
Allows the mob to give items it has to others.
| Name | Type | Default Value | Description | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| entity_types | JSON Object | List of entities this mob will share items with
|
|||||||||||||||||||||||||||||||||||||
| goal_radius | Decimal | 0.5 | Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot | ||||||||||||||||||||||||||||||||||||
| max_dist | Decimal | 0.0 | Maximum distance in blocks this mob will look for entities to share items with | ||||||||||||||||||||||||||||||||||||
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows the mob to go into stone blocks like Silverfish do. Currently it can only be used by Silverfish.
Allows the mob to alert mobs in nearby blocks to come out. Currently it can only be used by Silverfish.
Allows Equine mobs to be Horse Traps and be triggered like them, spawning a lightning bolt and a bunch of horses when a player is nearby. Can only be used by Horses, Mules, Donkeys and Skeleton Horses.
| Name | Type | Default Value | Description |
|---|---|---|---|
| duration | Decimal | 1.0 | Amount of time in seconds the trap exists. After this amount of time is elapsed, the trap is removed from the world if it hasn't been activated |
| within_radius | Decimal | 0.0 | Distance in blocks that the player has to be within to trigger the horse trap |
Allows mobs that own a bed to in a village to move to and sleep in it.
| Name | Type | Default Value | Description |
|---|---|---|---|
| can_sleep_while_riding | Boolean | false | If true, the mob will be able to use the sleep goal if riding something |
| cooldown_time | Decimal | 0.0 | Time in seconds the mob has to wait before using the goal again |
| sleep_collider_height | Decimal | 1.0 | The height of the mob's collider while sleeping |
| sleep_collider_width | Decimal | 1.0 | The width of the mob's collider while sleeping |
| sleep_y_offset | Decimal | 1.0 | The y offset of the mob's collider while sleeping |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
| timeout_cooldown | Decimal | 8.0 | The cooldown time in seconds before the goal can be reused after a internal failure or timeout condition |
Causes the entity to grow tired every once in a while, while attacking.
| Name | Type | Default Value | Description |
|---|---|---|---|
| set_persistent | Boolean | false | Allows the actor to be set to persist upon targeting a player |
| speed_multiplier | Decimal | 1 | During attack behavior, this multiplier modifies the entity's speed when moving toward the target. |
| x_max_rotation | Decimal | 10 | Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target. |
| y_max_rotation | Decimal | 10 | Maximum rotation (in degrees), on the Y-axis, this entity can rotate while trying to look at the target. |
Allow slimes to float in water / lava. Can only be used by Slime and Magma Cubes.
| Name | Type | Default Value | Description |
|---|---|---|---|
| jump_chance_percentage | Decimal | 0.8 | Percent chance a slime or magma cube has to jump while in water / lava. |
| speed_multiplier | Decimal | 1.2 | Determines the multiplier the entity's speed is modified by when moving through water / lava. |
Allows the entity to continuously jump around like a slime.
| Name | Type | Default Value | Description |
|---|---|---|---|
| speed_multiplier | Decimal | 1 | Determines the multiplier this entity's speed is modified by when jumping around. |
Allows the entity to move in random directions like a slime.
| Name | Type | Default Value | Description |
|---|---|---|---|
| add_random_time_range | Integer | 3 | Additional time (in whole seconds), chosen randomly in the range of [0, "add_random_time_range"], to add to "min_change_direction_time". |
| min_change_direction_time | Decimal | 2 | Constant minimum time (in seconds) to wait before choosing a new direction. |
| turn_range | Integer | 360 | Maximum rotation angle range (in degrees) when randomly choosing a new direction. |
Allows the mob to take a load off and snack on food that it found nearby.
| Name | Type | Default Value | Description |
|---|---|---|---|
| items | List | Items that we are interested in snacking on | |
| snacking_cooldown | Decimal | 7.5 | The cooldown time in seconds before the mob is able to snack again |
| snacking_cooldown_min | Decimal | 0.5f | The minimum time in seconds before the mob is able to snack again |
| snacking_stop_chance | Decimal | 0.0017 | This is the chance that the mob will stop snacking, from 0 to 1 |
Allows the mob to stop and sneeze possibly startling nearby mobs and dropping an item.
| Name | Type | Default Value | Description | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| cooldown_time | Decimal | 0.0 | Time in seconds the mob has to wait before using the goal again | ||||||||||||||||||||||||||||||||||||
| drop_item_chance | Decimal | 1.0 | The probability that the mob will drop an item when it sneezes. | ||||||||||||||||||||||||||||||||||||
| entity_types | JSON Object | List of entity types this mob will startle (cause to jump) when it sneezes.
|
|||||||||||||||||||||||||||||||||||||
| loot_table | String | Loot table to select dropped items from. | |||||||||||||||||||||||||||||||||||||
| prepare_sound | String | Sound to play when the sneeze is about to happen. | |||||||||||||||||||||||||||||||||||||
| prepare_time | Decimal | 1.0 | The time in seconds that the mob takes to prepare to sneeze (while the prepare_sound is playing). | ||||||||||||||||||||||||||||||||||||
| probability | Decimal | 0.02 | The probability of sneezing. A value of 1.00 is 100% | ||||||||||||||||||||||||||||||||||||
| sound | String | Sound to play when the sneeze occurs. | |||||||||||||||||||||||||||||||||||||
| within_radius | Decimal | 0.0 | Distance in blocks that mobs will be startled. |
Allows this entity to detect the nearest player within "sniffing_radius" and update its "minecraft:suspect_tracking" component state
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_range | Range [a, b] | [3.0, 10.0] | Cooldown range between sniffs in seconds |
| duration | Decimal | 1.0 | Sniffing duration in seconds |
| sniffing_radius | Decimal | 5.0 | Mob detection radius |
| suspicion_radius_horizontal | Decimal | 3.0 | Mob suspicion horizontal radius. When a player is within this radius horizontally, the anger level towards that player is increased |
| suspicion_radius_vertical | Decimal | 3.0 | Mob suspicion vertical radius. When a player is within this radius vertically, the anger level towards that player is increased |
Allows this entity to perform a 'sonic boom' ranged attack
| Name | Type | Default Value | Description |
|---|---|---|---|
| attack_cooldown | Decimal | 5.00 | Cooldown in seconds required after using this attack until the entity can use sonic boom again. |
| attack_damage | Decimal | 30.00 | Attack damage of the sonic boom. |
| attack_range_horizontal | Decimal | 15.00 | Horizontal range (in blocks) at which the sonic boom can damage the target. |
| attack_range_vertical | Decimal | 20.00 | Vertical range (in blocks) at which the sonic boom can damage the target. |
| attack_sound | String | Sound event for the attack. | |
| charge_sound | String | Sound event for the charge up. | |
| duration | Decimal | 3.00 | Goal duration in seconds |
| duration_until_attack_sound | Decimal | 1.70 | Duration in seconds until the attack sound is played. |
| knockback_height_cap | Decimal | 0.00 | Height cap of the attack knockback's vertical delta. |
| knockback_horizontal_strength | Decimal | 0.00 | Horizontal strength of the attack's knockback applied to the attack target. |
| knockback_vertical_strength | Decimal | 0.00 | Vertical strength of the attack's knockback applied to the attack target. |
| speed_multiplier | Decimal | 1.00 | This multiplier modifies the attacking entity's speed when moving toward the target. |
Allows the squid to dive down in water. Can only be used by the Squid.
Allows the squid to swim away. Can only be used by the Squid.
Allows the squid to swim in place idly. Can only be used by the Squid.
Allows the squid to move away from ground blocks and back to water. Can only be used by the Squid.
Allows the squid to stick to the ground when outside water. Can only be used by the Squid.
Allows a mob to stalk a target, then once within range pounce onto a target, on success the target will be attacked dealing damage defined by the attack component. On failure, the mob will risk getting stuck
| Name | Type | Default Value | Description |
|---|---|---|---|
| interest_time | Decimal | 2.0 | The amount of time the mob will be interested before pouncing. This happens when the mob is within range of pouncing |
| leap_distance | Decimal | 0.8 | The distance in blocks the mob jumps in the direction of its target |
| leap_height | Decimal | 0.9 | The height in blocks the mob jumps when leaping at its target |
| max_stalk_dist | Decimal | 10.0 | The maximum distance away a target can be before the mob gives up on stalking |
| pounce_max_dist | Decimal | 5.0 | The maximum distance away from the target in blocks to begin pouncing at the target |
| set_persistent | Boolean | false | Allows the actor to be set to persist upon targeting a player |
| stalk_speed | Decimal | 1.2 | The movement speed in which you stalk your target |
| strike_dist | Decimal | 2.0 | The max distance away from the target when landing from the pounce that will still result in damaging the target |
| stuck_time | Decimal | 2.0 | The amount of time the mob will be stuck if they fail and land on a block they can be stuck on |
The entity will attempt to toss the items from its inventory to a nearby recently played noteblock.
| Name | Type | Default Value | Description |
|---|---|---|---|
| listen_time | Integer | 0.000000 | Sets the time an entity should stay near a noteblock after hearing it. |
| speed | Decimal | 1.000000 | Sets the entity's speed when moving toward the block. |
| start_distance | Decimal | 10.000000 | Sets the distance the entity needs to be away from the block to attempt to start the goal. |
| stop_distance | Decimal | 2.000000 | Sets the distance from the block the entity will attempt to reach. |
Allows the mob to stay put while it is in a sitting state instead of doing something else.
Allows an entity to attack using stomp AoE damage behavior.
| Name | Type | Default Value | Description |
|---|---|---|---|
| attack_once | Boolean | false | Allows the entity to use this attack behavior, only once EVER. |
| attack_types | String | N/A | Defines the entity types this entity will attack. |
| can_spread_on_fire | Boolean | false | If the entity is on fire, this allows the entity's target to catch on fire after being hit. |
| cooldown_time | Decimal | 1 | Cooldown time (in seconds) between attacks. |
| inner_boundary_time_increase | Decimal | 0.25 | Time (in seconds) to add to attack path recalculation when the target is beyond the "path_inner_boundary". |
| max_dist | Decimal | N/A | Unused. No effect on "minecraft:behavior.melee_attack". |
| max_path_time | Decimal | 0.55 | Maximum base time (in seconds) to recalculate new attack path to target (before increases applied). |
| min_path_time | Decimal | 0.2 | Minimum base time (in seconds) to recalculate new attack path to target (before increases applied). |
| no_damage_range_multiplier | Decimal | 2 | Multiplied with the final AoE damage range to determine a no damage range. The stomp attack will go on cooldown if target is in this no damage range. |
| on_attack | Trigger | N/A | Defines the event to trigger when this entity successfully attacks. |
| outer_boundary_time_increase | Decimal | 0.5 | Time (in seconds) to add to attack path recalculation when the target is beyond the "path_outer_boundary". |
| path_fail_time_increase | Decimal | 0.75 | Time (in seconds) to add to attack path recalculation when this entity cannot move along the current path. |
| path_inner_boundary | Decimal | 16 | Distance at which to increase attack path recalculation by "inner_boundary_tick_increase". |
| path_outer_boundary | Decimal | 32 | Distance at which to increase attack path recalculation by "outer_boundary_tick_increase". |
| random_stop_interval | Integer | 0 | This entity will have a 1 in N chance to stop it's current attack, where N = "random_stop_interval". |
| reach_multiplier | Decimal | 2 | Used with the base size of the entity to determine minimum target-distance before trying to deal attack damage. |
| require_complete_path | Boolean | false | Toggles (on/off) the need to have a full path from the entity to the target when using this melee attack behavior. |
| set_persistent | Boolean | false | Allows the actor to be set to persist upon targeting a player |
| speed_multiplier | Decimal | 1 | This multiplier modifies the attacking entity's speed when moving toward the target. |
| stomp_range_multiplier | Decimal | 2 | Multiplied with the base size of the entity to determine stomp AoE damage range. |
| target_dist | Decimal | N/a | Unused. No effect on "minecraft:behavior.melee_attack". |
| track_target | Boolean | false | Allows the entity to track the attack target, even if the entity has no sensing. |
| x_max_rotation | Decimal | 30 | Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target. |
| y_max_head_rotation | Decimal | 30 | Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target. |
Allows this mob to stomp turtle eggs
| Name | Type | Default Value | Description |
|---|---|---|---|
| goal_radius | Decimal | 0.5 | Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot |
| interval | Integer | 120 | A random value to determine when to randomly move somewhere. This has a 1/interval chance to choose this goal |
| search_height | Integer | 1 | Height in blocks the mob will look for turtle eggs to move towards |
| search_range | Integer | 0 | The distance in blocks it will look for turtle eggs to move towards |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
Allows the mob to move into a random location within a village within the search range.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_time | Decimal | 0.0 | Time in seconds the mob has to wait before using the goal again |
| goal_radius | Decimal | 0.5 | Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot |
| search_range | Integer | 0 | The distance in blocks to search for points inside villages. If <= 0, find the closest village regardless of distance. |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
| start_chance | Decimal | 0.1 | This is the chance that the mob will start this goal, from 0 to 1 |
Allows the mob to attack the player by summoning other entities.
| Name | Type | Default Value | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| summon_choices | List | List of spells for the mob to use to summon entities. Each spell has the following parameters:
|
Allows the creeper to swell up when a player is nearby. It can only be used by Creepers.
| Name | Type | Default Value | Description |
|---|---|---|---|
| start_distance | Decimal | 10.0 | This mob starts swelling when a target is at least this many blocks away |
| stop_distance | Decimal | 2.0 | This mob stops swelling when a target has moved away at least this many blocks |
Allows the entity go idle, if swimming. Entity must be in water.
| Name | Type | Default Value | Description |
|---|---|---|---|
| idle_time | Decimal | 5 | Amount of time (in seconds) to stay idle. |
| success_rate | Decimal | 0.1 | Percent chance this entity will go idle, 1.0 = 100%. |
Allows the entity to wander around while swimming, when not path-finding.
| Name | Type | Default Value | Description |
|---|---|---|---|
| interval | Decimal | 0.00833 | Percent chance to start wandering, when not path-finding. 1 = 100% |
| look_ahead | Decimal | 5 | Distance to look ahead for obstacle avoidance, while wandering. |
| speed_multiplier | Decimal | 1 | This multiplier modifies the entity's speed when wandering. |
| wander_time | Decimal | 5 | Amount of time (in seconds) to wander after wandering behavior was successfully started. |
Allows the entity follow another entity. Both entities must be swimming [ie, in water].
| Name | Type | Default Value | Description |
|---|---|---|---|
| catch_up_multiplier | Decimal | 2.5 | The multiplier this entity's speed is modified by when matching another entity's direction. |
| catch_up_threshold | Decimal | 12 | Distance, from the entity being followed, at which this entity will speed up to reach that entity. |
| chance_to_stop | Decimal | 0.0333 | Percent chance to stop following the current entity, if they're riding another entity or they're not swimming. 1.0 = 100% |
| entity_types | JSON Object | Filters which types of entities are valid to follow. | |
| match_direction_threshold | Decimal | 2 | Distance, from the entity being followed, at which this entity will try to match that entity's direction |
| search_range | Decimal | 20 | Radius around this entity to search for another entity to follow. |
| speed_multiplier | Decimal | 1.5 | The multiplier this entity's speed is modified by when trying to catch up to the entity being followed. |
| state_check_interval | Decimal | 0.5 | Time (in seconds) between checks to determine if this entity should catch up to the entity being followed or match the direction of the entity being followed. |
| stop_distance | Decimal | 5 | Distance, from the entity being followed, at which this entity will stop following that entity. |
| success_rate | Decimal | 0.1 | Percent chance to start following another entity, if not already doing so. 1.0 = 100% |
Allows an entity to attack using swoop attack behavior; Ideal for use with flying mobs. The behavior ends if the entity has a horizontal collision or gets hit.
| Name | Type | Default Value | Description |
|---|---|---|---|
| damage_reach | Decimal | 0.2 | Added to the base size of the entity, to determine the target's maximum allowable distance, when trying to deal attack damage. |
| delay_range | Range [a, b] | [10, 20] | Minimum and maximum cooldown time-range (in seconds) between each attempted swoop attack. |
| speed_multiplier | Decimal | 1 | During swoop attack behavior, this determines the multiplier the entity's speed is modified by when moving toward the target. |
Allows the mob to accept flowers from another mob with the minecraft:offer_flower behavior.
| Name | Type | Default Value | Description |
|---|---|---|---|
| filters | Minecraft Filter | Conditions that need to be met for the behavior to start. | |
| max_head_rotation_y | Decimal | 30 | Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target. |
| max_rotation_x | Decimal | 30 | Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target. |
| max_wait_time | Decimal | 20.00 | The maximum amount of time (in seconds) for the mob to randomly wait for before taking the flower. |
| min_distance_to_target | Decimal | 2.00 | Minimum distance (in blocks) for the entity to be considered having reached its target. |
| min_wait_time | Decimal | 4.00 | The minimum amount of time (in seconds) for the mob to randomly wait for before taking the flower. |
| search_area | Vector [a, b, c] | [6, 2, 6] | The dimensions of the AABB used to search for a potential mob to take a flower from. |
| speed_multiplier | Decimal | 0.50 | Movement speed multiplier of the mob when using this AI Goal. |
Allows the mob to be tempted by food they like.
| Name | Type | Default Value | Description |
|---|---|---|---|
| can_get_scared | Boolean | false | If true, the mob can stop being tempted if the player moves too fast while close to this mob |
| can_tempt_vertically | Boolean | false | If true, vertical distance to the player will be considered when tempting. |
| can_tempt_while_ridden | Boolean | false | If true, the mob can be tempted even if it has a passenger (i.e. if being ridden). |
| items | List | List of items this mob is tempted by | |
| sound_interval | Range [a, b] | [0.0, 0.0] | Range of random ticks to wait between tempt sounds. |
| speed_multiplier | Decimal | 1.0 | Movement speed multiplier of the mob when using this AI Goal |
| tempt_sound | String | Sound to play while the mob is being tempted. | |
| within_radius | Decimal | 0.0 | Distance in blocks this mob can get tempted by a player holding an item they like |
Fires an event when this behavior starts, then waits for a duration before stopping. When stopping due to that timeout or due to being interrupted by another behavior, fires another event. query.timer_flag_1 will return 1.0 on both the client and server when this behavior is running, and 0.0 otherwise.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_range | Range [a, b] | [10.000000, 10.000000] | Goal cooldown range in seconds. If specified, the cooldown will have to elapse even before the goal can be selected for the first time. |
| duration_range | Range [a, b] | [2.000000, 2.000000] | Goal duration range in seconds. |
| on_end | Trigger | Event(s) to run when the goal end. | |
| on_start | Trigger | Event(s) to run when the goal starts. |
Fires an event when this behavior starts, then waits for a duration before stopping. When stopping due to that timeout or due to being interrupted by another behavior, fires another event. query.timer_flag_2 will return 1.0 on both the client and server when this behavior is running, and 0.0 otherwise.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_range | Range [a, b] | [10.000000, 10.000000] | Goal cooldown range in seconds. If specified, the cooldown will have to elapse even before the goal can be selected for the first time. |
| duration_range | Range [a, b] | [2.000000, 2.000000] | Goal duration range in seconds. |
| on_end | Trigger | Event(s) to run when the goal end. | |
| on_start | Trigger | Event(s) to run when the goal starts. |
Fires an event when this behavior starts, then waits for a duration before stopping. When stopping due to that timeout or due to being interrupted by another behavior, fires another event. query.timer_flag_3 will return 1.0 on both the client and server when this behavior is running, and 0.0 otherwise.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_range | Range [a, b] | [10.000000, 10.000000] | Goal cooldown range in seconds. If specified, the cooldown will have to elapse even before the goal can be selected for the first time. |
| duration_range | Range [a, b] | [2.000000, 2.000000] | Goal duration range in seconds. |
| on_end | Trigger | Event(s) to run when the goal end. | |
| on_start | Trigger | Event(s) to run when the goal starts. |
Allows the mob to look at a player that is holding a tradable item.
| Name | Type | Default Value | Description |
|---|---|---|---|
| carried_item_switch_time | Decimal | 2.0 | The max time in seconds that the trader will hold an item before attempting to switch for a different item that takes the same trade |
| cooldown | Decimal | 2.0 | The time in seconds before the trader can use this goal again |
| interest_time | Decimal | 45.0 | The max time in seconds that the trader will be interested with showing its trade items |
| remove_item_time | Decimal | 1.0 | The max time in seconds that the trader will wait when you no longer have items to trade |
| within_radius | Decimal | 0.0 | Distance in blocks this mob can be interested by a player holding an item they like |
Allows the player to trade with this mob. When the goal starts, it will stop the mob's navigation.
| Name | Type | Default Value | Description |
|---|---|---|---|
| filters | Minecraft Filter | Conditions that need to be met for the behavior to start. | |
| max_distance_from_player | Decimal | 8.00 | The max distance that the mob can be from the player before exiting the goal. |
Allows the mob to target the same entity its owner is targeting.
| Name | Type | Default Value | Description | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| entity_types | JSON Object | List of entities this mob can copy the owner from
|
Allows the mob to move around randomly like the Vex.
Allows the wither to launch random attacks. Can only be used by the Wither Boss.
Allows the wither to focus its attacks on whichever mob has dealt the most damage to it.
| Name | Type | Default Value | Description | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| entity_types | JSON Object | List of entity types the wither takes into account to find who dealt the most damage to it
|
Allows the NPC to use the POI
| Name | Type | Default Value | Description |
|---|---|---|---|
| active_time | Integer | 0 | The amount of ticks the NPC will stay in their the work location |
| can_work_in_rain | Boolean | false | If true, this entity can work when their jobsite POI is being rained on. |
| goal_cooldown | Integer | 0 | The amount of ticks the goal will be on cooldown before it can be used again |
| on_arrival | Trigger | Event to run when the mob reaches their jobsite. | |
| sound_delay_max | Integer | 0 | The max interval in which a sound will play. |
| sound_delay_min | Integer | 0 | The min interval in which a sound will play. |
| speed_multiplier | Decimal | 0.50 | Movement speed multiplier of the mob when using this AI Goal |
| work_in_rain_tolerance | Integer | -1 | If "can_work_in_rain" is false, this is the maximum number of ticks left in the goal where rain will not interrupt the goal |
Allows the NPC to use the composter POI to convert excess seeds into bone meal.
| Name | Type | Default Value | Description |
|---|---|---|---|
| active_time | Integer | 0 | The amount of ticks the NPC will stay in their the work location |
| block_interaction_max | Integer | 1 | The maximum number of times the mob will interact with the composter. |
| can_empty_composter | Boolean | true | Determines whether the mob can empty a full composter. |
| can_fill_composter | Boolean | true | Determines whether the mob can add items to a composter given that it is not full. |
| can_work_in_rain | Boolean | false | If true, this entity can work when their jobsite POI is being rained on. |
| goal_cooldown | Integer | 0 | The amount of ticks the goal will be on cooldown before it can be used again |
| items_per_use_max | Integer | 20 | The maximum number of items which can be added to the composter per block interaction. |
| min_item_count | Integer | 10 | Limits the amount of each compostable item the mob can use. Any amount held over this number will be composted if possible |
| on_arrival | Trigger | Event to run when the mob reaches their jobsite. | |
| speed_multiplier | Decimal | 0.50 | Movement speed multiplier of the mob when using this AI Goal |
| use_block_max | Integer | 200 | The maximum interval in which the mob will interact with the composter. |
| use_block_min | Integer | 100 | The minimum interval in which the mob will interact with the composter. |
| work_in_rain_tolerance | Integer | -1 | If "can_work_in_rain" is false, this is the maximum number of ticks left in the goal where rain will not interrupt the goal |
Defines an entity's melee attack and any additional effects on it.
| Name | Type | Default Value | Description |
|---|---|---|---|
| damage | Range [a, b] | Range of the random amount of damage the melee attack deals. A negative value can heal the entity instead of hurting it | |
| effect_duration | Decimal | 0.0 | Duration in seconds of the status ailment applied to the damaged entity |
| effect_name | String | Identifier of the status ailment to apply to an entity attacked by this entity's melee attack |
Defines what mob effects to add and remove to the entity when adding this component.
| Name | Type | Default Value | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| add_effects | List | List of effects to add to this entity after adding this component
|
|||||||||
| remove_effects | String | List of identifiers of effects to be removed from this entity after adding this component |
Defines the entity's strength to carry items.
| Name | Type | Default Value | Description |
|---|---|---|---|
| max | Integer | 5 | The maximum strength of this entity |
| value | Integer | 1 | The initial value of the strength |
| Name | Description |
|---|---|
| minecraft:entity_born | Event called on an entity that is spawned through two entities breeding. |
| minecraft:entity_spawned | Event called on an entity that is placed in the level. |
| minecraft:entity_transformed | Event called on an entity that transforms into another entity. |
| minecraft:on_prime | Event called on an entity whose fuse is lit and is ready to explode. |
Adds a rider to the entity. Requires minecraft:rideable.
| Name | Type | Default Value | Description |
|---|---|---|---|
| entity_type | String | The entity type that will be riding this entity. | |
| spawn_event | String | The spawn event that will be used when the riding entity is created. |
Causes the mob to ignore attackable targets for a given duration.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_after_being_attacked | Integer | 0 | Duration, in seconds, for which mob won't admire items if it was hurt |
| duration | Integer | 10 | Duration, in seconds, that the mob is pacified. |
Adds a timer for the entity to grow up. It can be accelerated by giving the entity the items it likes as defined by feedItems.
| Name | Type | Default Value | Description |
|---|---|---|---|
| drop_items | List | List of items that the entity drops when it grows up. | |
| duration | Decimal | 1200.0 | Amount of time before the entity grows up, -1 for always a baby. |
| feed_items | List | List of items that can be fed to the entity. Includes 'item' for the item name and 'growth' to define how much time it grows up by. | |
| grow_up | String | Event to run when this entity grows up. | |
| interact_filters | Minecraft Filter | List of conditions to meet so that the entity can be fed. | |
| transform_to_item | Item Description Properties | The feed item used will transform to this item upon successful interaction. Format: itemName:auxValue |
Allows this entity to track anger towards a set of nuisances
| Name | Type | Default Value | Description |
|---|---|---|---|
| anger_decrement_interval | Decimal | 1.00 | Anger level will decay over time. Defines how often anger towards all nuisances will be decreased by one |
| angry_boost | Positive Integer | 20 | Anger boost applied to angry threshold when mob gets angry |
| angry_threshold | Positive Integer | 80 | Threshold that define when the mob is considered angry at a nuisance |
| default_annoyingness | String | 0 | The default amount of annoyingness for any given nuisance. Specifies how much to raise anger level on each provocation |
| max_anger | Positive Integer | 100 | The maximum anger level that can be reached. Applies to any nuisance |
| nuisance_filter | Minecraft Filter | Filter that is applied to determine if a mob can be a nuisance | |
| on_increase_sounds | Array | Sounds to play when the entity is getting provoked. Evaluated in order. First matching condition winsconditionA Molang expression describing under which conditions to play this sound, given that the entity was provokedsoundThe sound to play |
|
| remove_targets_below_angry_threshold | Boolean | true | Defines if the mob should remove target if it falls below 'angry' threshold |
Defines the entity's 'angry' state using a timer.
| Name | Type | Default Value | Description |
|---|---|---|---|
| angry_sound | String | The sound event to play when the mob is angry | |
| broadcast_anger | Boolean | false | If true, other entities of the same entity definition within the broadcastRange will also become angry |
| broadcast_anger_on_attack | Boolean | false | If true, other entities of the same entity definition within the broadcastRange will also become angry whenever this mob attacks |
| broadcast_anger_on_being_attacked | Boolean | false | If true, other entities of the same entity definition within the broadcastRange will also become angry whenever this mob is attacked |
| broadcast_filters | Minecraft Filter | Conditions that make this entry in the list valid | |
| broadcast_range | Integer | 20 | Distance in blocks within which other entities of the same entity definition will become angry |
| broadcast_targets | List | A list of entity families to broadcast anger to | |
| calm_event | String | Event to run after the number of seconds specified in duration expires (when the entity stops being 'angry') | |
| duration | Integer | 25 | The amount of time in seconds that the entity will be angry |
| duration_delta | Integer | 0 | Variance in seconds added to the duration [-delta, delta] |
| filters | Minecraft Filter | Filter out mob types that it should not attack while angry (other Piglins) | |
| sound_interval | Range [a, b] | 0 | The range of time in seconds to randomly wait before playing the sound again |
Allows the actor to break doors assuming that that flags set up for the component to use in navigation
| Name | Type | Default Value | Description |
|---|---|---|---|
| break_time | Decimal | 12.0 | The time in seconds required to break through doors. |
| min_difficulty | String | hard | The minimum difficulty that the world must be on for this entity to break doors. |
Allows the actor to open doors assuming that that flags set up for the component to use in navigation
A component that does damage to entities that get within range.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cause | String | The type of damage that is applied to entities that enter the damage range. | |
| damage_cooldown | Decimal | 0 | Attack cooldown (in seconds) for how often this entity can attack a target. |
| damage_per_tick | Integer | 2 | How much damage per tick is applied to entities that enter the damage range. |
| damage_range | Decimal | 0.2 | How close a hostile entity must be to have the damage applied. |
| entity_filter | Minecraft Filter | The set of entities that are valid to apply the damage to when within range. | |
| play_attack_sound | Boolean | 4.94066e-324 | If the entity should play their attack sound when attacking a target. |
Adds a cooldown to a mob. The intention of this cooldown is to be used to prevent the mob from attempting to aquire new attack targets.
| Name | Type | Default Value | Description |
|---|---|---|---|
| attack_cooldown_complete_event | Trigger | Event to be runned when the cooldown is complete. | |
| attack_cooldown_time | Range [a, b] | [0.0, 1.0] | Amount of time in seconds for the cooldown. Can be specified as a number or a pair of numbers (min and max). |
Enables the component to drop an item as a barter exchange.
| Name | Type | Default Value | Description |
|---|---|---|---|
| barter_table | String | Loot table that's used to drop a random item. | |
| cooldown_after_being_attacked | Integer | 0 | Duration, in seconds, for which mob won't barter items if it was hurt |
Allows the player to detect and maneuver on the scaffolding block.
Fires off a specified event when a block in the block list is broken within the sensor range.
| Name | Type | Default Value | Description |
|---|---|---|---|
| on_break | List | List of blocks to watch for being broken to fire off a specified event. If a block is in multiple lists, multiple events will fire. | |
| sensor_radius | Decimal | 16.00 | The maximum radial distance in which a specified block can be detected. The biggest radius is 32.0. |
| sources | List | List of sources that break the block to listen for. If none are specified, all block breaks will be detected. |
Defines the conditions and behavior of a rideable entity's boost.
| Name | Type | Default Value | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| boost_items | List | List of items that can be used to boost while riding this entity. Each item has the following properties:
|
|||||||||||||||||
| duration | Decimal | 3.00 | Time in seconds for the boost. | ||||||||||||||||
| speed_multiplier | Decimal | 1.35 | Factor by which the entity's normal speed increases. E.g. 2.0 means go twice as fast. Requires "format_version" of 1.20 or more, otherwise the value 1.35 will be used. |
The current state of the boss for updating the boss HUD.
| Name | Type | Default Value | Description |
|---|---|---|---|
| hud_range | Integer | 55 | The max distance from the boss at which the boss's health bar is present on the players screen. |
| name | String | The name that will be displayed above the boss's health bar. | |
| should_darken_sky | Boolean | false | Whether the sky should darken in the presence of the boss. |
Specifies the blocks that this entity can break as it moves around.
| Name | Type | Default Value | Description |
|---|---|---|---|
| breakable_blocks | List | A list of the blocks that can be broken as this entity moves around |
Defines what blocks this entity can breathe in and gives them the ability to suffocate.
| Name | Type | Default Value | Description |
|---|---|---|---|
| breathe_blocks | List | List of blocks this entity can breathe in, in addition to the other "breathes" parameters. | |
| breathes_air | Boolean | true | If true, this entity can breathe in air. |
| breathes_lava | Boolean | true | If true, this entity can breathe in lava. |
| breathes_solids | Boolean | false | If true, this entity can breathe in solid blocks. |
| breathes_water | Boolean | false | If true, this entity can breathe in water. |
| generates_bubbles | Boolean | true | If true, this entity will have visible bubbles while in water. |
| inhale_time | Decimal | 0 | Time in seconds to recover breath to maximum. |
| non_breathe_blocks | List | List of blocks this entity can't breathe in, in addition to the other "breathes" parameters. | |
| suffocate_time | Integer | -20 | Time in seconds between suffocation damage. |
| total_supply | Integer | 15 | Time in seconds the entity can hold its breath. |
Defines the way an entity can get into the 'love' state.
| Name | Type | Default Value | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| allow_sitting | Boolean | false | If true, entities can breed while sitting | ||||||||||||||||
| blend_attributes | Boolean | true | If true, the entities will blend their attributes in the offspring after they breed. | ||||||||||||||||
| breed_cooldown | Decimal | 60 | Time in seconds before the Entity can breed again. | ||||||||||||||||
| breed_items | List | The list of items that can be used to get the entity into the 'love' state | |||||||||||||||||
| breeds_with | List | The list of entity definitions that this entity can breed with.
|
|||||||||||||||||
| causes_pregnancy | Boolean | false | If true, the entity will become pregnant instead of spawning a baby. | ||||||||||||||||
| deny_parents_variant | JSON Object | Determines how likely the baby of parents with the same variant will deny that variant and take a random variant within the given range instead.
|
|||||||||||||||||
| environment_requirements | List | The list of nearby block requirements to get the entity into the 'love' state.blocksThe block types required nearby for the entity to breed.countThe number of the required block types nearby for the entity to breed.radiusHow many blocks radius from the mob's center to search in for the required blocks. Bounded between 0 and 16. |
|||||||||||||||||
| extra_baby_chance | Decimal | 0 | Chance that up to 16 babies will spawn between 0.0 and 1.0, where 1.0 is 100%. | ||||||||||||||||
| inherit_tamed | Boolean | true | If true, the babies will be automatically tamed if its parents are | ||||||||||||||||
| love_filters | Minecraft Filter | The filters to run when attempting to fall in love. | |||||||||||||||||
| mutation_factor | JSON Object | Determines how likely the babies are to NOT inherit one of their parent's variances. Values are between 0.0 and 1.0, with a higher number meaning more likely to mutate.
|
|||||||||||||||||
| mutation_strategy | String | none | Strategy used for mutating variants and extra variants for offspring. Current valid alternatives are 'random' and 'none'. | ||||||||||||||||
| parent_centric_attribute_blending | List | [EXPERIMENTAL] List of attributes that should benefit from parent centric attribute blending. For example, horses blend their health, movement, and jump_strength in their offspring. | |||||||||||||||||
| random_extra_variant_mutation_interval | Range [a, b] | 0 | Range used to determine random extra variant. | ||||||||||||||||
| random_variant_mutation_interval | Range [a, b] | 0 | Range used to determine random variant. | ||||||||||||||||
| require_full_health | Boolean | false | If true, the entity needs to be at full health before it can breed. | ||||||||||||||||
| require_tame | Boolean | true | If true, the entities need to be tamed first before they can breed. | ||||||||||||||||
| transform_to_item | String | The breed item used will transform to this item upon successful interaction. Format: itemName:auxValue |
Defines the way an entity can get into the 'bribed' state.
| Name | Type | Default Value | Description |
|---|---|---|---|
| bribe_cooldown | Decimal | 2.0 | Time in seconds before the Entity can be bribed again. |
| bribe_items | List | The list of items that can be used to bribe the entity. |
Enables an entity to float on the specified liquid blocks.
| Name | Type | Default Value | Description |
|---|---|---|---|
| apply_gravity | Boolean | true | Applies gravity each tick. Causes more of a wave simulation, but will cause more gravity to be applied outside liquids. |
| base_buoyancy | Decimal | 1.0 | Base buoyancy used to calculate how much will a mob float. |
| big_wave_probability | Decimal | 0.03 | Probability for a big wave hitting the entity. Only used if `simulate_waves` is true. |
| big_wave_speed | Decimal | 10.0 | Multiplier for the speed to make a big wave. Triggered depending on 'big_wave_probability'. |
| drag_down_on_buoyancy_removed | Decimal | 0.0 | How much an actor will be dragged down when the Buoyancy Component is removed. |
| liquid_blocks | List | List of blocks this entity can float on. Must be a liquid block. | |
| simulate_waves | Boolean | true | Should the movement simulate waves going through. |
Specifies if/how a mob burns in daylight.
Determines that this entity can join an existing raid.
Specifies hunt celebration behaviour.
| Name | Type | Default Value | Description |
|---|---|---|---|
| broadcast | Boolean | true | If true, celebration will be broadcasted to other entities in the radius. |
| celeberation_targets | Minecraft Filter | The list of conditions that target of hunt must satisfy to initiate celebration. | |
| celebrate_sound | String | The sound event to play when the mob is celebrating | |
| duration | Integer | 4 | Duration, in seconds, of celebration |
| radius | Decimal | 16 | If broadcast is enabled, specifies the radius in which it will notify other entities for celebration. |
| sound_interval | Range [a, b] | 0 | The range of time in seconds to randomly wait before playing the sound again |
Sets the width and height of the Entity's collision box.
| Name | Type | Default Value | Description |
|---|---|---|---|
| height | Decimal | 1.0 | Height of the collision box in blocks. A negative value will be assumed to be 0. |
| width | Decimal | 1.0 | Width of the collision box in blocks. A negative value will be assumed to be 0. |
Gives Regeneration I and removes Mining Fatigue from the mob that kills the Actor's attack target.
| Name | Type | Default Value | Description |
|---|---|---|---|
| apply_to_family | Boolean | false | Determines if the mob will grant mobs of the same type combat buffs if they kill the target. |
| apply_to_self | Boolean | false | Determines if the mob will grant itself the combat buffs if it kills the target. |
| regeneration_duration | Integer | 5 | The duration in seconds of Regeneration I added to the mob. |
Defines the Conditional Spatial Update Bandwidth Optimizations of this entity.
| Name | Type | Default Value | Description |
|---|---|---|---|
| conditional_values | List | The object containing the conditional bandwidth optimization values.conditional_valuesConditions that must be met for these optimization values to be used.max_dropped_ticksIn relation to the optimization value, determines the maximum ticks spatial update packets can be not sent.max_optimized_distanceThe maximum distance considered during bandwidth optimizations. Any value below the max is interpolated to find optimization, and any value greater than or equal to this max results in max optimization.use_motion_prediction_hintsWhen set to true, smaller motion packets will be sent during drop packet intervals, resulting in the same amount of packets being sent as without optimizations but with much less data being sent. This should be used when actors are travelling very quickly or teleporting to prevent visual oddities. |
|
| default_values | JSON Object | The object containing the default bandwidth optimization values.max_dropped_ticksIn relation to the optimization value, determines the maximum ticks spatial update packets can be not sent.max_optimized_distanceThe maximum distance considered during bandwidth optimizations. Any value below the max is interpolated to find optimization, and any value greater than or equal to this max results in max optimization.use_motion_prediction_hintsWhen set to true, smaller motion packets will be sent during drop packet intervals, resulting in the same amount of packets being sent as without optimizations but with much less data being sent. This should be used when actors are travelling very quickly or teleporting to prevent visual oddities. |
List of hitboxes for melee and ranged hits against the entity.
| Name | Type | Default Value | Description |
|---|---|---|---|
| hitboxes | Array | Comma seperated list of hitboxes. |
Applies defined amount of damage to the entity at specified intervals.
| Name | Type | Default Value | Description |
|---|---|---|---|
| damage_per_hurt | Integer | 1 | Amount of damage caused each hurt. |
| time_between_hurt | Decimal | 0.0 | Time in seconds between damage. |
Defines what events to call when this entity is damaged by specific entities or items.
| Name | Type | Default Value | Description | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| triggers | List | List of triggers with the events to call when taking specific kinds of damage.
|
Ability for a rideable entity to dash.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_time | Decimal | 1.00 | The dash cooldown in seconds. Default value is 1.000000. |
| horizontal_momentum | Decimal | 1.00 | Horizontal momentum of the dash. |
| vertical_momentum | Decimal | 1.00 | Vertical momentum of the dash. |
Despawns the Actor when the despawn rules or optional filters evaluate to true.
| Name | Type | Default Value | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| despawn_from_chance | Boolean | true | Determines if "min_range_random_chance" is used in the standard despawn rules | ||||||||||||
| despawn_from_distance | JSON Object | Specifies if the "min_distance" and "max_distance" are used in the standard despawn rules.
|
|||||||||||||
| despawn_from_inactivity | Boolean | true | Determines if the "min_range_inactivity_timer" is used in the standard despawn rules. | ||||||||||||
| despawn_from_simulation_edge | Boolean | true | Determines if the mob is instantly despawned at the edge of simulation distance in the standard despawn rules. | ||||||||||||
| filters | Minecraft Filter | The list of conditions that must be satisfied before the Actor is despawned. If a filter is defined then standard despawn rules are ignored. | |||||||||||||
| min_range_inactivity_timer | Integer | 30 | The amount of time in seconds that the mob must be inactive. | ||||||||||||
| min_range_random_chance | Integer | 800 | A random chance between 1 and the given value. | ||||||||||||
| remove_child_entities | Boolean | false | If true, all entities linked to this entity in a child relationship (eg. leashed) will also be despawned. |
Adds a timer for drying out that will count down and fire 'dried_out_event' or will stop as soon as the entity will get under rain or water and fire 'stopped_drying_out_event'
| Name | Type | Default Value | Description |
|---|---|---|---|
| dried_out_event | String | Event to fire when the drying out time runs out. | |
| recover_after_dried_out_event | String | Event to fire when entity was already dried out but received increase in water supply. | |
| stopped_drying_out_event | String | Event to fire when entity stopped drying out, for example got into water or under rain. | |
| total_time | Decimal | 0.0 | Amount of time in seconds to dry out fully. |
| water_bottle_refill_time | Decimal | 0.0 | Optional amount of additional time in seconds given by using splash water bottle on entity. |
Defines this entity's ability to trade with players.
| Name | Type | Default Value | Description |
|---|---|---|---|
| convert_trades_economy | Boolean | false | Determines when the mob transforms, if the trades should be converted when the new mob has a economy_trade_table. When the trades are converted, the mob will generate a new trade list with their new trade table, but then it will try to convert any of the same trades over to have the same enchantments and user data. For example, if the original has a Emerald to Enchanted Iron Sword (Sharpness 1), and the new trade also has an Emerald for Enchanted Iron Sword, then the enchantment will be Sharpness 1. |
| cured_discount | Range [a, b] | [-25, -20] | How much should the discount be modified by when the player has cured the Zombie Villager. Can be specified as a pair of numbers (When use_legacy_price_formula is true this is the low-tier trade discount and high-tier trade discount, otherwise it is the minor positive gossip and major positive gossip.) |
| display_name | String | Name to be displayed while trading with this entity | |
| hero_demand_discount | Integer | -4 | Used in legacy prices to determine how much should Demand be modified by when the player has the Hero of the Village mob effect |
| max_cured_discount | Range [a, b] | [-25, -20] | The max the discount can be modified by when the player has cured the Zombie Villager. Can be specified as a pair of numbers (When use_legacy_price_formula is true this is the low-tier trade discount and high-tier trade discount, otherwise it is the minor positive gossip and major positive gossip.) |
| max_nearby_cured_discount | Integer | -200 | The max the discount can be modified by when the player has cured a nearby Zombie Villager. Only used when use_legacy_price_formula is true, otherwise max_cured_discount (low) is used. |
| nearby_cured_discount | Integer | -20 | How much should the discount be modified by when the player has cured a nearby Zombie Villager |
| new_screen | Boolean | false | Used to determine if trading with entity opens the new trade screen |
| persist_trades | Boolean | false | Determines if the trades should persist when the mob transforms. This makes it so that the next time the mob is transformed to something with a trade_table or economy_trade_table, then it keeps their trades. |
| show_trade_screen | Boolean | true | Show an in game trade screen when interacting with the mob. |
| table | String | File path relative to the resource pack root for this entity's trades | |
| use_legacy_price_formula | Boolean | false | Determines whether the legacy formula is used to determines the trade prices. |
A component that owns multiple subsensors, each one firing an event when a set of conditions are met by other entities within the defined range.
| Name | Type | Default Value | Description | ||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| relative_range | Boolean | true | If true the subsensors' range is additive on top of the entity's size. | ||||||||||||||||||||||||||||||||
| subsensors | List | The list of subsensors which sense for entities and emit events when all their conditions are met.
|
Creates a trigger based on environment conditions.
| Name | Type | Default Value | Description |
|---|---|---|---|
| triggers | List | The list of triggers that fire when the environment conditions match the given filter criteria. |
The entity puts on the desired equipment.
| Name | Type | Default Value | Description |
|---|---|---|---|
| excluded_items | List | List of items that the entity should not equip. |
Defines an entity's behavior for having items equipped to it.
| Name | Type | Default Value | Description | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| slots | List | List of slots and the item that can be equipped.
|
Defines how much exhaustion each player action should take.
| Name | Type | Default Value | Description |
|---|---|---|---|
| attack | Decimal | 0.1 | Amount of exhaustion applied when attacking. |
| damage | Decimal | 0.1 | Amount of exhaustion applied when taking damage. |
| heal | Decimal | 6 | Amount of exhaustion applied when healed through food regeneration. |
| jump | Decimal | 0.05 | Amount of exhaustion applied when jumping. |
| mine | Decimal | 0.005 | Amount of exhaustion applied when mining. |
| sprint | Decimal | 0.01 | Amount of exhaustion applied when sprinting. |
| sprint_jump | Decimal | 0.2 | Amount of exhaustion applied when sprint jumping. |
| swim | Decimal | 0.01 | Amount of exhaustion applied when swimming. |
| walk | Decimal | 0 | Amount of exhaustion applied when walking. |
.
| Name | Type | Default Value | Description |
|---|---|---|---|
| on_bred | Molang | 0 | A Molang expression defining the amount of experience rewarded when this entity is successfully bred. An array of expressions adds each expression's result together for a final total. |
| on_death | Molang | 0 | A Molang expression defining the amount of experience rewarded when this entity dies. An array of expressions adds each expression's result together for a final total. |
Defines how the entity explodes.
| Name | Type | Default Value | Description |
|---|---|---|---|
| breaks_blocks | Boolean | true | If true, the explosion will destroy blocks in the explosion radius. |
| causes_fire | Boolean | false | If true, blocks in the explosion radius will be set on fire. |
| destroy_affected_by_griefing | Boolean | false | If true, whether the explosion breaks blocks is affected by the mob griefing game rule. |
| fire_affected_by_griefing | Boolean | false | If true, whether the explosion causes fire is affected by the mob griefing game rule. |
| fuse_length | Range [a, b] | [0.0, 0.0] | The range for the random amount of time the fuse will be lit before exploding, a negative value means the explosion will be immediate. |
| fuse_lit | Boolean | false | If true, the fuse is already lit when this component is added to the entity. |
| max_resistance | Decimal | 3.40282e+38 | A blocks explosion resistance will be capped at this value when an explosion occurs. |
| power | Decimal | 3 | The radius of the explosion in blocks and the amount of damage the explosion deals. |
Allows entities to flock in groups in water or not.
| Name | Type | Default Value | Description |
|---|---|---|---|
| block_distance | Decimal | 0 | The amount of blocks away the entity will look at to push away from. |
| block_weight | Decimal | 0 | The weight of the push back away from blocks. |
| breach_influence | Decimal | 0 | The amount of push back given to a flocker that breaches out of the water. |
| cohesion_threshold | Decimal | 1 | The threshold in which to start applying cohesion. |
| cohesion_weight | Decimal | 1 | The weight applied for the cohesion steering of the flock. |
| goal_weight | Decimal | 0 | The weight on which to apply on the goal output. |
| high_flock_limit | Integer | 0 | Determines the high bound amount of entities that can be allowed in the flock. |
| in_water | Boolean | false | Tells the Flocking Component if the entity exists in water. |
| influence_radius | Decimal | 0 | The area around the entity that allows others to be added to the flock. |
| innner_cohesion_threshold | Decimal | 0 | The distance in which the flocker will stop applying cohesion. |
| loner_chance | Decimal | 0 | The percentage chance between 0-1 that a fish will spawn and not want to join flocks. Invalid values will be capped at the end points. |
| low_flock_limit | Integer | 0 | Determines the low bound amount of entities that can be allowed in the flock. |
| match_variants | Boolean | false | Tells the flockers that they can only match similar entities that also match the variant, mark variants, and color data of the other potential flockers. |
| max_height | Decimal | 0 | The max height allowable in the air or water. |
| min_height | Decimal | 0 | The min height allowable in the air or water. |
| separation_threshold | Decimal | 2 | The distance that is determined to be to close to another flocking and to start applying separation. |
| separation_weight | Decimal | 1 | The weight applied to the separation of the flock. |
| use_center_of_mass | Boolean | false | Tells the flockers that they will follow flocks based on the center of mass. |
Allows an entity to emit `entityMove`, `swim` and `flap` game events, depending on the block the entity is moving through. It is added by default to every mob. Add it again to override its behavior.
| Name | Type | Default Value | Description |
|---|---|---|---|
| emit_flap | Boolean | false | If true, the `flap` game event will be emitted when the entity moves through air. |
| emit_move | Boolean | true | If true, the `entityMove` game event will be emitted when the entity moves on ground or through a solid. |
| emit_swim | Boolean | true | If true, the `swim` game event will be emitted when the entity moves through a liquid. |
Defines the way a mob's genes and alleles are passed on to its offspring, and how those traits manifest in the child. Compatible parent genes are crossed together, the alleles are handed down from the parents to the child, and any matching genetic variants fire off JSON events to modify the child and express the traits.
| Name | Type | Default Value | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| genes | List | The list of genes that this entity has and will cross with a partner during breeding.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| mutation_rate | Decimal | 0.03125 | Chance that an allele will be replaced with a random one instead of the parent's allele during birth. |
Defines sets of items that can be used to trigger events when used on this entity. The item will also be taken and placed in the entity's inventory.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown | Decimal | 0.0 | An optional cool down in seconds to prevent spamming interactions. |
| items | List | The list of items that can be given to the entity to place in their inventory. | |
| on_give | String | Event to fire when the correct item is given. |
Keeps track of entity group size in the given radius.
| Name | Type | Default Value | Description |
|---|---|---|---|
| filters | Minecraft Filter | The list of conditions that must be satisfied for other entities to be counted towards group size. | |
| radius | Decimal | 16 | Radius from center of entity. |
Could increase crop growth when entity walks over crop
| Name | Type | Default Value | Description |
|---|---|---|---|
| chance | Decimal | 0 | Value between 0-1. Chance of success per tick. |
| charges | Integer | 10 | Number of charges |
Defines the interactions with this entity for healing it.
| Name | Type | Default Value | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| filters | Minecraft Filter | The filter group that defines the conditions for using this item to heal the entity. | |||||||||||||
| force_use | Boolean | false | Determines if item can be used regardless of entity being at full health. | ||||||||||||
| items | Array | The array of items that can be used to heal this entity.
|
Defines the entity's heartbeat.
| Name | Type | Default Value | Description |
|---|---|---|---|
| interval | Molang | 1.00 | A Molang expression defining the inter-beat interval in seconds. A value of zero or less means no heartbeat. |
| sound_event | String | heartbeat | Level sound event to be played as the heartbeat sound. |
Saves a home pos for when the the entity is spawned.
| Name | Type | Default Value | Description |
|---|---|---|---|
| home_block_list | List | Optional block list that the home position will be associated with. If any of the blocks no longer exist at that position, the home restriction is removed. Example syntax: minecraft:sand. Not supported: minecraft:sand:1 | |
| restriction_radius | Integer | -1 | The radius that the entity will be restricted to in relation to its home |
Defines a set of conditions under which an entity should take damage.
| Name | Type | Default Value | Description |
|---|---|---|---|
| damage_conditions | Array | List of damage conditions that when met can cause damage to the entity.causeThe kind of damage that is caused to the entity. Various armors and spells use this to determine if the entity is immune.
Valid damage causes. An invalid value will result in the default cause of "none" being selected.
override
contact
entity_attack
projectile
suffocation
fall
fire
fire_tick
lava
drowning
block_explosion
entity_explosion
void
SelfDestruct
magic
wither
starve
anvil
thorns
falling_block
piston
magma
fireworks
charging
temperature
all
none
damage_per_tickThe amount of damage done each tick that the conditions are met.filtersThe set of conditions that must be satisfied before the entity takes the defined damage. |
Verifies whether the entity is inside any of the listed blocks.
| Name | Type | Default Value | Description |
|---|---|---|---|
| block_list | List | List of blocks, with certain block states, that we are monitoring to see if the entity is inside. |
Adds a timer since last rested to see if phantoms should spawn.
| Name | Type | Default Value | Description |
|---|---|---|---|
| days_until_insomnia | Decimal | 3.0 | Number of days the mob has to stay up until the insomnia effect begins. |
Despawns the Actor immediately.
| Name | Type | Default Value | Description |
|---|---|---|---|
| remove_child_entities | Boolean | false | If true, all entities linked to this entity in a child relationship (eg. leashed) will also be despawned. |
Defines interactions with this entity.
| Name | Type | Default Value | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| add_items | JSON Object | Loot table with items to add to the player's inventory upon successful interaction.
|
|||||||||||||
| cooldown | Decimal | 0 | Time in seconds before this entity can be interacted with again. | ||||||||||||
| cooldown_after_being_attacked | Decimal | 0 | Time in seconds before this entity can be interacted with after being attacked. | ||||||||||||
| drop_item_slot | String | The entity's slot to remove and drop the item from, if any, upon successful interaction. Inventory slots are denoted by positive numbers. Armor slots are denoted by 'slot.armor.head', 'slot.armor.chest', 'slot.armor.legs' and 'slot.armor.feet'. | |||||||||||||
| equip_item_slot | String | The entity's slot to equip the item to, if any, upon successful interaction. Inventory slots are denoted by positive numbers. Armor slots are denoted by 'slot.armor.head', 'slot.armor.chest', 'slot.armor.legs' and 'slot.armor.feet'. | |||||||||||||
| health_amount | Integer | 0 | The amount of health this entity will recover or lose when interacting with this item. Negative values will harm the entity. | ||||||||||||
| hurt_item | Integer | 0 | The amount of damage the item will take when used to interact with this entity. A value of 0 means the item won't lose durability. | ||||||||||||
| interact_text | String | Text to show when the player is able to interact in this way with this entity when playing with Touch-screen controls. | |||||||||||||
| on_interact | String | Event to fire when the interaction occurs. | |||||||||||||
| particle_on_start | JSON Object | Particle effect that will be triggered at the start of the interaction.particle_offset_towards_interactorWhether or not the particle will appear closer to who performed the interaction.particle_typeThe type of particle that will be spawned.particle_y_offsetWill offset the particle this amount in the y direction. |
|||||||||||||
| play_sounds | String | List of sounds to play when the interaction occurs. | |||||||||||||
| repair_entity_item | JSON Object | Allows to repair one of the entity's items.
|
|||||||||||||
| spawn_entities | String | List of entities to spawn when the interaction occurs. | |||||||||||||
| spawn_items | JSON Object | Loot table with items to drop on the ground upon successful interaction.
|
|||||||||||||
| swing | Boolean | false | If true, the player will do the 'swing' animation when interacting with this entity. | ||||||||||||
| transform_to_item | String | The item used will transform to this item upon successful interaction. Format: itemName:auxValue | |||||||||||||
| use_item | Boolean | false | If true, the interaction will use an item. | ||||||||||||
| vibration | String | entity_interact | Vibration to emit when the interaction occurs. Admitted values are none (no vibration emitted), shear, entity_act, entity_interact. |
Defines this entity's inventory properties.
| Name | Type | Default Value | Description |
|---|---|---|---|
| additional_slots_per_strength | Integer | 0 | Number of slots that this entity can gain per extra strength |
| can_be_siphoned_from | Boolean | false | If true, the contents of this inventory can be removed by a hopper |
| container_type | String | none | Type of container this entity has. Can be horse, minecart_chest, chest_boat, minecart_hopper, inventory, container or hopper |
| inventory_size | Integer | 5 | Number of slots the container has |
| private | Boolean | false | If true, the entity will not drop its inventory on death |
| restrict_to_owner | Boolean | false | If true, the entity's inventory can only be accessed by its owner or itself |
Determines that this entity is an item hopper.
Defines a dynamic type jump control that will change jump properties based on the speed modifier of the mob.
Gives the entity the ability to jump.
| Name | Type | Default Value | Description |
|---|---|---|---|
| jump_power | Decimal | 0.42 | The initial vertical velocity for the jump |
Allows this entity to be leashed and defines the conditions and events for this entity when is leashed.
| Name | Type | Default Value | Description |
|---|---|---|---|
| can_be_stolen | Boolean | false | If true, players can leash this entity even if it is already leashed to another mob. |
| hard_distance | Decimal | 6 | Distance in blocks at which the leash stiffens, restricting movement. |
| max_distance | Decimal | 10 | Distance in blocks at which the leash breaks. |
| on_leash | String | Event to call when this entity is leashed. | |
| on_unleash | String | Event to call when this entity is unleashed. | |
| soft_distance | Decimal | 4 | Distance in blocks at which the 'spring' effect starts acting to keep this entity close to the entity that leashed it. |
Defines the behavior when another entity looks at this entity.
| Name | Type | Default Value | Description |
|---|---|---|---|
| allow_invulnerable | Boolean | false | If true, invulnerable entities (e.g. Players in creative mode) are considered valid targets. |
| filters | Minecraft Filter | Defines the entities that can trigger this component. | |
| look_cooldown | Range [a, b] | [0, 0] | The range for the random amount of time during which the entity is 'cooling down' and won't get angered or look for a target. |
| look_event | String | The event identifier to run when the entities specified in filters look at this entity. | |
| search_radius | Decimal | 10 | Maximum distance this entity will look for another entity looking at it. |
| set_target | Boolean | true | If true, this entity will set the attack target as the entity that looked at it. |
This component is used to implement part of the Wandering Trader behavior
A component that applies a mob effect to entities that get within range.
| Name | Type | Default Value | Description |
|---|---|---|---|
| cooldown_time | Integer | 0 | Time in seconds to wait between each application of the effect. |
| effect_range | Decimal | 0.2 | How close a hostile entity must be to have the mob effect applied. |
| effect_time | Integer | 10 | How long the applied mob effect lasts in seconds. |
| entity_filter | Minecraft Filter | The set of entities that are valid to apply the mob effect to. | |
| mob_effect | String | The mob effect that is applied to entities that enter this entities effect range. |
Entities with this component will have an immunity to the provided mob effects.
| Name | Type | Default Value | Description |
|---|---|---|---|
| mob_effects | Array | List of names of effects the entity is immune to. |
This move control allows the mob to swim in water and walk on land.
| Name | Type | Default Value | Description |
|---|---|---|---|
| max_turn | Decimal | 30.0 | The maximum number in degrees the mob can turn per tick. |
This component accents the movement of an entity.
| Name | Type | Default Value | Description |
|---|---|---|---|
| max_turn | Decimal | 30.0 | The maximum number in degrees the mob can turn per tick. |
This move control causes the mob to fly.
| Name | Type | Default Value | Description |
|---|---|---|---|
| max_turn | Decimal | 30.0 | The maximum number in degrees the mob can turn per tick. |
This move control allows a mob to fly, swim, climb, etc.
| Name | Type | Default Value | Description |
|---|---|---|---|
| max_turn | Decimal | 30.0 | The maximum number in degrees the mob can turn per tick. |
This move control causes the mob to hover.
| Name | Type | Default Value | Description |
|---|---|---|---|
| max_turn | Decimal | 30.0 | The maximum number in degrees the mob can turn per tick. |
Move control that causes the mob to jump as it moves with a specified delay between jumps.
| Name | Type | Default Value | Description |
|---|---|---|---|
| jump_delay | Range [a, b] | [0.0, 0.0] | Delay after landing when using the slime move control. |
| max_turn | Decimal | 30.0 | The maximum number in degrees the mob can turn per tick. |
This move control causes the mob to hop as it moves.
| Name | Type | Default Value | Description |
|---|---|---|---|
| max_turn | Decimal | 30.0 | The maximum number in degrees the mob can turn per tick. |
This move control causes the mob to sway side to side giving the impression it is swimming.
| Name | Type | Default Value | Description |
|---|---|---|---|
| max_turn | Decimal | 30.0 | The maximum number in degrees the mob can turn per tick. |
| sway_amplitude | Decimal | 0.05 | Strength of the sway movement. |
| sway_frequency | Decimal | 0.5 | Multiplier for the frequency of the sway movement. |
Allows this entity to be named (e.g. using a name tag).
| Name | Type | Default Value | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| allow_name_tag_renaming | Boolean | true | If true, this entity can be renamed with name tags | ||||||||||||
| always_show | Boolean | false | If true, the name will always be shown | ||||||||||||
| default_trigger | String | Trigger to run when the entity gets named | |||||||||||||
| name_actions | JSON Object | Describes the special names for this entity and the events to call when the entity acquires those names
|
Allows this entity to generate paths that include vertical walls like the vanilla Spiders do.
| Name | Type | Default Value | Description |
|---|---|---|---|
| avoid_damage_blocks | Boolean | false | Tells the pathfinder to avoid blocks that cause damage when finding a path |
| avoid_portals | Boolean | false | Tells the pathfinder to avoid portals (like nether portals) when finding a path |
| avoid_sun | Boolean | false | Whether or not the pathfinder should avoid tiles that are exposed to the sun when creating paths |
| avoid_water | Boolean | false | Tells the pathfinder to avoid water when creating a path |
| blocks_to_avoid | List | Tells the pathfinder which blocks to avoid when creating a path | |
| can_breach | Boolean | false | Tells the pathfinder whether or not it can jump out of water (like a dolphin) |
| can_break_doors | Boolean | false | Tells the pathfinder that it can path through a closed door and break it |
| can_jump | Boolean | true | Tells the pathfinder whether or not it can jump up blocks |
| can_open_doors | Boolean | false | Tells the pathfinder that it can path through a closed door assuming the AI will open the door |
| can_open_iron_doors | Boolean | false | Tells the pathfinder that it can path through a closed iron door assuming the AI will open the door |
| can_pass_doors | Boolean | true | Whether a path can be created through a door |
| can_path_from_air | Boolean | false | Tells the pathfinder that it can start pathing when in the air |
| can_path_over_lava | Boolean | false | Tells the pathfinder whether or not it can travel on the surface of the lava |
| can_path_over_water | Boolean | false | Tells the pathfinder whether or not it can travel on the surface of the water |
| can_sink | Boolean | true | Tells the pathfinder whether or not it will be pulled down by gravity while in water |
| can_swim | Boolean | false | Tells the pathfinder whether or not it can path anywhere through water and plays swimming animation along that path |
| can_walk | Boolean | true | Tells the pathfinder whether or not it can walk on the ground outside water |
| can_walk_in_lava | Boolean | false | Tells the pathfinder whether or not it can travel in lava like walking on ground |
| is_amphibious | Boolean | false | Tells the pathfinder whether or not it can walk on the ground underwater |
Allows this entity to generate paths by flying around the air like the regular Ghast.
| Name | Type | Default Value | Description |
|---|---|---|---|
| avoid_damage_blocks | Boolean | false | Tells the pathfinder to avoid blocks that cause damage when finding a path |
| avoid_portals | Boolean | false | Tells the pathfinder to avoid portals (like nether portals) when finding a path |
| avoid_sun | Boolean | false | Whether or not the pathfinder should avoid tiles that are exposed to the sun when creating paths |
| avoid_water | Boolean | false | Tells the pathfinder to avoid water when creating a path |
| blocks_to_avoid | List | Tells the pathfinder which blocks to avoid when creating a path | |
| can_breach | Boolean | false | Tells the pathfinder whether or not it can jump out of water (like a dolphin) |
| can_break_doors | Boolean | false | Tells the pathfinder that it can path through a closed door and break it |
| can_jump | Boolean | true | Tells the pathfinder whether or not it can jump up blocks |
| can_open_doors | Boolean | false | Tells the pathfinder that it can path through a closed door assuming the AI will open the door |
| can_open_iron_doors | Boolean | false | Tells the pathfinder that it can path through a closed iron door assuming the AI will open the door |
| can_pass_doors | Boolean | true | Whether a path can be created through a door |
| can_path_from_air | Boolean | false | Tells the pathfinder that it can start pathing when in the air |
| can_path_over_lava | Boolean | false | Tells the pathfinder whether or not it can travel on the surface of the lava |
| can_path_over_water | Boolean | false | Tells the pathfinder whether or not it can travel on the surface of the water |
| can_sink | Boolean | true | Tells the pathfinder whether or not it will be pulled down by gravity while in water |
| can_swim | Boolean | false | Tells the pathfinder whether or not it can path anywhere through water and plays swimming animation along that path |
| can_walk | Boolean | true | Tells the pathfinder whether or not it can walk on the ground outside water |
| can_walk_in_lava | Boolean | false | Tells the pathfinder whether or not it can travel in lava like walking on ground |
| is_amphibious | Boolean | false | Tells the pathfinder whether or not it can walk on the ground underwater |
Allows this entity to generate paths in the air like the vanilla Parrots do.
| Name | Type | Default Value | Description |
|---|---|---|---|
| avoid_damage_blocks | Boolean | false | Tells the pathfinder to avoid blocks that cause damage when finding a path |
| avoid_portals | Boolean | false | Tells the pathfinder to avoid portals (like nether portals) when finding a path |
| avoid_sun | Boolean | false | Whether or not the pathfinder should avoid tiles that are exposed to the sun when creating paths |
| avoid_water | Boolean | false | Tells the pathfinder to avoid water when creating a path |
| blocks_to_avoid | List | Tells the pathfinder which blocks to avoid when creating a path | |
| can_breach | Boolean | false | Tells the pathfinder whether or not it can jump out of water (like a dolphin) |
| can_break_doors | Boolean | false | Tells the pathfinder that it can path through a closed door and break it |
| can_jump | Boolean | true | Tells the pathfinder whether or not it can jump up blocks |
| can_open_doors | Boolean | false | Tells the pathfinder that it can path through a closed door assuming the AI will open the door |
| can_open_iron_doors | Boolean | false | Tells the pathfinder that it can path through a closed iron door assuming the AI will open the door |
| can_pass_doors | Boolean | true | Whether a path can be created through a door |
| can_path_from_air | Boolean | false | Tells the pathfinder that it can start pathing when in the air |
| can_path_over_lava | Boolean | false | Tells the pathfinder whether or not it can travel on the surface of the lava |
| can_path_over_water | Boolean | false | Tells the pathfinder whether or not it can travel on the surface of the water |
| can_sink | Boolean | true | Tells the pathfinder whether or not it will be pulled down by gravity while in water |
| can_swim | Boolean | false | Tells the pathfinder whether or not it can path anywhere through water and plays swimming animation along that path |
| can_walk | Boolean | true | Tells the pathfinder whether or not it can walk on the ground outside water |
| can_walk_in_lava | Boolean | false | Tells the pathfinder whether or not it can travel in lava like walking on ground |
| is_amphibious | Boolean | false | Tells the pathfinder whether or not it can walk on the ground underwater |
Allows this entity to generate paths by walking, swimming, flying and/or climbing around and jumping up and down a block.
| Name | Type | Default Value | Description |
|---|---|---|---|
| avoid_damage_blocks | Boolean | false | Tells the pathfinder to avoid blocks that cause damage when finding a path |
| avoid_portals | Boolean | false | Tells the pathfinder to avoid portals (like nether portals) when finding a path |
| avoid_sun | Boolean | false | Whether or not the pathfinder should avoid tiles that are exposed to the sun when creating paths |
| avoid_water | Boolean | false | Tells the pathfinder to avoid water when creating a path |
| blocks_to_avoid | List | Tells the pathfinder which blocks to avoid when creating a path | |
| can_breach | Boolean | false | Tells the pathfinder whether or not it can jump out of water (like a dolphin) |
| can_break_doors | Boolean | false | Tells the pathfinder that it can path through a closed door and break it |
| can_jump | Boolean | true | Tells the pathfinder whether or not it can jump up blocks |
| can_open_doors | Boolean | false | Tells the pathfinder that it can path through a closed door assuming the AI will open the door |
| can_open_iron_doors | Boolean | false | Tells the pathfinder that it can path through a closed iron door assuming the AI will open the door |
| can_pass_doors | Boolean | true | Whether a path can be created through a door |
| can_path_from_air | Boolean | false | Tells the pathfinder that it can start pathing when in the air |
| can_path_over_lava | Boolean | false | Tells the pathfinder whether or not it can travel on the surface of the lava |
| can_path_over_water | Boolean | false | Tells the pathfinder whether or not it can travel on the surface of the water |
| can_sink | Boolean | true | Tells the pathfinder whether or not it will be pulled down by gravity while in water |
| can_swim | Boolean | false | Tells the pathfinder whether or not it can path anywhere through water and plays swimming animation along that path |
| can_walk | Boolean | true | Tells the pathfinder whether or not it can walk on the ground outside water |
| can_walk_in_lava | Boolean | false | Tells the pathfinder whether or not it can travel in lava like walking on ground |
| is_amphibious | Boolean | false | Tells the pathfinder whether or not it can walk on the ground underwater |
Allows this entity to generate paths in the air like the vanilla Bees do. Keeps them from falling out of the skies and doing predictive movement.
| Name | Type | Default Value | Description |
|---|---|---|---|
| avoid_damage_blocks | Boolean | false | Tells the pathfinder to avoid blocks that cause damage when finding a path |
| avoid_portals | Boolean | false | Tells the pathfinder to avoid portals (like nether portals) when finding a path |
| avoid_sun | Boolean | false | Whether or not the pathfinder should avoid tiles that are exposed to the sun when creating paths |
| avoid_water | Boolean | false | Tells the pathfinder to avoid water when creating a path |
| blocks_to_avoid | List | Tells the pathfinder which blocks to avoid when creating a path | |
| can_breach | Boolean | false | Tells the pathfinder whether or not it can jump out of water (like a dolphin) |
| can_break_doors | Boolean | false | Tells the pathfinder that it can path through a closed door and break it |
| can_jump | Boolean | true | Tells the pathfinder whether or not it can jump up blocks |
| can_open_doors | Boolean | false | Tells the pathfinder that it can path through a closed door assuming the AI will open the door |
| can_open_iron_doors | Boolean | false | Tells the pathfinder that it can path through a closed iron door assuming the AI will open the door |
| can_pass_doors | Boolean | true | Whether a path can be created through a door |
| can_path_from_air | Boolean | false | Tells the pathfinder that it can start pathing when in the air |
| can_path_over_lava | Boolean | false | Tells the pathfinder whether or not it can travel on the surface of the lava |
| can_path_over_water | Boolean | false | Tells the pathfinder whether or not it can travel on the surface of the water |
| can_sink | Boolean | true | Tells the pathfinder whether or not it will be pulled down by gravity while in water |
| can_swim | Boolean | false | Tells the pathfinder whether or not it can path anywhere through water and plays swimming animation along that path |
| can_walk | Boolean | true | Tells the pathfinder whether or not it can walk on the ground outside water |
| can_walk_in_lava | Boolean | false | Tells the pathfinder whether or not it can travel in lava like walking on ground |
| is_amphibious | Boolean | false | Tells the pathfinder whether or not it can walk on the ground underwater |
Allows this entity to generate paths that include water.
| Name | Type | Default Value | Description |
|---|---|---|---|
| avoid_damage_blocks | Boolean | false | Tells the pathfinder to avoid blocks that cause damage when finding a path |
| avoid_portals | Boolean | false | Tells the pathfinder to avoid portals (like nether portals) when finding a path |
| avoid_sun | Boolean | false | Whether or not the pathfinder should avoid tiles that are exposed to the sun when creating paths |
| avoid_water | Boolean | false | Tells the pathfinder to avoid water when creating a path |
| blocks_to_avoid | List | Tells the pathfinder which blocks to avoid when creating a path | |
| can_breach | Boolean | false | Tells the pathfinder whether or not it can jump out of water (like a dolphin) |
| can_break_doors | Boolean | false | Tells the pathfinder that it can path through a closed door and break it |
| can_jump | Boolean | true | Tells the pathfinder whether or not it can jump up blocks |
| can_open_doors | Boolean | false | Tells the pathfinder that it can path through a closed door assuming the AI will open the door |
| can_open_iron_doors | Boolean | false | Tells the pathfinder that it can path through a closed iron door assuming the AI will open the door |
| can_pass_doors | Boolean | true | Whether a path can be created through a door |
| can_path_from_air | Boolean | false | Tells the pathfinder that it can start pathing when in the air |
| can_path_over_lava | Boolean | false | Tells the pathfinder whether or not it can travel on the surface of the lava |
| can_path_over_water | Boolean | false | Tells the pathfinder whether or not it can travel on the surface of the water |
| can_sink | Boolean | true | Tells the pathfinder whether or not it will be pulled down by gravity while in water |
| can_swim | Boolean | false | Tells the pathfinder whether or not it can path anywhere through water and plays swimming animation along that path |
| can_walk | Boolean | true | Tells the pathfinder whether or not it can walk on the ground outside water |
| can_walk_in_lava | Boolean | false | Tells the pathfinder whether or not it can travel in lava like walking on ground |
| is_amphibious | Boolean | false | Tells the pathfinder whether or not it can walk on the ground underwater |
Allows this entity to generate paths by walking around and jumping up and down a block like regular mobs.
| Name | Type | Default Value | Description |
|---|---|---|---|
| avoid_damage_blocks | Boolean | false | Tells the pathfinder to avoid blocks that cause damage when finding a path |
| avoid_portals | Boolean | false | Tells the pathfinder to avoid portals (like nether portals) when finding a path |
| avoid_sun | Boolean | false | Whether or not the pathfinder should avoid tiles that are exposed to the sun when creating paths |
| avoid_water | Boolean | false | Tells the pathfinder to avoid water when creating a path |
| blocks_to_avoid | List | Tells the pathfinder which blocks to avoid when creating a path | |
| can_breach | Boolean | false | Tells the pathfinder whether or not it can jump out of water (like a dolphin) |
| can_break_doors | Boolean | false | Tells the pathfinder that it can path through a closed door and break it |
| can_jump | Boolean | true | Tells the pathfinder whether or not it can jump up blocks |
| can_open_doors | Boolean | false | Tells the pathfinder that it can path through a closed door assuming the AI will open the door |
| can_open_iron_doors | Boolean | false | Tells the pathfinder that it can path through a closed iron door assuming the AI will open the door |
| can_pass_doors | Boolean | true | Whether a path can be created through a door |
| can_path_from_air | Boolean | false | Tells the pathfinder that it can start pathing when in the air |
| can_path_over_lava | Boolean | false | Tells the pathfinder whether or not it can travel on the surface of the lava |
| can_path_over_water | Boolean | false | Tells the pathfinder whether or not it can travel on the surface of the water |
| can_sink | Boolean | true | Tells the pathfinder whether or not it will be pulled down by gravity while in water |
| can_swim | Boolean | false | Tells the pathfinder whether or not it can path anywhere through water and plays swimming animation along that path |
| can_walk | Boolean | true | Tells the pathfinder whether or not it can walk on the ground outside water |
| can_walk_in_lava | Boolean | false | Tells the pathfinder whether or not it can travel in lava like walking on ground |
| is_amphibious | Boolean | false | Tells the pathfinder whether or not it can walk on the ground underwater |
Defines the entity's 'out of control' state.
Defines the entity's 'peek' behavior, defining the events that should be called during it.
| Name | Type | Default Value | Description |
|---|---|---|---|
| on_close | String | Event to call when the entity is done peeking. | |
| on_open | String | Event to call when the entity starts peeking. | |
| on_target_open | String | Event to call when the entity's target entity starts peeking. |
Defines whether an entity should be persistent in the game world.
Defines physics properties of an actor, including if it is affected by gravity or if it collides with objects.
| Name | Type | Default Value | Description |
|---|---|---|---|
| has_collision | Boolean | true | Whether or not the object collides with things. |
| has_gravity | Boolean | true | Whether or not the entity is affected by gravity. |
| push_towards_closest_space | Boolean | false | Whether or not the entity should be pushed towards the nearest open area when stuck inside a block. |
Specifies costing information for mobs that prefer to walk on preferred paths.
| Name | Type | Default Value | Description |
|---|---|---|---|
| default_block_cost | Decimal | 0 | Cost for non-preferred blocks |
| jump_cost | Integer | 0 | Added cost for jumping up a node |
| max_fall_blocks | Integer | 3 | Distance mob can fall without taking damage |
| preferred_path_blocks | List | A list of blocks with their associated cost |
Allows the entity to be a thrown entity.
| Name | Type | Default Value | Description |
|---|---|---|---|
| angle_offset | Decimal | 0 | Determines the angle at which the projectile is thrown |
| catch_fire | Boolean | false | If true, the entity hit will be set on fire |
| crit_particle_on_hurt | Boolean | false | If true, the projectile will produce additional particles when a critical hit happens |
| destroy_on_hurt | Boolean | false | If true, this entity will be destroyed when hit |
| filter | String | Entity Definitions defined here can't be hurt by the projectile | |
| fire_affected_by_griefing | Boolean | false | If true, whether the projectile causes fire is affected by the mob griefing game rule |
| gravity | Decimal | 0.05 | The gravity applied to this entity when thrown. The higher the value, the faster the entity falls |
| hit_nearest_passenger | Boolean | false | If true, when hitting a vehicle, and there's at least one passenger in the vehicle, the damage will be dealt to the passenger closest to the projectile impact point. If there are no passengers, this setting does nothing. |
| hit_sound | String | The sound that plays when the projectile hits something | |
| homing | Boolean | false | If true, the projectile homes in to the nearest entity |
| ignored_entities | Array | [EXPERIMENTAL] An array of strings defining the types of entities that this entity does not collide with. | |
| inertia | Decimal | 0.99 | The fraction of the projectile's speed maintained every frame while traveling in air |
| is_dangerous | Boolean | false | If true, the projectile will be treated as dangerous to the players |
| knockback | Boolean | true | If true, the projectile will knock back the entity it hits |
| lightning | Boolean | false | If true, the entity hit will be struck by lightning |
| liquid_inertia | Decimal | 0.6 | The fraction of the projectile's speed maintained every frame while traveling in water |
| multiple_targets | Boolean | true | If true, the projectile can hit multiple entities per flight |
| offset | Vector [a, b, c] | [0, 0, 0] | The offset from the entity's anchor where the projectile will spawn |
| on_fire_time | Decimal | 5 | Time in seconds that the entity hit will be on fire for |
| particle | String | iconcrack | Particle to use upon collision |
| potion_effect | Integer | -1 | Defines the effect the arrow will apply to the entity it hits |
| power | Decimal | 1.3 | Determines the velocity of the projectile |
| reflect_on_hurt | Boolean | false | If true, this entity will be reflected back when hit |
| semi_random_diff_damage | Boolean | false | If true, damage will be randomized based on damage and speed |
| shoot_sound | String | The sound that plays when the projectile is shot | |
| shoot_target | Boolean | true | If true, the projectile will be shot towards the target of the entity firing it |
| should_bounce | Boolean | false | If true, the projectile will bounce upon hit |
| splash_potion | Boolean | false | If true, the projectile will be treated like a splash potion |
| splash_range | Decimal | 4 | Radius in blocks of the 'splash' effect |
| uncertainty_base | Decimal | 0 | The base accuracy. Accuracy is determined by the formula uncertaintyBase - difficultyLevel * uncertaintyMultiplier |
| uncertainty_multiplier | Decimal | 0 | Determines how much difficulty affects accuracy. Accuracy is determined by the formula uncertaintyBase - difficultyLevel * uncertaintyMultiplier |
Defines what can push an entity between other entities and pistons.
| Name | Type | Default Value | Description |
|---|---|---|---|
| is_pushable | Boolean | true | Whether the entity can be pushed by other entities. |
| is_pushable_by_piston | Boolean | true | Whether the entity can be pushed by pistons safely. |
Attempts to trigger a raid at the entity's location.
| Name | Type | Default Value | Description |
|---|---|---|---|
| triggered_event | String | Event to run when a raid is triggered on the village. |
Defines the entity's movement on the rails. An entity with this component is only allowed to move on the rail.
| Name | Type | Default Value | Description |
|---|---|---|---|
| max_speed | Decimal | 0.4 | Maximum speed that this entity will move at when on the rail. |
| Name | Type | Default Value | Description |
|---|---|---|---|
| check_block_types | Boolean | false | If true, on tick this entity will trigger its on_deactivate behavior |
| eject_on_activate | Boolean | true | If true, this entity will eject all of its riders when it passes over an activated rail |
| eject_on_deactivate | Boolean | false | If true, this entity will eject all of its riders when it passes over a deactivated rail |
| on_activate | String | Event to call when the rail is activated | |
| on_deactivate | String | Event to call when the rail is deactivated | |
| tick_command_block_on_activate | Boolean | true | If true, command blocks will start ticking when passing over an activated rail |
| tick_command_block_on_deactivate | Boolean | false | If false, command blocks will stop ticking when passing over a deactivated rail |
Defines the ravager's response to their melee attack being blocked.
| Name | Type | Default Value | Description |
|---|---|---|---|
| knockback_strength | Decimal | 3.0 | The strength with which blocking entities should be knocked back |
| reaction_choices | List | [ ] | A list of weighted responses to the melee attack being blocked |
[EXPERIMENTAL] Allows an entity to reflect projectiles.
| Name | Type | Default Value | Description |
|---|---|---|---|
| azimuth_angle | Molang | 0 | [EXPERIMENTAL] A Molang expression defining the angle in degrees to add to the projectile's y axis rotation. |
| elevation_angle | Molang | 0 | [EXPERIMENTAL] A Molang expression defining the angle in degrees to add to the projectile's x axis rotation. |
| reflected_projectiles | Array | [EXPERIMENTAL] An array of strings defining the types of projectiles that are reflected when they hit the entity. | |
| reflection_scale | Molang | 1 | [EXPERIMENTAL] A Molang expression defining the velocity scaling of the reflected projectile. Values below 1 decrease the projectile's velocity, and values above 1 increase it. |
| reflection_sound | String | reflect | [EXPERIMENTAL] A string defining the name of the sound event to be played when a projectile is reflected. "reflect" unless specified. |
Determines whether this entity can be ridden. Allows specifying the different seat positions and quantity.
| Name | Type | Default Value | Description | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| controlling_seat | Integer | 0 | The seat that designates the driver of the entity. This is only observed by the horse/boat styles of riding; minecarts/entities with "minecraft:controlled_by_player" give control to any player in any seat. | ||||||||||||||||||||||||
| crouching_skip_interact | Boolean | true | If true, this entity can't be interacted with if the entity interacting with it is crouching | ||||||||||||||||||||||||
| family_types | List | List of entities that can ride this entity | |||||||||||||||||||||||||
| interact_text | String | The text to display when the player can interact with the entity when playing with Touch-screen controls | |||||||||||||||||||||||||
| passenger_max_width | Decimal | 0.00 | The max width a mob can be to be a passenger. A value of 0 ignores this parameter. | ||||||||||||||||||||||||
| priority | Integer | 0 | This field may exist in old data but isn't used by minecraft:rideable. | ||||||||||||||||||||||||
| pull_in_entities | Boolean | false | If true, this entity will pull in entities that are in the correct family_types into any available seats | ||||||||||||||||||||||||
| rider_can_interact | Boolean | false | If true, this entity will be picked when looked at by the rider | ||||||||||||||||||||||||
| seat_count | Integer | 1 | The number of entities that can ride this entity at the same time | ||||||||||||||||||||||||
| seats | List | The list of positions and number of riders for each position for entities riding this entity
|
Defines the entity's size interpolation based on the entity's age.
| Name | Type | Default Value | Description |
|---|---|---|---|
| end_scale | Decimal | 1 | Ending scale of the entity when it's fully grown. |
| start_scale | Decimal | 1 | Initial scale of the newborn entity. |
Fires off scheduled mob events at time of day events.
| Name | Type | Default Value | Description |
|---|---|---|---|
| scheduled_events | List | The list of triggers that fire when the conditions match the given filter criteria. If any filter criteria overlap the first defined event will be picked. |
Defines a list of items the mob wants to share or pick up. Each item must have the following parameters:
| Name | Type | Default Value | Description |
|---|---|---|---|
| all_items | Boolean | false | A bucket for all other items in the game. Note this category is always least priority items. |
| all_items_max_amount | Integer | -1 | Maximum number of this item the mob will hold. |
| all_items_surplus_amount | Integer | -1 | Number of this item considered extra that the entity wants to share. |
| all_items_want_amount | Integer | -1 | Number of this item this entity wants to share. |
| items | List | List of items that the entity wants to share.admireMob will admire the item after picking up by looking at it. For this to happen the mob needs to have an Admire component and an Admire goal.barterMob will barter for the item after picking it up. For this to work the mob needs to have a Barter component and a Barter goal.consume_itemDetermines whether the mob will consume the item or not.craft_intoDefines the item this entity wants to craft with the item defined by "item". Should be an item name.itemThe name of the item. Aux value can be specified, for instance 'minecraft:skull:1'.max_amountMaximum number of this item the mob will hold.pickup_limitMaximum number of this item the mob will pick up during a single goal tick.pickup_onlyDetermines whether the mob can only pickup the item and not drop it.priorityPrioritizes which items the entity prefers. 0 is the highest priority.stored_in_inventoryDetermines whether the mob will try to put the item in its inventory if it has the inventory component and if it can't be equipped.surplus_amountNumber of this item considered extra that the entity wants to share.want_amountNumber of this item this entity wants to have. |
|
| singular_pickup | Boolean | false | Controls if the mob is able to pick up more of the same item if it is already holding that item |
Defines the entity's ranged attack behavior. The "minecraft:behavior.ranged_attack" goal uses this component to determine which projectiles to shoot.
| Name | Type | Default Value | Description |
|---|---|---|---|
| aux_val | Integer | -1 | ID of the Potion effect for the default projectile to be applied on hit. |
| def | String | Actor definition to use as the default projectile for the ranged attack. The actor definition must have the projectile component to be able to be shot as a projectile. | |
| magic | Boolean | false | Sets whether the projectiles being used are flagged as magic. If set, the ranged attack goal will not be used at the same time as other magic goals, such as minecraft:behavior.drink_potion |
| power | Decimal | 0.00 | Velocity in which the projectiles will be shot at. A power of 0 will be overwritten by the default projectile throw power. |
| projectiles | List | List of projectiles that can be used by the shooter. Projectiles are evaluated in the order of the list; After a projectile is chosen, the rest of the list is ignored. | |
| sound | String | Sound that is played when the shooter shoots a projectile. |
Defines the entity's 'sit' state.
| Name | Type | Default Value | Description |
|---|---|---|---|
| sit_event | String | Event to run when the entity enters the 'sit' state | |
| stand_event | String | Event to run when the entity exits the 'sit' state |
Adds a timer after which this entity will spawn another entity or item (similar to vanilla's chicken's egg-laying behavior).
| Name | Type | Default Value | Description |
|---|---|---|---|
| filters | Minecraft Filter | If present, the specified entity will only spawn if the filter evaluates to true. | |
| max_wait_time | Integer | 600 | Maximum amount of time to randomly wait in seconds before another entity is spawned. |
| min_wait_time | Integer | 300 | Minimum amount of time to randomly wait in seconds before another entity is spawned. |
| num_to_spawn | Integer | 1 | The number of entities of this type to spawn each time that this triggers. |
| should_leash | Boolean | false | If true, this the spawned entity will be leashed to the parent. |
| single_use | Boolean | false | If true, this component will only ever spawn the specified entity once. |
| spawn_entity | String | Identifier of the entity to spawn, leave empty to spawn the item defined by "spawn_item" instead. | |
| spawn_event | String | minecraft:entity_born | Event to call on the spawned entity when it spawns. |
| spawn_item | String | egg | Item identifier of the item to spawn. |
| spawn_item_event | Trigger | Event to call on this entity when the item is spawned. | |
| spawn_method | String | born | Method to use to spawn the entity. |
| spawn_sound | String | plop | Identifier of the sound effect to play when the entity is spawned. |
Allows this entity to remember suspicious locations
Defines the rules for a mob to be tamed by the player.
| Name | Type | Default Value | Description |
|---|---|---|---|
| probability | Decimal | 1 | The chance of taming the entity with each item use between 0.0 and 1.0, where 1.0 is 100% |
| tame_event | String | Event to run when this entity becomes tamed | |
| tame_items | List | The list of items that can be used to tame this entity |
Allows the Entity to be tamed by mounting it.
| Name | Type | Default Value | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| attempt_temper_mod | Integer | 5 | The amount the entity's temper will increase when mounted. | ||||||||||||
| autoRejectItems | JSON Object | The list of items that, if carried while interacting with the entity, will anger it.
|
|||||||||||||
| feed_items | JSON Object | The list of items that can be used to increase the entity's temper and speed up the taming process.
|
|||||||||||||
| feed_text | String | The text that shows in the feeding interact button. | |||||||||||||
| max_temper | Integer | 100 | The maximum value for the entity's random starting temper. | ||||||||||||
| min_temper | Integer | 0 | The minimum value for the entity's random starting temper. | ||||||||||||
| ride_text | String | The text that shows in the riding interact button. | |||||||||||||
| tame_event | String | Event that triggers when the entity becomes tamed. |
Defines the entity's range within which it can see or sense other entities to target them.
| Name | Type | Default Value | Description |
|---|---|---|---|
| inside_range | Decimal | 1 | Maximum distance in blocks that another entity will be considered in the 'inside' range |
| must_see | Boolean | false | Whether the other entity needs to be visible to trigger 'inside' events |
| on_inside_range | String | Event to call when an entity gets in the inside range. Can specify 'event' for the name of the event and 'target' for the target of the event | |
| on_outside_range | String | Event to call when an entity gets in the outside range. Can specify 'event' for the name of the event and 'target' for the target of the event | |
| on_vision_lost_inside_range | String | Event to call when an entity exits visual range. Can specify 'event' for the name of the event and 'target' for the target of the event | |
| outside_range | Decimal | 5 | Maximum distance in blocks that another entity will be considered in the 'outside' range |
Defines an entity's teleporting behavior.
| Name | Type | Default Value | Description |
|---|---|---|---|
| dark_teleport_chance | Decimal | 0.01 | Modifies the chance that the entity will teleport if the entity is in darkness |
| light_teleport_chance | Decimal | 0.01 | Modifies the chance that the entity will teleport if the entity is in daylight |
| max_random_teleport_time | Decimal | 20 | Maximum amount of time in seconds between random teleports |
| min_random_teleport_time | Decimal | 0 | Minimum amount of time in seconds between random teleports |
| random_teleport_cube | Vector [a, b, c] | [32, 16, 32] | Entity will teleport to a random position within the area defined by this cube |
| random_teleports | Boolean | true | If true, the entity will teleport randomly |
| target_distance | Decimal | 16 | Maximum distance the entity will teleport when chasing a target |
| target_teleport_chance | Decimal | 1 | The chance that the entity will teleport between 0.0 and 1.0. 1.0 means 100% |
Defines if the entity ticks the world and the radius around it to tick.
| Name | Type | Default Value | Description |
|---|---|---|---|
| distance_to_players | Decimal | 128 | The distance at which the closest player has to be before this entity despawns. This option will be ignored if never_despawn is true. Min: 128 blocks. |
| never_despawn | Boolean | true | If true, this entity will not despawn even if players are far away. If false, distance_to_players will be used to determine when to despawn. |
| radius | Positive Integer | 2 | The area around the entity to tick. Default: 2. Allowed range: 2-6. |
Adds a timer after which an event will fire.
| Name | Type | Default Value | Description |
|---|---|---|---|
| looping | Boolean | true | If true, the timer will restart every time after it fires. |
| randomInterval | Boolean | true | If true, the amount of time on the timer will be random between the min and max values specified in time. |
| random_time_choices | List | [ ] | This is a list of objects, representing one value in seconds that can be picked before firing the event and an optional weight. Incompatible with time. |
| time | Range [a, b] | [0.0, 0.0] | Amount of time in seconds for the timer. Can be specified as a number or a pair of numbers (min and max). Incompatible with random_time_choices. |
| time_down_event | String | Event to fire when the time on the timer runs out. |
Defines this entity's ability to trade with players.
| Name | Type | Default Value | Description |
|---|---|---|---|
| convert_trades_economy | Boolean | false | Determines when the mob transforms, if the trades should be converted when the new mob has a economy_trade_table. When the trades are converted, the mob will generate a new trade list with their new trade table, but then it will try to convert any of the same trades over to have the same enchantments and user data. For example, if the original has a Emerald to Enchanted Iron Sword (Sharpness 1), and the new trade also has an Emerald for Enchanted Iron Sword, then the enchantment will be Sharpness 1. |
| display_name | String | Name to be displayed while trading with this entity. | |
| new_screen | Boolean | false | Used to determine if trading with entity opens the new trade screen. |
| persist_trades | Boolean | false | Determines if the trades should persist when the mob transforms. This makes it so that the next time the mob is transformed to something with a trade_table or economy_trade_table, then it keeps their trades. |
| table | String | File path relative to the behavior pack root for this entity's trades. |
Causes an entity to leave a trail of blocks as it moves about the world.
| Name | Type | Default Value | Description |
|---|---|---|---|
| block_type | String | air | The type of block you wish to be spawned by the entity as it move about the world. Solid blocks may not be spawned at an offset of (0,0,0). |
| spawn_filter | Minecraft Filter | One or more conditions that must be met in order to cause the chosen block type to spawn. | |
| spawn_offset | Vector [a, b, c] | [0, 0, 0] | The distance from the entities current position to spawn the block. Capped at up to 16 blocks away. The X value is left/right(-/+), the Z value is backward/forward(-/+), the Y value is below/above(-/+). |
Defines an entity's transformation from the current definition into another
| Name | Type | Default Value | Description | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| add | JSON Object | List of components to add to the entity after the transformation
|
|||||||||||||||||||||||||||||||||||||
| begin_transform_sound | String | Sound to play when the transformation starts | |||||||||||||||||||||||||||||||||||||
| delay | JSON Object | Defines the properties of the delay for the transformation
|
|||||||||||||||||||||||||||||||||||||
| drop_equipment | Boolean | false | Cause the entity to drop all equipment upon transformation | ||||||||||||||||||||||||||||||||||||
| drop_inventory | Boolean | false | Cause the entity to drop all items in inventory upon transformation | ||||||||||||||||||||||||||||||||||||
| into | String | Entity Definition that this entity will transform into | |||||||||||||||||||||||||||||||||||||
| keep_level | Boolean | false | If this entity has trades and has leveled up, it should maintain that level after transformation. | ||||||||||||||||||||||||||||||||||||
| keep_owner | Boolean | false | If this entity is owned by another entity, it should remain owned after transformation. | ||||||||||||||||||||||||||||||||||||
| preserve_equipment | Boolean | false | Cause the entity to keep equipment after going through transformation | ||||||||||||||||||||||||||||||||||||
| transformation_sound | String | Sound to play when the entity is done transforming |
Defines the rules for a mob to trust players.
| Name | Type | Default Value | Description |
|---|---|---|---|
| probability | Decimal | 1.00 | The chance of the entity trusting with each item use between 0.0 and 1.0, where 1.0 is 100%. |
| trust_event | String | Event to run when this entity becomes trusting. | |
| trust_items | List | The list of items that can be used to get the entity to trust players. |
Entities with this component will have a maximum auto step height that is different depending on whether they are on a block that prevents jumping. Incompatible with "runtime_identifier": "minecraft:horse".
| Name | Type | Default Value | Description |
|---|---|---|---|
| base_value | Decimal | 0.5625 | The maximum auto step height when on any other block. |
| controlled_value | Decimal | 0.5625 | The maximum auto step height when on any other block and controlled by the player. |
| jump_prevented_value | Decimal | 0.5625 | The maximum auto step height when on a block that prevents jumping. |
Vibrations emitted by this entity will be ignored.
| Name | Type | Default Value | Description |
|---|---|---|---|
| drag_factor | Decimal | 0.8 | Drag factor to determine movement speed when in water. |
These properties are part of the Entity Definition as a whole and go before the Component or Component Groups. Make sure to place them before any Components, Component Groups or Events sections or they will be ignored.
Specifies the version of the game this entity was made in. If the version is lower than the current version, any changes made to the entity in the vanilla version will be applied to it.
Example
{ "format_version": "1.8.0", "minecraft:entity": { "component_groups": { ... } ... } }
This section defines properties required to identify and construct the entity
Sets the name for this entity's description.
| Type | Default Value | Description |
|---|---|---|
| String | The identifier for this entity |
Sets whether or not this entity has a spawn egg in the creative ui.
| Type | Default Value | Description |
|---|---|---|
| Boolean | false | Set to determine if this entity has a spawn egg. |
Sets whether or not we can summon this entity using commands such as /summon.
| Type | Default Value | Description |
|---|---|---|
| Boolean | false | Flag to mark this entity as being summonable or not. |
Sets the name for the Vanilla Minecraft identifier this entity will use to build itself from.
| Type | Default Value | Description |
|---|---|---|
| String | The identifier for the class to construct this entity with |
Sets the mapping of internal animation references to actual animations. This is a JSON Object of name/animation pairs
| Name | Type | Default Value | Description |
|---|---|---|---|
| animation | String | none | Actual animation to use |
| name | String | none | Internal (to the entity) name of this animation entry |
Sets the mapping of internal animation controller references to actual animation controller. This is a JSON Array of name/animation-controller pairs
| Name | Type | Default Value | Description |
|---|---|---|---|
| animation controller | String | none | Actual animation to use |
| name | String | none | Internal (to the entity) name of this animation entry |
| JSON Name | ID |
|---|---|
| minecraft:behavior.admire_item | 1024844406 |
| minecraft:behavior.avoid_block | 2854732834617046989 |
| minecraft:behavior.avoid_mob_type | 12990492194774829831 |
| minecraft:behavior.barter | 536670686 |
| minecraft:behavior.beg | 1346418048 |
| minecraft:behavior.break_door | -1798237626 |
| minecraft:behavior.breed | 51166360 |
| minecraft:behavior.celebrate | 3133100024050825239 |
| minecraft:behavior.celebrate_survive | 9921563176146616642 |
| minecraft:behavior.charge_attack | 16313004636962889255 |
| minecraft:behavior.charge_held_item | 9534738104831396526 |
| minecraft:behavior.circle_around_anchor | 6362218630635387278 |
| minecraft:behavior.controlled_by_player | 17455778614872480612 |
| minecraft:behavior.croak | 13695866816529218596 |
| minecraft:behavior.defend_trusted_target | 2070046390 |
| minecraft:behavior.defend_village_target | 5237560637228864639 |
| minecraft:behavior.delayed_attack | 16686103324935382281 |
| minecraft:behavior.dig | 18229463342171064186 |
| minecraft:behavior.door_interact | -286762735 |
| minecraft:behavior.dragonchargeplayer | 3000393824704693780 |
| minecraft:behavior.dragondeath | -1541162059 |
| minecraft:behavior.dragonflaming | 17923055218634571091 |
| minecraft:behavior.dragonholdingpattern | 1066617362 |
| minecraft:behavior.dragonlanding | -152352492 |
| minecraft:behavior.dragonscanning | -1003941066 |
| minecraft:behavior.dragonstrafeplayer | 18364378208758607551 |
| minecraft:behavior.dragontakeoff | -1912535317 |
| minecraft:behavior.drink_milk | 14686590835698253470 |
| minecraft:behavior.drink_potion | 277029334 |
| minecraft:behavior.drop_item_for | 6288016308568137423 |
| minecraft:behavior.eat_block | 13717849383294281770 |
| minecraft:behavior.eat_carried_item | -184757575 |
| minecraft:behavior.eat_mob | 6189417788331940525 |
| minecraft:behavior.emerge | 12499259831953635711 |
| minecraft:behavior.enderman_leave_block | -717580550 |
| minecraft:behavior.enderman_take_block | -537294220 |
| minecraft:behavior.equip_item | 13771509599928214056 |
| minecraft:behavior.explore_outskirts | 1573426610843290210 |
| minecraft:behavior.fertilize_farm_block | 9206289212958280677 |
| minecraft:behavior.find_cover | -1231227755 |
| minecraft:behavior.find_mount | 731306871 |
| minecraft:behavior.find_underwater_treasure | -1602192311 |
| minecraft:behavior.flee_sun | -617664229 |
| minecraft:behavior.float | 1758503000 |
| minecraft:behavior.float_wander | -1122048364 |
| minecraft:behavior.follow_caravan | 9936402 |
| minecraft:behavior.follow_mob | -1524701626 |
| minecraft:behavior.follow_owner | 1213259599 |
| minecraft:behavior.follow_parent | 2127040136 |
| minecraft:behavior.follow_target_captain | -135480526 |
| minecraft:behavior.go_and_give_items_to_noteblock | 4654150191236239757 |
| minecraft:behavior.go_and_give_items_to_owner | 12205890323878762703 |
| minecraft:behavior.go_home | 16188843613883396158 |
| minecraft:behavior.guardian_attack | 10035257602683297598 |
| minecraft:behavior.harvest_farm_block | 10346419677401805698 |
| minecraft:behavior.hide | -1101331718 |
| minecraft:behavior.hold_ground | 1804286487 |
| minecraft:behavior.hurt_by_target | -1710404297 |
| minecraft:behavior.inspect_bookshelf | 40191182 |
| minecraft:behavior.investigate_suspicious_location | 17828766620487298865 |
| minecraft:behavior.jump_to_block | 9920654059703051752 |
| minecraft:behavior.knockback_roar | 10556128811593022910 |
| minecraft:behavior.lay_down | -2074934675 |
| minecraft:behavior.lay_egg | -1207740530 |
| minecraft:behavior.leap_at_target | 256926956 |
| minecraft:behavior.look_at_entity | -1735428573 |
| minecraft:behavior.look_at_player | -1892159379 |
| minecraft:behavior.look_at_target | -885375871 |
| minecraft:behavior.look_at_trading_player | -2094605693 |
| minecraft:behavior.make_love | -1551283431 |
| minecraft:behavior.melee_attack | 11509785650956819759 |
| minecraft:behavior.melee_box_attack | 16943510645914782909 |
| minecraft:behavior.mingle | 385775952 |
| minecraft:behavior.mount_pathing | 1112137677 |
| minecraft:behavior.move_indoors | 15759011189030877060 |
| minecraft:behavior.move_outdoors | 13363481534821336549 |
| minecraft:behavior.move_through_village | 779377630 |
| minecraft:behavior.move_to_block | -342788833 |
| minecraft:behavior.move_to_land | -943551837 |
| minecraft:behavior.move_to_lava | -945036492 |
| minecraft:behavior.move_to_liquid | 635836098 |
| minecraft:behavior.move_to_poi | -1614682114 |
| minecraft:behavior.move_to_random_block | 395022171 |
| minecraft:behavior.move_to_village | -805189394 |
| minecraft:behavior.move_to_water | 1886139445 |
| minecraft:behavior.move_towards_dwelling_restriction | 4996579375027897212 |
| minecraft:behavior.move_towards_home_restriction | 6619321617752047371 |
| minecraft:behavior.move_towards_target | -166537884 |
| minecraft:behavior.nap | 992184933 |
| minecraft:behavior.nearest_attackable_target | 5824270165841165755 |
| minecraft:behavior.nearest_prioritized_attackable_target | 335414683 |
| minecraft:behavior.ocelot_sit_on_block | -1327999383 |
| minecraft:behavior.ocelotattack | 6119969836310458450 |
| minecraft:behavior.offer_flower | 14523794672066366898 |
| minecraft:behavior.open_door | -906200433 |
| minecraft:behavior.owner_hurt_by_target | 530667419 |
| minecraft:behavior.owner_hurt_target | 995655261 |
| minecraft:behavior.panic | -169886247 |
| minecraft:behavior.peek | 211304085 |
| minecraft:behavior.pet_sleep_with_owner | 1379392240 |
| minecraft:behavior.pickup_items | 644287189 |
| minecraft:behavior.play | 9028661884418335188 |
| minecraft:behavior.play_dead | 15611122012431414539 |
| minecraft:behavior.player_ride_tamed | 603869698 |
| minecraft:behavior.raid_garden | -1145687602 |
| minecraft:behavior.ram_attack | 16987281751541937759 |
| minecraft:behavior.random_breach | 928528911 |
| minecraft:behavior.random_fly | -446385505 |
| minecraft:behavior.random_hover | -1797323808 |
| minecraft:behavior.random_look_around | 1177762851 |
| minecraft:behavior.random_look_around_and_sit | -1368070166 |
| minecraft:behavior.random_search_and_dig | 9274891347700307903 |
| minecraft:behavior.random_sitting | 1722716662 |
| minecraft:behavior.random_stroll | -1643504294 |
| minecraft:behavior.random_swim | -1465281278 |
| minecraft:behavior.ranged_attack | 17427060681688556526 |
| minecraft:behavior.receive_love | 1156694272 |
| minecraft:behavior.restrict_open_door | 715583988 |
| minecraft:behavior.restrict_sun | -382716017 |
| minecraft:behavior.rise_to_liquid_level | -950950337 |
| minecraft:behavior.roar | 8169564995138049594 |
| minecraft:behavior.roll | 817471653 |
| minecraft:behavior.run_around_like_crazy | -1390363669 |
| minecraft:behavior.scared | -1643945926 |
| minecraft:behavior.send_event | -823429137 |
| minecraft:behavior.share_items | 2045906118 |
| minecraft:behavior.silverfish_merge_with_stone | 321908121 |
| minecraft:behavior.silverfish_wake_up_friends | 484391748 |
| minecraft:behavior.skeleton_horse_trap | 530952387 |
| minecraft:behavior.sleep | -1811763 |
| minecraft:behavior.slime_attack | 9939462702916185623 |
| minecraft:behavior.slime_float | 3498887529883213515 |
| minecraft:behavior.slime_keep_on_jumping | 9635607836508236313 |
| minecraft:behavior.slime_random_direction | 16233644158771707634 |
| minecraft:behavior.snacking | 875141064 |
| minecraft:behavior.sneeze | 1528584076 |
| minecraft:behavior.sniff | 2518751594793034670 |
| minecraft:behavior.sonic_boom | 3140959826915046776 |
| minecraft:behavior.squid_dive | 1626998843 |
| minecraft:behavior.squid_flee | 1304043261 |
| minecraft:behavior.squid_idle | 1741234679 |
| minecraft:behavior.squid_move_away_from_ground | 892387674 |
| minecraft:behavior.squid_out_of_water | -1347598607 |
| minecraft:behavior.stalk_and_pounce_on_target | -1248479202 |
| minecraft:behavior.stay_near_noteblock | 10537868669633006624 |
| minecraft:behavior.stay_while_sitting | 1346980478 |
| minecraft:behavior.stomp_attack | 2494714009520253728 |
| minecraft:behavior.stomp_turtle_egg | 851839416 |
| minecraft:behavior.stroll_towards_village | -1563831906 |
| minecraft:behavior.summon_entity | -2005850647 |
| minecraft:behavior.swell | -1473132493 |
| minecraft:behavior.swim_idle | 6562850329755828441 |
| minecraft:behavior.swim_wander | 12378924708543723854 |
| minecraft:behavior.swim_with_entity | 10204691344094313319 |
| minecraft:behavior.swoop_attack | 7451467701814397451 |
| minecraft:behavior.take_flower | 16066043784359778497 |
| minecraft:behavior.tempt | 422904556 |
| minecraft:behavior.timer_flag_1 | 9107193206350859182 |
| minecraft:behavior.timer_flag_2 | 9107192106839230971 |
| minecraft:behavior.timer_flag_3 | 9107191007327602760 |
| minecraft:behavior.trade_interest | -574851053 |
| minecraft:behavior.trade_with_player | 13082946109325010651 |
| minecraft:behavior.vex_copy_owner_target | -643459543 |
| minecraft:behavior.vex_random_move | -1117822165 |
| minecraft:behavior.wither_random_attack_pos_goal | -528895885 |
| minecraft:behavior.wither_target_highest_damage | -1065562072 |
| minecraft:behavior.work | 11642413332579264431 |
| minecraft:behavior.work_composter | 8770872254111982548 |
| JSON Name | ID |
|---|---|
| minecraft:attack | 1651346034 |
| minecraft:spell_effects | 523264365 |
| minecraft:strength | 648564399 |
| JSON Name | ID |
|---|---|
| -2078137563 | |
| minecraft:addrider | -1014528905 |
| minecraft:admire_item | -1838165406 |
| minecraft:ageable | 1092934985 |
| minecraft:anger_level | 500775548 |
| minecraft:angry | 725411499 |
| minecraft:annotation.break_door | 2116838963 |
| minecraft:annotation.open_door | 1004733768 |
| minecraft:area_attack | 1169114880 |
| minecraft:attack_cooldown | -1439360398 |
| minecraft:barter | -1660828566 |
| minecraft:block_climber | -505801518 |
| minecraft:block_sensor | 1944169706 |
| minecraft:boostable | -8316315 |
| minecraft:boss | -1309638025 |
| minecraft:break_blocks | -944056304 |
| minecraft:breathable | -707187232 |
| minecraft:breedable | -1616430100 |
| minecraft:bribeable | -2125526908 |
| minecraft:buoyant | -467213736 |
| minecraft:burns_in_daylight | 1256874605 |
| minecraft:can_join_raid | -1847990870 |
| minecraft:celebrate_hunt | -789611239 |
| minecraft:collision_box | -1277663508 |
| minecraft:combat_regeneration | -315365016 |
| minecraft:conditional_bandwidth_optimization | 1333085468 |
| minecraft:custom_hit_test | 2035968892 |
| minecraft:damage_over_time | -656420526 |
| minecraft:damage_sensor | -82616534 |
| minecraft:dash | -51257122 |
| minecraft:despawn | 1674909940 |
| minecraft:drying_out_timer | 2113510784 |
| minecraft:economy_trade_table | 1705466896 |
| minecraft:entity_sensor | -406052184 |
| minecraft:environment_sensor | 687748970 |
| minecraft:equip_item | -1774220620 |
| minecraft:equippable | -1164142226 |
| minecraft:exhaustion_values | 1522147793 |
| minecraft:experience_reward | -1992597900 |
| minecraft:explode | -1683058581 |
| minecraft:flocking | 1967597361 |
| minecraft:game_event_movement_tracking | 763815151 |
| minecraft:genetics | -82484670 |
| minecraft:giveable | 1739199795 |
| minecraft:group_size | -1997375941 |
| minecraft:grows_crop | 43636353 |
| minecraft:healable | -54247424 |
| minecraft:heartbeat | 2102942906 |
| minecraft:home | 610829097 |
| minecraft:hurt_on_condition | 163715083 |
| minecraft:inside_block_notifier | -377593253 |
| minecraft:insomnia | -300455606 |
| minecraft:instant_despawn | -634288138 |
| minecraft:interact | -1996861528 |
| minecraft:inventory | 1941951218 |
| minecraft:item_hopper | -447601772 |
| minecraft:jump.dynamic | 945664737 |
| minecraft:jump.static | 1064987526 |
| minecraft:leashable | 893445039 |
| minecraft:lookat | -1329707008 |
| minecraft:managed_wandering_trader | 846609640 |
| minecraft:mob_effect | 490430596 |
| minecraft:mob_effect_immunity | 1589547531 |
| minecraft:movement.amphibious | -500784850 |
| minecraft:movement.basic | 3354475 |
| minecraft:movement.fly | -1487316136 |
| minecraft:movement.generic | -1363369868 |
| minecraft:movement.hover | 1743805051 |
| minecraft:movement.jump | 1256268727 |
| minecraft:movement.skip | -1828832272 |
| minecraft:movement.sway | 2126249079 |
| minecraft:nameable | -595398763 |
| minecraft:navigation.climb | -1075360945 |
| minecraft:navigation.float | -842998036 |
| minecraft:navigation.fly | -1997823129 |
| minecraft:navigation.generic | 1768002583 |
| minecraft:navigation.hover | -769247640 |
| minecraft:navigation.swim | 1908076634 |
| minecraft:navigation.walk | 1909033775 |
| minecraft:npc | 1140005505 |
| minecraft:out_of_control | -639930856 |
| minecraft:peek | -863721039 |
| minecraft:persistent | 1435858387 |
| minecraft:physics | 1021552959 |
| minecraft:preferred_path | 1431188951 |
| minecraft:projectile | 1922456869 |
| minecraft:pushable | -1784639134 |
| minecraft:raid_trigger | 2093209329 |
| minecraft:rail_movement | -78235634 |
| minecraft:rail_sensor | 1273161273 |
| minecraft:ravager_blocked | -1417579541 |
| minecraft:reflect_projectiles | -2073986952 |
| minecraft:rideable | 1656173828 |
| minecraft:scale_by_age | 64881972 |
| minecraft:scheduler | -684492525 |
| minecraft:shareables | 1301057082 |
| minecraft:shooter | 184150118 |
| minecraft:sittable | -1376274106 |
| minecraft:spawn_entity | 1991964333 |
| minecraft:suspect_tracking | 690744457 |
| minecraft:tameable | 932870003 |
| minecraft:tamemount | 1615660288 |
| minecraft:target_nearby_sensor | 1309819882 |
| minecraft:teleport | -1900891127 |
| minecraft:tick_world | -381759296 |
| minecraft:timer | 1862095863 |
| minecraft:trade_table | 50480315 |
| minecraft:trail | 1632590434 |
| minecraft:transformation | -457894577 |
| minecraft:trusting | 936499892 |
| minecraft:variable_max_auto_step | -368684982 |
| minecraft:vibration_damper | 1836172792 |
| minecraft:vibration_listener | 1844567337 |
| minecraft:water_movement | -128701925 |
| JSON Name | ID |
|---|---|
| animations | 1232311658 |
| scripts | -76244517 |
| JSON Name | ID |
|---|---|
| minecraft:ambient_sound_interval | -1314051310 |
| minecraft:body_rotation_blocked | -31742338 |
| minecraft:can_climb | -550459594 |
| minecraft:can_fly | 985724318 |
| minecraft:can_power_jump | -763124853 |
| minecraft:color | 1069623177 |
| minecraft:color2 | 1429635777 |
| minecraft:default_look_angle | -815556357 |
| minecraft:equipment | 714661022 |
| minecraft:fire_immune | -1071767182 |
| minecraft:floats_in_liquid | 179778474 |
| minecraft:flying_speed | -570508595 |
| minecraft:friction_modifier | -714364556 |
| minecraft:ground_offset | -1816881803 |
| minecraft:input_ground_controlled | -646415617 |
| minecraft:is_baby | 1853172763 |
| minecraft:is_charged | 125340337 |
| minecraft:is_chested | -817599379 |
| minecraft:is_dyeable | 1381448355 |
| minecraft:is_hidden_when_invisible | -1553744 |
| minecraft:is_ignited | 905710223 |
| minecraft:is_illager_captain | 921912694 |
| minecraft:is_pregnant | -1253700046 |
| minecraft:is_saddled | 1037901616 |
| minecraft:is_shaking | 523951884 |
| minecraft:is_sheared | 1154836813 |
| minecraft:is_stackable | 1184456737 |
| minecraft:is_stunned | 1818977510 |
| minecraft:is_tamed | 1646421078 |
| minecraft:item_controllable | 1868311069 |
| minecraft:loot | 1775814032 |
| minecraft:mark_variant | 663621689 |
| minecraft:movement_sound_distance_offset | 124679519 |
| minecraft:push_through | -138030768 |
| minecraft:scale | 77854436 |
| minecraft:skin_id | 1838729593 |
| minecraft:sound_volume | 937951776 |
| minecraft:type_family | -255011285 |
| minecraft:variant | -1789583977 |
| minecraft:walk_animation_speed | 972393614 |
| minecraft:wants_jockey | 1832515141 |
| JSON Name | ID |
|---|---|
| minecraft:on_death | -49357854 |
| minecraft:on_friendly_anger | -1009986313 |
| minecraft:on_hurt | -1028603471 |
| minecraft:on_hurt_by_player | -599009831 |
| minecraft:on_ignite | -1911489054 |
| minecraft:on_start_landing | -555648368 |
| minecraft:on_start_takeoff | 426083399 |
| minecraft:on_target_acquired | 1063277906 |
| minecraft:on_target_escape | -1373130027 |
| minecraft:on_wake_with_owner | -1543219003 |
Sets the entity's delay between playing its ambient sound.
| Name | Type | Default Value | Description |
|---|---|---|---|
| event_name | String | ambient | Level sound event to be played as the ambient sound. |
| event_names | Array | List of dynamic level sound events, with conditions for choosing between them. Evaluated in order, first one wins. If none evaluate to true, 'event_name' will take precedence.conditionThe condition that must be satisfied to select the given ambient soundevent_nameLevel sound event to be played as the ambient sound |
|
| range | Decimal | 16.000000 | Maximum time in seconds to randomly add to the ambient sound delay time. |
| value | Decimal | 8.000000 | Minimum time in seconds before the entity plays its ambient sound again. |
When set, the entity will no longer visually rotate their body to match their facing direction.
Allows this entity to climb up ladders.
Marks the entity as being able to fly, the pathfinder won't be restricted to paths where a solid block is required underneath it.
Allows the entity to power jump like the horse does in vanilla.
Defines the entity's color. Only works on vanilla entities that have predefined color values (sheep, llama, shulker).
| Name | Type | Default Value | Description |
|---|---|---|---|
| value | Integer | 0 | The Palette Color value of the entity. |
Defines the entity's second texture color. Only works on vanilla entities that have a second predefined color values (tropical fish).
| Name | Type | Default Value | Description |
|---|---|---|---|
| value | Integer | 0 | The second Palette Color value of the entity. |
Sets this entity's default head rotation angle.
| Name | Type | Default Value | Description |
|---|---|---|---|
| value | Decimal | 0.0f | Angle in degrees. |
Sets the Equipment table to use for this Entity.
| Name | Type | Default Value | Description |
|---|---|---|---|
| slot_drop_chance | List | A list of slots with the chance to drop an equipped item from that slot. | |
| table | String | The file path to the equipment table, relative to the behavior pack's root. |
Sets that this entity doesn't take damage from fire.
Sets that this entity can float in liquid blocks.
Speed in Blocks that this entity flies at.
| Name | Type | Default Value | Description |
|---|---|---|---|
| value | Decimal | 0.02 | Flying speed in blocks per tick. |
Defines how much friction affects this entity.
| Name | Type | Default Value | Description |
|---|---|---|---|
| value | Decimal | 1.0 | The higher the number, the more the friction affects this entity. A value of 1.0 means regular friction, while 2.0 means twice as much. |
Sets the offset from the ground that the entity is actually at.
| Name | Type | Default Value | Description |
|---|---|---|---|
| value | Decimal | 0.0 | The value of the entity's offset from the terrain, in blocks. |
When configured as a rideable entity, the entity will be controlled using WASD controls. Beginning with 1.19.50 the default auto step height for rideable entities is half a block. Consider adding the `variable_max_auto_step` component to increase it.
Sets that this entity is a baby.
Sets that this entity is charged.
Sets that this entity is currently carrying a chest.
Allows dyes to be used on this entity to change its color.
| Name | Type | Default Value | Description |
|---|---|---|---|
| interact_text | String | The text that will display when interacting with this entity with a dye when playing with Touch-screen controls. |
Sets that this entity can hide from hostile mobs while invisible.
Sets that this entity is currently on fire.
Sets that this entity is an illager captain.
Sets that this entity is currently pregnant.
Sets that this entity is currently saddled.
Sets that this entity is currently shaking.
Sets that this entity is currently sheared.
Sets that this entity can be stacked.
Sets that this entity is currently stunned.
Sets that this entity is currently tamed.
Defines what items can be used to control this entity while ridden.
| Name | Type | Default Value | Description |
|---|---|---|---|
| control_items | List | List of items that can be used to control this entity. |
Sets the loot table for what items this entity drops upon death.
| Name | Type | Default Value | Description |
|---|---|---|---|
| table | String | The path to the loot table, relative to the Behavior Pack's root. |
Additional variant value. Can be used to further differentiate variants.
| Name | Type | Default Value | Description |
|---|---|---|---|
| value | Integer | 0 | The ID of the variant. By convention, 0 is the ID of the base entity. |
Sets the offset used to determine the next step distance for playing a movement sound.
| Name | Type | Default Value | Description |
|---|---|---|---|
| value | Decimal | 1.0 | The higher the number, the less often the movement sound will be played. |
Sets the distance through which the entity can push through.
| Name | Type | Default Value | Description |
|---|---|---|---|
| value | Decimal | 0.0 | The value of the entity's push-through, in blocks. |
Sets the entity's visual size.
| Name | Type | Default Value | Description |
|---|---|---|---|
| value | Decimal | 1.0 | The value of the scale. 1.0 means the entity will appear at the scale they are defined in their model. Higher numbers make the entity bigger. |
Skin ID value. Can be used to differentiate skins, such as base skins for villagers.
| Name | Type | Default Value | Description |
|---|---|---|---|
| value | Integer | 0 | The ID of the skin. By convention, 0 is the ID of the base skin. |
Sets the entity's base volume for sound effects.
| Name | Type | Default Value | Description |
|---|---|---|---|
| value | Decimal | 1.0 | The value of the volume the entity uses for sound effects. |
Defines the families this entity belongs to.
| Name | Type | Default Value | Description |
|---|---|---|---|
| family | List | List of family names. |
Used to differentiate the component group of a variant of an entity from others. (e.g. ocelot, villager)
| Name | Type | Default Value | Description |
|---|---|---|---|
| value | Integer | 0 | The ID of the variant. By convention, 0 is the ID of the base entity. |
Sets the speed multiplier for this entity's walk animation speed.
| Name | Type | Default Value | Description |
|---|---|---|---|
| value | Decimal | 1.0 | The higher the number, the faster the animation for walking plays. A value of 1.0 means normal speed, while 2.0 means twice as fast. |
Sets that this entity wants to become a jockey.
Only usable by the Ender Dragon. Adds a trigger to call on this entity's death.
| Name | Type | Default Value | Description |
|---|---|---|---|
| event | String | The event to run when the conditions for this trigger are met. | |
| filters | Minecraft Filter | The list of conditions for this trigger to execute. | |
| target | String | self | The target of the event. |
Adds a trigger that will run when a nearby entity of the same type as this entity becomes Angry.
| Name | Type | Default Value | Description |
|---|---|---|---|
| event | String | The event to run when the conditions for this trigger are met. | |
| filters | Minecraft Filter | The list of conditions for this trigger to execute. | |
| target | String | self | The target of the event. |
Adds a trigger to call when this entity takes damage.
| Name | Type | Default Value | Description |
|---|---|---|---|
| event | String | The event to run when the conditions for this trigger are met. | |
| filters | Minecraft Filter | The list of conditions for this trigger to execute. | |
| target | String | self | The target of the event. |
Adds a trigger to call when this entity is attacked by the player.
| Name | Type | Default Value | Description |
|---|---|---|---|
| event | String | The event to run when the conditions for this trigger are met. | |
| filters | Minecraft Filter | The list of conditions for this trigger to execute. | |
| target | String | self | The target of the event. |
Adds a trigger to call when this entity is set on fire.
| Name | Type | Default Value | Description |
|---|---|---|---|
| event | String | The event to run when the conditions for this trigger are met. | |
| filters | Minecraft Filter | The list of conditions for this trigger to execute. | |
| target | String | self | The target of the event. |
Only usable by the Ender Dragon. Adds a trigger to call when this entity lands.
| Name | Type | Default Value | Description |
|---|---|---|---|
| event | String | The event to run when the conditions for this trigger are met. | |
| filters | Minecraft Filter | The list of conditions for this trigger to execute. | |
| target | String | self | The target of the event. |
Only usable by the Ender Dragon. Adds a trigger to call when this entity starts flying.
| Name | Type | Default Value | Description |
|---|---|---|---|
| event | String | The event to run when the conditions for this trigger are met. | |
| filters | Minecraft Filter | The list of conditions for this trigger to execute. | |
| target | String | self | The target of the event. |
Adds a trigger to call when this entity finds a target.
| Name | Type | Default Value | Description |
|---|---|---|---|
| event | String | The event to run when the conditions for this trigger are met. | |
| filters | Minecraft Filter | The list of conditions for this trigger to execute. | |
| target | String | self | The target of the event. |
Adds a trigger to call when this entity loses the target it currently has.
| Name | Type | Default Value | Description |
|---|---|---|---|
| event | String | The event to run when the conditions for this trigger are met. | |
| filters | Minecraft Filter | The list of conditions for this trigger to execute. | |
| target | String | self | The target of the event. |
Adds a trigger to call when this pet's owner awakes after sleeping with the pet.
| Name | Type | Default Value | Description |
|---|---|---|---|
| event | String | The event to run when the conditions for this trigger are met. | |
| filters | Minecraft Filter | The list of conditions for this trigger to execute. | |
| target | String | self | The target of the event. |
