Version: 1.2.9.1

Index#

Entity Definition Properties#

Description

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.

do_not_upgrade#

Description

Disables all current and future backwards compatibility for this entity. If new components or properties are added or changed to the vanilla version of this entity, they will not be applied.

format_version#

Description

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.

Vanilla entities that use this

{ "minecraft:entity": { "format_version": "1.2.0", "do_not_upgrade": {}, "component_groups": {...} ...}

Attributes#

minecraft:attack#

Description

Defines an entity's melee attack and any additional effects on it.

Parameters

Name	Type	Default Value	Description
damage	Range [a, b]		Range of the random amount of damage the melee attack deals
effect_duration	Decimal	0.0	Duration in seconds of the status ailment applied to the damaged entity
effect_name	String		Name of the status ailment to apply to an entity attacked by this entity's melee attack

minecraft:spell_effects#

Description

Defines what mob effects to add and remove to the entity when adding this component.

Parameters

Name	Type	Default Value	Description
add_effects	List		List of effects to add to this entity after adding this component Name Type Default Value Description effect String Effect to add to this entity. Includes 'duration' in seconds, 'amplifier' level, 'ambient' if it is to be considered an ambient effect, and 'visible' if the effect should be visible
remove_effects	String		List of names of effects to be removed from this entity after adding this component

minecraft:strength#

Description

Defines the entity's strength to carry items.

Parameters

Name	Type	Default Value	Description
max	Integer	5	The maximum strength of this entity
value	Integer	1	The initial value of the strength

Properties#

minecraft:ambient_sound_interval#

Description

Sets the entity's delay between playing its ambient sound.

Parameters

Name	Type	Default Value	Description
range	Decimal	16.0	Maximum time is seconds to randomly add to the ambient sound delay time.
value	Decimal	8.0	Minimum time in seconds before the entity plays its ambient sound again

minecraft:burns_in_daylight#

Description

Sets that this entity burns if exposed to daylight.

minecraft:can_climb#

Description

Allows this entity to climb up ladders.

minecraft:can_fly#

Description

Marks the entity as being able to fly, the pathfinder won't be restricted to paths where a solid block is required underneath it.

minecraft:can_power_jump#

Description

Allows the entity to power jump like the horse does in vanilla.

minecraft:collision_box#

Description

Sets the width and height of the Entity's collision box.

Parameters

Name	Type	Default Value	Description
height	Decimal	1.0	Height of the Collision Box in Blocks
width	Decimal	1.0	Width and Depth of the Collision Box in Blocks

minecraft:color#

Description

Defines the entity's color. Only works on vanilla entities that have predefined color values (sheep, llama, shulker).

Parameters

Name	Type	Default Value	Description
value	Integer	0	The Palette Color value of the entity

minecraft:default_look_angle#

Description

Sets this entity's default head rotation angle.

Parameters

Name	Type	Default Value	Description
value	Decimal	0.0f	Angle in degrees

minecraft:equipment#

Description

Sets the Equipment table to use for this Entity.

Parameters

Name	Type	Default Value	Description
table	String		The path to the equipment table, relative to the Behavior Pack's root

minecraft:fire_immune#

Description

Sets that this entity doesn't take damage from fire.

minecraft:floats_in_liquid#

Description

Sets that this entity can float in liquid blocks.

minecraft:flying_speed#

Description

Speed in Blocks that this entity flies at.

Parameters

Name	Type	Default Value	Description
value	Decimal	0.02	Flying speed in blocks per tick

minecraft:foot_size#

Description

Sets the number of blocks the entity can step without jumping.

Parameters

Name	Type	Default Value	Description
value	Decimal	0.5	The value of the size of the entity's step

minecraft:friction_modifier#

Description

Defines how much does friction affect this entity.

Parameters

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

minecraft:ground_offset#

Description

Sets the offset from the ground that the entity is actually at.

Parameters

Name	Type	Default Value	Description
value	Decimal	0.0	The value of the entity's offset from the terrain, in blocks

minecraft:hurt_when_wet#

Description

Sets that this entity will take damage when it is wet.

minecraft:input_ground_controlled#

Description

When configured as a rideable entity, the entity will be controlled using WASD controls.

minecraft:is_baby#

Description

Sets that this entity is a baby.

minecraft:is_charged#

Description

Sets that this entity is charged.

minecraft:is_chested#

Description

Sets that this entity is currently carrying a chest.

minecraft:is_dyeable#

Description

Allows dyes to be used on this entity to change its color.

Parameters

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

minecraft:is_ignited#

Description

Sets that this entity is currently on fire.

minecraft:is_saddled#

Description

Sets that this entity is currently saddled.

minecraft:is_shaking#

Description

Sets that this entity is currently shaking.

minecraft:is_sheared#

Description

Sets that this entity is currently sheared.

minecraft:is_stackable#

Description

Sets that this entity can be stacked.

minecraft:is_tamed#

Description

Sets that this entity is currently tamed.

minecraft:item_controllable#

Description

Defines what items can be used to control this entity while ridden

Parameters

Name	Type	Default Value	Description
control_items	List		List of items that can be used to control this entity

minecraft:loot#

Description

Sets the loot table for what items this entity drops upon death.

Parameters

Name	Type	Default Value	Description
table	String		The path to the loot table, relative to the Behavior Pack's root

minecraft:mark_variant#

Description

Additional variant value. Can be used to further differentiate variants.

Parameters

Name	Type	Default Value	Description
value	Integer	0	The ID of the variant. By convention, 0 is the ID of the base entity

minecraft:push_through#

Description

Sets the distance through which the entity can push through.

Parameters

Name	Type	Default Value	Description
value	Decimal	0.0	The value of the entity's push-through, in blocks

minecraft:scale#

Description

Sets the entity's visual size.

Parameters

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

minecraft:sound_volume#

Description

Sets the entity's base volume for sound effects.

Parameters

Name	Type	Default Value	Description
value	Decimal	1.0	The value of the volume the entity uses for sound effects

minecraft:type_family#

Description

Defines the families this entity belongs to.

Parameters

Name	Type	Default Value	Description
family	List		List of family names

minecraft:variant#

Description

Used to differentiate the component group of a variant of an entity from others (e.g. ocelot, villager)

Parameters

Name	Type	Default Value	Description
value	Integer	0	The ID of the variant. By convention, 0 is the ID of the base entity

minecraft:walk_animation_speed#

Description

Sets the speed multiplier for this entity's walk animation speed.

Parameters

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

minecraft:wants_jockey#

Description

Sets that this entity wants to become a jockey.

Component IDs#

JSON Name	ID
	0
minecraft:addrider	-1014528905
minecraft:ageable	1092934985
minecraft:ambient_sound_interval	-1314051310
minecraft:angry	725411499
minecraft:attack	1651346034
minecraft:behavior.avoid_mob_type	386517767
minecraft:behavior.beg	1346418048
minecraft:behavior.break_door	-1798237626
minecraft:behavior.breed	51166360
minecraft:behavior.charge_attack	-1921442265
minecraft:behavior.controlled_by_player	1633000292
minecraft:behavior.defend_village_target	1469600895
minecraft:behavior.door_interact	-286762735
minecraft:behavior.dragonchargeplayer	1808565780
minecraft:behavior.dragondeath	-1541162059
minecraft:behavior.dragonflaming	-865288877
minecraft:behavior.dragonholdingpattern	1066617362
minecraft:behavior.dragonlanding	-152352492
minecraft:behavior.dragonscanning	-1003941066
minecraft:behavior.dragonstrafeplayer	-1510265153
minecraft:behavior.dragontakeoff	-1912535317
minecraft:behavior.eat_block	1972447274
minecraft:behavior.enderman_leave_block	-717580550
minecraft:behavior.enderman_take_block	-537294220
minecraft:behavior.find_mount	731306871
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.guardian_attack	-579215554
minecraft:behavior.harvest_farm_block	10843010
minecraft:behavior.hurt_by_target	-1710404297
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	1848335663
minecraft:behavior.mount_pathing	1112137677
minecraft:behavior.move_indoors	2107078532
minecraft:behavior.move_through_village	779377630
minecraft:behavior.move_towards_restriction	1288087401
minecraft:behavior.move_towards_target	-166537884
minecraft:behavior.nearest_attackable_target	-2032255557
minecraft:behavior.ocelot_sit_on_block	-1327999383
minecraft:behavior.ocelotattack	560197714
minecraft:behavior.offer_flower	-885387854
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.pickup_items	644287189
minecraft:behavior.play	-505601580
minecraft:behavior.player_ride_tamed	603869698
minecraft:behavior.raid_garden	-1145687602
minecraft:behavior.random_fly	-446385505
minecraft:behavior.random_look_around	1177762851
minecraft:behavior.random_stroll	-1643504294
minecraft:behavior.ranged_attack	-2093407250
minecraft:behavior.receive_love	1156694272
minecraft:behavior.restrict_open_door	715583988
minecraft:behavior.restrict_sun	-382716017
minecraft:behavior.run_around_like_crazy	-1390363669
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.slime_attack	-1315951081
minecraft:behavior.slime_float	-1480876341
minecraft:behavior.slime_keep_on_jumping	-1844762087
minecraft:behavior.slime_random_direction	1437515506
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.stay_while_sitting	1346980478
minecraft:behavior.stomp_attack	-1851446496
minecraft:behavior.summon_entity	-2005850647
minecraft:behavior.swell	-1473132493
minecraft:behavior.take_flower	1218648257
minecraft:behavior.tempt	422904556
minecraft:behavior.trade_with_player	-2048563493
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:boostable	-8316315
minecraft:breathable	-707187232
minecraft:breedable	-1616430100
minecraft:burns_in_daylight	1256874605
minecraft:can_climb	-550459594
minecraft:can_fly	985724318
minecraft:can_power_jump	-763124853
minecraft:collision_box	-1277663508
minecraft:color	1069623177
minecraft:damage_sensor	-82616534
minecraft:default_look_angle	-815556357
minecraft:environment_sensor	687748970
minecraft:equipment	714661022
minecraft:equippable	-1164142226
minecraft:explode	-1683058581
minecraft:fire_immune	-1071767182
minecraft:floats_in_liquid	179778474
minecraft:flying_speed	-570508595
minecraft:foot_size	1133270874
minecraft:friction_modifier	-714364556
minecraft:ground_offset	-1816881803
minecraft:healable	-54247424
minecraft:hurt_when_wet	237531867
minecraft:input_ground_controlled	-646415617
minecraft:interact	-1996861528
minecraft:inventory	1941951218
minecraft:is_baby	1853172763
minecraft:is_charged	125340337
minecraft:is_chested	-817599379
minecraft:is_dyeable	1381448355
minecraft:is_ignited	905710223
minecraft:is_saddled	1037901616
minecraft:is_shaking	523951884
minecraft:is_sheared	1154836813
minecraft:is_stackable	1184456737
minecraft:is_tamed	1646421078
minecraft:item_controllable	1868311069
minecraft:item_hopper	-447601772
minecraft:jump.dynamic	945664737
minecraft:jump.static	1064987526
minecraft:leashable	893445039
minecraft:lookat	-1329707008
minecraft:loot	1775814032
minecraft:mark_variant	663621689
minecraft:movement.basic	3354475
minecraft:movement.fly	-1487316136
minecraft:movement.jump	1256268727
minecraft:movement.skip	-1828832272
minecraft:movement.sway	0
minecraft:nameable	-595398763
minecraft:navigation.climb	-1075360945
minecraft:navigation.float	-842998036
minecraft:navigation.fly	-1997823129
minecraft:navigation.swim	1908076634
minecraft:navigation.walk	1909033775
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:peek	-863721039
minecraft:physics	0
minecraft:projectile	1922456869
minecraft:push_through	-138030768
minecraft:rail_movement	-78235634
minecraft:rail_sensor	1273161273
minecraft:rideable	1656173828
minecraft:scale	77854436
minecraft:scale_by_age	64881972
minecraft:shareables	1301057082
minecraft:shooter	184150118
minecraft:sittable	-1376274106
minecraft:sound_volume	937951776
minecraft:spawn_entity	1991964333
minecraft:spell_effects	523264365
minecraft:strength	648564399
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:transformation	-457894577
minecraft:type_family	-255011285
minecraft:variant	-1789583977
minecraft:walk_animation_speed	972393614
minecraft:wants_jockey	1832515141

Components#

minecraft:addrider#

Description

Adds a rider to the entity. Requires minecraft:rideable.

Parameters

Name	Type	Default Value	Description
entity_type	String		The entity type that will be riding this entity

minecraft:ageable#

Description

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.

Parameters

Name	Type	Default Value	Description
duration	Decimal	1200.0	Amount of time before the entity grows
feedItems	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

minecraft:angry#

Description

Defines the entity's 'angry' state using a timer.

Parameters

Name	Type	Default Value	Description
broadcastAnger	Boolean	false	If true, other entities of the same entity definition within the broadcastRange will also become angry
broadcastRange	Integer	20	Distance in blocks within which other entities of the same entity definition will become angry
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

minecraft:boostable#

Description

Defines the conditions and behavior of a rideable entity's boost

Parameters

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: Name Type Default Value Description damage Integer 1 This is the damage that the item will take each time it is used item String Name of the item that can be used to boost replaceItem String The item used to boost will become this item once it is used up
duration	Integer	3	Time in seconds for the boost
speed_multiplier	Decimal	1.0	Factor by which the entity's normal speed increases. E.g. 2.0 means go twice as fast

minecraft:breathable#

Description

Defines what blocks this entity can breathe in and gives them the ability to suffocate

Parameters

Name	Type	Default Value	Description
breatheBlocks	List		List of blocks this entity can breathe in, in addition to the above
breathesAir	Boolean	true	If true, this entity can breathe in air
breathesLava	Boolean	false	If true, this entity can breathe in lava
breathesSolids	Boolean	false	If true, this entity can breathe in solid blocks
breathesWater	Boolean	false	If true, this entity can breathe in water
generatesBubbles	Boolean	true	If true, this entity will have visible bubbles while in water
nonBreatheBlocks	List		List of blocks this entity can't breathe in, in addition to the above
suffocateTime	Integer	-20	Time in seconds between suffocation damage
totalSupply	Integer	15	Time in seconds the entity can hold its breath

minecraft:breedable#

Description

Defines the way an entity can get into the 'love' state.

Parameters

Name	Type	Default Value	Description
allowSitting	Boolean	false	If true, entities can breed while sitting
breedCooldown	Decimal	60.0	Time in seconds before the Entity can breed again
breedItems	List		The list of items that can be used to get the entity into the 'love' state
breedsWith	List		The list of entity definitions that this entity can breed with Name Type Default Value Description babyType String The entity definition of this entity's babies breed_event String Event to run when this entity breeds mateType String The entity definition of this entity's mate
extraBabyChance	Decimal	0.0	Chance that up to 16 babies will spawn between 0.0 and 1.0, where 1.0 is 100%
inheritTamed	Boolean	true	If true, the babies will be automatically tamed if its parents are
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 Name Type Default Value Description color Decimal 0.0 The percentage chance of a mutation on the entity's color extra_variant Decimal 0.0 The percentage chance of a mutation on the entity's extra variant type variant Decimal 0.0 The percentage chance of a mutation on the entity's variant type
requireTame	Boolean	true	If true, the entities need to be tamed first before they can breed.

minecraft:damage_sensor#

Description

Defines what events to call when this entity is damaged by specific entities or items. Can be either an array or a single instance.

Parameters

Name	Type	Default Value	Description
cause	String		Type of damage that triggers this set of events
deals_damage	Boolean	true	If true, the damage dealt to the entity will take off health from it. Set to false to make the entity ignore that damage
on_damage	List		List of triggers with the events to call when taking this specific kind of damage. Allows specifying filters for entity definitions and events

minecraft:environment_sensor#

Description

Creates a trigger based on environment conditions.

Parameters

Name	Type	Default Value	Description
on_environment	List		The list of triggers that fire when the environment conditions match the given filter criteria.

minecraft:equippable#

Description

Defines an entity's behavior for having items equipped to it

Parameters

Name	Type	Default Value	Description
slots	List		List of slots and the item that can be equipped Name Type Default Value Description accepted_items List The list of items that can go in this slot interact_text String Text to be displayed when the entity can be equipped with this item when playing with Touch-screen controls item String Name of the item that can be equipped for this slot on_equip String Event to trigger when this entity is equipped with this item on_unequip String Event to trigger when this item is removed from this entity slot Integer 0 The slot number of this slot

minecraft:explode#

Description

Defines how the entity explodes.

Parameters

Name	Type	Default Value	Description
breaks_blocks	Boolean	true	If true, the explosion will destroy blocks in the explosion radius
causesFire	Boolean	false	If true, blocks in the explosion radius will be set on fire
destroyAffectedByGriefing	Boolean	false	If true, whether the explosion breaks blocks is affected by the mob griefing game rule
fireAffectedByGriefing	Boolean	false	If true, whether the explosion causes fire is affected by the mob griefing game rule
fuseLength	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
fuseLit	Boolean	false	If true, the fuse is already lit when this component is added to the entity
maxResistance	Decimal	Infinite	Blocks with less resistance than this value will be broken by the explosion
power	Decimal	3.0	The radius of the explosion in blocks and the amount of damage the explosion deals

minecraft:healable#

Description

Defines the interactions with this entity for healing it.

Parameters

Name	Type	Default Value	Description
items	List		The list of items that can be used to heal this entity Name Type Default Value Description filters Minecraft Filter The list of conditions for this trigger force_use Boolean false Determines if item can be used regardless of entity being full health heal_amount Decimal 1.0 The amount of health this entity gains when fed this item item String Name of the item this entity likes and can be used to heal this entity

minecraft:interact#

Description

Defines interactions with this entity.

Parameters

Name	Type	Default Value	Description
add_items	JSON Object		Loot table with items to add to the player's inventory upon successful interaction Name Type Default Value Description table String File path, relative to the Behavior Pack's path, to the loot table file
cooldown	Decimal	0.0	Time in seconds before this entity can be interacted with again
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_interactor# Description Whether or not the particle will appear closer to who performed the interaction particle_type# Description The type of particle that will be spawned particle_y_offset# Description Will offset the particle this amount in the y direction
play_sounds	String		List of sounds to play when the interaction occurs
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 Name Type Default Value Description table String File path, relative to the Behavior Pack's path, to the loot table file
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

minecraft:inventory#

Description

Defines this entity's inventory properties.

Parameters

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, minecart_hopper, inventory, container or hopper
inventory_size	Integer	5	Number of slots the container has
linked_slots_size	Integer	0	Number of linked slots (e.g. Player Hotbar) the container has
private	Boolean	false	If true, only the entity can access the inventory
restrict_to_owner	Boolean	false	If true, the entity's inventory can only be accessed by its owner or itself

minecraft:item_hopper#

Description

Determines that this entity is an item hopper

minecraft:jump.dynamic#

Description

Defines a dynamic type jump control that will change jump properties based on the speed modifier of the mob.

minecraft:jump.static#

Description

Gives the entity the ability to jump.

minecraft:leashable#

Description

Allows this entity to be leashed and Defines the conditions and events for this entity when is leashed.

Parameters

Name	Type	Default Value	Description
hard_distance	Decimal	6.0	Distance in blocks at which the leash stiffens, restricting movement
max_distance	Decimal	10.0	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.0	Distance in blocks at which the 'spring' effect starts acting to keep this entity close to the entity that leashed it

minecraft:lookat#

Description

Defines the behavior when another entity looks at this entity.

Parameters

Name	Type	Default Value	Description
filters	String	player	Defines the entities that can trigger this component
look_cooldown	Range [a, b]	[0.0, 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		Event to run when the entities specified in filters look at this entity
mAllowInvulnerable	Boolean	false	If true, invulnerable entities (e.g. Players in creative mode) are considered valid targets
searchRadius	Decimal	10.0	Maximum distance this entity will look for another entity looking at it
setTarget	Boolean	true	If true, this entity will set the attack target as the entity that looked at it

minecraft:movement.basic#

Description

This component accents the movement of an entity.

Parameters

Name	Type	Default Value	Description
max_turn	Decimal	30.0	The maximum number in degrees the mob can turn per tick.

minecraft:movement.fly#

Description

This move control causes the mob to fly.

Parameters

Name	Type	Default Value	Description
max_turn	Decimal	30.0	The maximum number in degrees the mob can turn per tick.

minecraft:movement.jump#

Description

Move control that causes the mob to jump as it moves with a specified delay between jumps.

Parameters

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.

minecraft:movement.skip#

Description

This move control causes the mob to hop as it moves.

Parameters

Name	Type	Default Value	Description
max_turn	Decimal	30.0	The maximum number in degrees the mob can turn per tick.

minecraft:movement.sway#

Description

This move control causes the mob to sway side to side giving the impression it is swimming.

Parameters

Name	Type	Default Value	Description
max_turn	Decimal	30.0	The maximum number in degrees the mob can turn per tick.

minecraft:nameable#

Description

Allows this entity to be named (e.g. using a name tag)

Parameters

Name	Type	Default Value	Description
allowNameTagRenaming	Boolean	true	If true, this entity can be renamed with name tags
alwaysShow	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 Name Type Default Value Description name_filter String List of special names that will cause the events defined in 'on_named' to fire on_named String Event to be called when this entity acquires the name specified in 'name_filter'

minecraft:navigation.climb#

Description

Allows this entity to generate paths that include vertical walls like the vanilla Spiders do.

Parameters

Name	Type	Default Value	Description
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
can_float	Boolean	false	Tells the pathfinder whether or not it can float in water
can_open_doors	Boolean	false	Tells the pathfinder that it can path through a closed door assuming the AI will open the door
can_pass_doors	Boolean	true	Whether a path can be created through a door

minecraft:navigation.float#

Description

Allows this entity to generate paths by flying around the air like the regular Ghast.

Parameters

Name	Type	Default Value	Description
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
can_float	Boolean	false	Tells the pathfinder whether or not it can float in water
can_open_doors	Boolean	false	Tells the pathfinder that it can path through a closed door assuming the AI will open the door
can_pass_doors	Boolean	true	Whether a path can be created through a door

minecraft:navigation.fly#

Description

Allows this entity to generate paths in the air like the vanilla Parrots do.

Parameters

Name	Type	Default Value	Description
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
can_float	Boolean	false	Tells the pathfinder whether or not it can float in water
can_open_doors	Boolean	false	Tells the pathfinder that it can path through a closed door assuming the AI will open the door
can_pass_doors	Boolean	true	Whether a path can be created through a door

minecraft:navigation.swim#

Description

Allows this entity to generate paths that include water.

Parameters

Name	Type	Default Value	Description
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
can_float	Boolean	false	Tells the pathfinder whether or not it can float in water
can_open_doors	Boolean	false	Tells the pathfinder that it can path through a closed door assuming the AI will open the door
can_pass_doors	Boolean	true	Whether a path can be created through a door

minecraft:navigation.walk#

Description

Allows this entity to generate paths by walking around and jumping up and down a block like regular mobs.

Parameters

Name	Type	Default Value	Description
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
can_float	Boolean	false	Tells the pathfinder whether or not it can float in water
can_open_doors	Boolean	false	Tells the pathfinder that it can path through a closed door assuming the AI will open the door
can_pass_doors	Boolean	true	Whether a path can be created through a door

minecraft:peek#

Description

Defines the entity's 'peek' behavior, defining the events that should be called during it

Parameters

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

minecraft:physics#

Description

Defines the entity's ability to interact with gravity and other entities through collision.

Parameters

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

minecraft:projectile#

Description

Allows the entity to be a thrown entity.

Parameters

Name	Type	Default Value	Description
angleoffset	Decimal	0.0	Determines the angle at which the projectile is thrown
catchFire	Boolean	false	If true, the entity hit will be set on fire
critParticleOnHurt	Boolean	false	If true, the projectile will produce additional particles when a critical hit happens
destroyOnHurt	Boolean	false	If true, this entity will be destroyed when hit
filter	String		Entity Definitions defined here can't be hurt by the projectile
fireAffectedByGriefing	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
hitSound	String		The sound that plays when the projectile hits something
homing	Boolean	false	If true, the projectile homes in to the nearest entity
inertia	Decimal	0.99	The fraction of the projectile's speed maintained every frame while traveling in air
isdangerous	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
liquid_inertia	Decimal	0.6	The fraction of the projectile's speed maintained every frame while traveling in water
offset	Vector [a, b, c]	[0.0, 0.5, 0.0]	The offset from the entity's anchor where the projectile will spawn
onFireTime	Decimal	5.0	Time in seconds that the entity hit will be on fire for
particle	String	iconcrack	Particle to use upon collision
potionEffect	Integer	-1	Defines the effect the arrow will apply to the entity it hits
power	Decimal	1.3	Determines the velocity of the projectile
reflectOnHurt	Boolean	false	If true, this entity will be reflected back when hit
semirandomdiffdamage	Boolean	false	If true, damage will be randomized based on damage and speed
shootSound	String		The sound that plays when the projectile is shot
shoottarget	Boolean	true	If true, the projectile will be shot towards the target of the entity firing it
shouldbounce	Boolean	false	If true, the projectile will bounce upon hit
splashPotion	Boolean	false	If true, the projectile will be treated like a splash potion
splashRange	Decimal	4.0	Radius in blocks of the 'splash' effect
uncertaintyBase	Decimal	0.0	The base accuracy. Accuracy is determined by the formula uncertaintyBase - difficultyLevel * uncertaintyMultiplier
uncertaintyMultiplier	Decimal	0.0	Determines how much difficulty affects accuracy. Accuracy is determined by the formula uncertaintyBase - difficultyLevel * uncertaintyMultiplier

minecraft:rail_movement#

Description

Defines the entity's movement on the rails. An entity with this component is only allowed to move on the rail.

Parameters

Name	Type	Default Value	Description
max_speed	Decimal	0.4	Maximum speed that this entity will move at when on the rail

minecraft:rail_sensor#

Description

Defines the behavior of the entity when the rail gets activated or deactivated.

Parameters

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

minecraft:rideable#

Description

Determines whether this entity can be ridden. Allows specifying the different seat positions and quantity.

Parameters

Name	Type	Default Value	Description
controlling_seat	Integer	0	The seat that designates the driver of the entity
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
pull_in_entities	Boolean	false	If true, this entity will pull in entities that are in the correct family_types into any available seats
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 Name Type Default Value Description lock_rider_rotation Decimal 181.0 Angle in degrees that a rider is allowed to rotate while riding this entity. Omit this property for no limit max_rider_count Integer 0 Defines the maximum number of riders that can be riding this entity for this seat to be valid min_rider_count Integer 0 Defines the minimum number of riders that need to be riding this entity before this seat can be used position Vector [a, b, c] [0.0, 0.0, 0.0] Position of this seat relative to this entity's position rotate_rider_by Decimal 0.0 Offset to rotate riders by

minecraft:scale_by_age#

Description

Defines the entity's size interpolation based on the entity's age.

Parameters

Name	Type	Default Value	Description
end_scale	Decimal	1.0	Ending scale of the entity when it's fully grown
start_scale	Decimal	1.0	Initial scale of the newborn entity

minecraft:shareables#

Description

Defines a list of items the mob wants to share. Each item must have the following parameters:

Parameters

Name	Type	Default Value	Description
craft_into	String		Defines the item this entity wants to craft with the item defined above. Should be an item name
item	String		The name of the item
surplus_amount	Integer	-1	Number of this item considered extra that the entity wants to share
want_amount	Integer	-1	Number of this item this entity wants to share

minecraft:shooter#

Description

Defines the entity's ranged attack behavior.

Parameters

Name	Type	Default Value	Description
auxVal	Integer	-1	ID of the Potion effect to be applied on hit
def	String		Entity definition to use as projectile for the ranged attack. The entity definition must have the projectile component to be able to be shot as a projectile

minecraft:sittable#

Description

Defines the entity's 'sit' state.

Parameters

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

minecraft:spawn_entity#

Description

Adds a timer after which this entity will spawn another entity or item (similar to vanilla's chicken's egg-laying behavior).

Parameters

Name	Type	Default Value	Description
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
spawn_entity	String		Identifier of the entity to spawn. Leave empty to spawn the item defined above instead
spawn_event	String	minecraft:entity_born	Event to call when the entity is spawned
spawn_item	String	egg	Name of the item to spawn
spawn_method	String	born	Method to use to spawn the entity
spawn_sound	String	plop	Name of the sound effect to play when the entity is spawned

minecraft:tameable#

Description

Defines the rules for a mob to be tamed by the player.

Parameters

Name	Type	Default Value	Description
probability	Decimal	1.0	The chance of taming the entity with each item use between 0.0 and 1.0, where 1.0 is 100%
tameItems	List		The list of items that can be used to tame this entity
tame_event	String		Event to run when this entity becomes tamed

minecraft:tamemount#

Description

Allows the Entity to be tamed by mounting it.

Parameters

Name	Type	Default Value	Description
attemptTemperMod	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 Name Type Default Value Description item String Name of the item this entity dislikes and will cause it to get angry if used while untamed
feedItems	JSON Object		The list of items that can be used to increase the entity's temper and speed up the taming process Name Type Default Value Description item String Name of the item this entity likes and can be used to increase this entity's temper temperMod Decimal 0.0 The amount of temper this entity gains when fed this item
feed_text	String		The text that shows in the feeding interact button
maxTemper	Integer	100	The maximum value for the entity's random starting temper
minTemper	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

minecraft:target_nearby_sensor#

Description

Defines the entity's range within which it can see or sense other entities to target them.

Parameters

Name	Type	Default Value	Description
inside_range	Decimal	1.0	Maximum distance in blocks that another entity will be considered in the 'inside' range
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
outside_range	Decimal	5.0	Maximum distance in blocks that another entity will be considered in the 'outside' range

minecraft:teleport#

Description

Defines an entity's teleporting behavior.

Parameters

Name	Type	Default Value	Description
darkTeleportChance	Decimal	0.01	Modifies the chance that the entity will teleport if the entity is in darkness
lightTeleportChance	Decimal	0.01	Modifies the chance that the entity will teleport if the entity is in daylight
maxRandomTeleportTime	Decimal	20.0	Maximum amount of time in seconds between random teleports
minRandomTeleportTime	Decimal	0.0	Minimum amount of time in seconds between random teleports
randomTeleportCube	Vector [a, b, c]	[32.0, 16.0, 32.0]	Entity will teleport to a random position within the area defined by this cube
randomTeleports	Boolean	true	If true, the entity will teleport randomly
targetDistance	Decimal	16.0	Maximum distance the entity will teleport when chasing a target
target_teleport_chance	Decimal	1.0	The chance that the entity will teleport between 0.0 and 1.0. 1.0 means 100%

minecraft:tick_world#

Description

Defines if the entity ticks the world and the radius around it to tick.

Parameters

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.

minecraft:timer#

Description

Adds a timer after which an event will fire.

Parameters

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
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)
time_down_event	String		Event to fire when the time on the timer runs out

minecraft:trade_table#

Description

Defines this entity's ability to trade with players.

Parameters

Name	Type	Default Value	Description
display_name	String		Name to be displayed while trading with this entity
table	String		File path relative to the resource pack root for this entity's trades

minecraft:transformation#

Description

Defines an entity's transformation from the current definition into another

Parameters

Name	Type	Default Value	Description
add	JSON Object		List of components to add to the entity after the transformation Name Type Default Value Description component_groups List Names of component groups to add
begin_transform_sound	String		Sound to play when the transformation starts
delay	JSON Object		Defines the properties of the delay for the transformation Name Type Default Value Description block_assist_chance Decimal 0.0 Chance that the entity will look for nearby blocks that can speed up the transformation. Value must be between 0.0 and 1.0 block_chance Decimal 0.0 Chance that, once a block is found, will help speed up the transformation block_max Integer 0 Maximum number of blocks the entity will look for to aid in the transformation. If not defined or set to 0, it will be set to the block radius block_radius Integer 0 Distance in Blocks that the entity will search for blocks that can help the transformation block_types List List of blocks that can help the transformation of this entity keep_owner Boolean If this entity is owned by another entity, it should remain owned after transformation. value Decimal 0.0 Time in seconds before the entity transforms
into	String		Entity Definition that this entity will transform into
transformation_sound	String		Sound to play when the entity is done transforming

AI Goals#

minecraft:behavior.avoid_mob_type#

Description

Allows this entity to avoid certain mob types.

Parameters

Name	Type	Default Value	Description
entity_types	JSON Object		List of entity types this mob avoids. Name Type Default Value Description filters Minecraft Filter Conditions that make this entry in the list valid max_dist Decimal 16 Maximum distance this mob can be away to be a valid choice must_see Boolean false If true, the mob has to be visible to be a valid choice sprint_speed_multiplier Decimal 1.0 Multiplier for the running speed. A value of 1.0 means the speed is unchanged walk_speed_multiplier Decimal 1.0 Multiplier for the walking speed. A value of 1.0 means the speed is unchanged
max_dist	Decimal	0.0	Maximum distance to look for an entity
probability_per_strength	Decimal	1.0	Determines how likely it is that this entity will stop avoiding another entity based on that entity's strength
sprint_speed_multiplier	Decimal	1.0	Multiplier for running speed. 1.0 means keep the regular speed, while higher numbers make the running 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

minecraft:behavior.beg#

Description

Allows this mob to look at and follow the player that holds food they like.

Parameters

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

minecraft:behavior.break_door#

Description

Allows this mob to break doors.

minecraft:behavior.breed#

Description

Allows this mob to breed with other mobs.

Parameters

Name	Type	Default Value	Description
speed_multiplier	Decimal	1.0	Movement speed multiplier of the mob when using this AI Goal

minecraft:behavior.charge_attack#

Description

Allows the mob to attack its target by running at it.

minecraft:behavior.controlled_by_player#

Description

Allows the mob to be controlled by the player.

minecraft:behavior.defend_village_target#

Description

Allows the mob to stay in the village and fight mobs hostile to the villagers.

Parameters

Name	Type	Default Value	Description
entity_types	JSON Object		List of entity types this mob considers a threat to the village Name Type Default Value Description filters Minecraft Filter Conditions that make this entry in the list valid max_dist Decimal 16 Maximum distance this mob can be away to be a valid choice must_see Boolean false If true, the mob has to be visible to be a valid choice sprint_speed_multiplier Decimal 1.0 Multiplier for the running speed. A value of 1.0 means the speed is unchanged walk_speed_multiplier Decimal 1.0 Multiplier for the walking speed. A value of 1.0 means the speed is unchanged

minecraft:behavior.door_interact#

Description

Allows the mob to open and close doors.

minecraft:behavior.dragonchargeplayer#

Description

Allows the dragon to attack a player by flying fast at them. The player is chosen by the dragonscanning goal. Can only be used by the Ender Dragon.

minecraft:behavior.dragondeath#

Description

Allows the dragon to go out with glory. This controls the Ender Dragon's death animation and can't be used by other mobs.

minecraft:behavior.dragonflaming#

Description

Allows the dragon to use its flame breath attack. Can only be used by the Ender Dragon.

minecraft:behavior.dragonholdingpattern#

Description

Allows the Dragon to fly around in a circle around the center podium. Can only be used by the Ender Dragon.

minecraft:behavior.dragonlanding#

Description

Allows the Dragon to stop flying and transition into perching mode. Can only be used by the Ender Dragon.

minecraft:behavior.dragonscanning#

Description

Allows the dragon to look around for a player to attack while in perch mode. Can only be used by the Ender Dragon.

minecraft:behavior.dragonstrafeplayer#

Description

Allows the dragon to fly around looking for a player and shoot fireballs at them. Can only be used by the Ender Dragon.

minecraft:behavior.dragontakeoff#

Description

Allows the dragon to leave perch mode and go back to flying around. Can only be used by the Ender Dragon.

minecraft:behavior.eat_block#

Description

Allows the mob to eat a block (for example, sheep eating grass).

Parameters

Name	Type	Default Value	Description
on_eat	Trigger		Trigger to fire when the mob eats a block of grass

minecraft:behavior.enderman_leave_block#

Description

Allows the enderman to drop a block they are carrying. Can only be used by Endermen.

minecraft:behavior.enderman_take_block#

Description

Allows the enderman to take a block and carry it around. Can only be used by Endermen.

minecraft:behavior.find_mount#

Description

Allows the mob to look around for another mob to ride atop it.

Parameters

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

minecraft:behavior.flee_sun#

Description

Allows the mob to run away from direct sunlight and seek shade.

Parameters

Name	Type	Default Value	Description
speed_multiplier	Decimal	1.0	Movement speed multiplier of the mob when using this AI Goal

minecraft:behavior.float#

Description

Allows the mob to stay afloat while swimming.

minecraft:behavior.float_wander#

Description

Allows the mob to float around like the Ghast.

Parameters

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

minecraft:behavior.follow_caravan#

Description

Allows the mob to follow mobs that are in a caravan.

Parameters

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 Name Type Default Value Description filters Minecraft Filter Conditions that make this entry in the list valid max_dist Decimal 16 Maximum distance this mob can be away to be a valid choice must_see Boolean false If true, the mob has to be visible to be a valid choice sprint_speed_multiplier Decimal 1.0 Multiplier for the running speed. A value of 1.0 means the speed is unchanged walk_speed_multiplier Decimal 1.0 Multiplier for the walking speed. A value of 1.0 means the speed is unchanged
speed_multiplier	Decimal	1.0	Movement speed multiplier of the mob when using this AI Goal

minecraft:behavior.follow_mob#

Description

Allows the mob to follow other mobs.

Parameters

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

minecraft:behavior.follow_owner#

Description

Allows the mob to follow the player that owns them.

Parameters

Name	Type	Default Value	Description
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

minecraft:behavior.follow_parent#

Description

Allows the mob to follow their parent around.

Parameters

Name	Type	Default Value	Description
speed_multiplier	Decimal	1.0	Movement speed multiplier of the mob when using this AI Goal

minecraft:behavior.guardian_attack#

Description

Allows the guardian to use its laser beam attack. Can only be used by Guardians and Elder Guardians.

minecraft:behavior.harvest_farm_block#

Description

Allows the villager to harvest nearby farms. Can only be used by Villagers.

Parameters

Name	Type	Default Value	Description
speed_multiplier	Decimal	1.0	Movement speed multiplier of the mob when using this AI Goal

minecraft:behavior.hurt_by_target#

Description

Allows the mob to target another mob that hurts them.

Parameters

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 Name Type Default Value Description filters Minecraft Filter Conditions that make this entry in the list valid max_dist Decimal 16 Maximum distance this mob can be away to be a valid choice must_see Boolean false If true, the mob has to be visible to be a valid choice sprint_speed_multiplier Decimal 1.0 Multiplier for the running speed. A value of 1.0 means the speed is unchanged walk_speed_multiplier Decimal 1.0 Multiplier for the walking speed. A value of 1.0 means the speed is unchanged
hurt_owner	Boolean	false	If true, the mob will hurt its owner and other mobs with the same owner as itself

minecraft:behavior.leap_at_target#

Description

Allows monsters to jump at and attack their target. Can only be used by hostile mobs.

Parameters

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
yd	Decimal	0.0	The height in blocks the mob jumps when leaping at its target

minecraft:behavior.look_at_entity#

Description

Allows the mob to look at nearby entities.

Parameters

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
look_time	Range [a, b]	[2, 4]	Time range to look at the entity
probability	Decimal	0.02	The probability of looking at the target. A value of 1.00 is 100%

minecraft:behavior.look_at_player#

Description

Allows the mob to look at the player when the player is nearby.

Parameters

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
look_time	Range [a, b]	[2, 4]	Time range to look at the entity
probability	Decimal	0.02	The probability of looking at the target. A value of 1.00 is 100%

minecraft:behavior.look_at_target#

Description

Allows the mob to look at the entity they are targetting.

Parameters

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
look_time	Range [a, b]	[2, 4]	Time range to look at the entity
probability	Decimal	0.02	The probability of looking at the target. A value of 1.00 is 100%

minecraft:behavior.look_at_trading_player#

Description

Allows the mob to look at the player they are trading with.

Parameters

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
look_time	Range [a, b]	[2, 4]	Time range to look at the entity
probability	Decimal	0.02	The probability of looking at the target. A value of 1.00 is 100%

minecraft:behavior.make_love#

Description

Allows the villager to look for a mate to spawn other villagers with. Can only be used by Villagers.

minecraft:behavior.melee_attack#

Description

Allows the mob to use close combat melee attacks.

Parameters

Name	Type	Default Value	Description
attack_types	String		Defines the entity types this mob will attack
random_stop_interval	Integer	0	Defines the probability the mob will stop fighting. A value of 0 disables randomly stopping, while a value of 1 defines a 50% chance
reach_multiplier	Decimal	2.0	Multiplier for how far outside its box the mob can reach its target (this can be used to simulate a mob with longer arms by making this bigger)
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

minecraft:behavior.mount_pathing#

Description

Allows the mob to move around on its own while mounted seeking a target to attack.

Parameters

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

minecraft:behavior.move_indoors#

Description

Can only be used by Villagers. Allows them to seek shelter indoors.

Parameters

Name	Type	Default Value	Description
speed_multiplier	Decimal	1.0	Movement speed multiplier of the mob when using this AI Goal

minecraft:behavior.move_through_village#

Description

Can only be used by Villagers. Allows the villagers to create paths around the village.

Parameters

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

minecraft:behavior.move_towards_restriction#

Description

Allows Guardians, Iron Golems and Villagers to move within their pre-defined area that the mob should be restricted to. Other mobs don't have a restriction defined.

Parameters

Name	Type	Default Value	Description
speed_multiplier	Decimal	1.0	Movement speed multiplier of the mob when using this AI Goal

minecraft:behavior.move_towards_target#

Description

Allows mob to move towards its current target.

Parameters

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

minecraft:behavior.nearest_attackable_target#

Description

Allows the mob to check for and pursue the nearest valid target.

Parameters

Name	Type	Default Value	Description
attack_interval	Integer	0	Time in seconds between attacks
entity_types	JSON Object		List of entity types that this mob considers valid targets Name Type Default Value Description filters Minecraft Filter Conditions that make this entry in the list valid max_dist Decimal 16 Maximum distance this mob can be away to be a valid choice must_see Boolean false If true, the mob has to be visible to be a valid choice sprint_speed_multiplier Decimal 1.0 Multiplier for the running speed. A value of 1.0 means the speed is unchanged walk_speed_multiplier Decimal 1.0 Multiplier for the walking speed. A value of 1.0 means the speed is unchanged
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
reselect_targets	Boolean	false	If true, the target will change to the current closest entity whenever a different entity is closer
within_radius	Decimal	0.0	Distance in blocks that the target can be within to launch an attack

minecraft:behavior.ocelot_sit_on_block#

Description

Allows to mob to be able to sit in place like the ocelot.

Parameters

Name	Type	Default Value	Description
speed_multiplier	Decimal	1.0	Movement speed multiplier of the mob when using this AI Goal

minecraft:behavior.ocelotattack#

Description

Can only be used by the Ocelot. Allows it to perform the sneak and pounce attack.

Parameters

Name	Type	Default Value	Description
sneak_speed_multiplier	Decimal	1.0	Multiplier for the sneaking speed. 1.0 means the ocelot will move at the speed it normally sneaks
sprint_speed_multiplier	Decimal	1.0	Multiplier for the running speed of this mob while using this attack
walk_speed_multiplier	Decimal	1.0	Multiplier for the walking speed while using this attack

minecraft:behavior.offer_flower#

Description

Allows the mob to offer the player a flower like the Iron Golem does.

minecraft:behavior.open_door#

Description

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.

Parameters

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

minecraft:behavior.owner_hurt_by_target#

Description

Allows the mob to target another mob that hurts their owner.

Parameters

Name	Type	Default Value	Description
entity_types	JSON Object		List of entity types that this mob can target if they hurt their owner Name Type Default Value Description filters Minecraft Filter Conditions that make this entry in the list valid max_dist Decimal 16 Maximum distance this mob can be away to be a valid choice must_see Boolean false If true, the mob has to be visible to be a valid choice sprint_speed_multiplier Decimal 1.0 Multiplier for the running speed. A value of 1.0 means the speed is unchanged walk_speed_multiplier Decimal 1.0 Multiplier for the walking speed. A value of 1.0 means the speed is unchanged

minecraft:behavior.owner_hurt_target#

Description

Allows the mob to target a mob that is hurt by their owner.

Parameters

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 Name Type Default Value Description filters Minecraft Filter Conditions that make this entry in the list valid max_dist Decimal 16 Maximum distance this mob can be away to be a valid choice must_see Boolean false If true, the mob has to be visible to be a valid choice sprint_speed_multiplier Decimal 1.0 Multiplier for the running speed. A value of 1.0 means the speed is unchanged walk_speed_multiplier Decimal 1.0 Multiplier for the walking speed. A value of 1.0 means the speed is unchanged

minecraft:behavior.panic#

Description

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.

Parameters

Name	Type	Default Value	Description
force	Boolean	false	If true, this mob will not stop panicking until it can't move anymore or the goal is removed from it
speed_multiplier	Decimal	1.0	Movement speed multiplier of the mob when using this AI Goal

minecraft:behavior.peek#

Description

Allows the mob to peek out. This is what the shulker uses to look out of its shell.

minecraft:behavior.pickup_items#

Description

Allows the mob to pick up items on the ground.

Parameters

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
max_dist	Decimal	0.0	Maximum distance this mob will look for items to pick up
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

minecraft:behavior.play#

Description

Allows the mob to play with other baby villagers. This can only be used by Villagers.

Parameters

Name	Type	Default Value	Description
speed_multiplier	Decimal	1.0	Movement speed multiplier of the mob when using this AI Goal

minecraft:behavior.player_ride_tamed#

Description

Allows the mob to be ridden by the player after being tamed.

minecraft:behavior.raid_garden#

Description

Allows the mob to eat crops out of farms until they are full.

Parameters

Name	Type	Default Value	Description
blocks	List		Blocks that the mob is looking for to eat
eat_delay	Integer	2	Time in seconds between each time it eats
full_delay	Integer	100	Amount of time in seconds before this mob wants to eat 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
max_to_eat	Integer	6	Maximum number of things this entity wants to eat
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

minecraft:behavior.random_fly#

Description

Allows a mob to randomly fly around.

Parameters

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

minecraft:behavior.random_look_around#

Description

Allows the mob to randomly look around.

Parameters

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

minecraft:behavior.random_stroll#

Description

Allows a mob to randomly stroll around.

Parameters

Name	Type	Default Value	Description
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

minecraft:behavior.ranged_attack#

Description

Allows the mob to use ranged attacks like shooting arrows.

Parameters

Name	Type	Default Value	Description
attack_interval_max	Integer	0	Maximum amount of time in seconds the entity will wait after an attack before launching another
attack_interval_min	Integer	0	Minimum amount of time in seconds the entity will wait after an attack before launching another
attack_radius	Decimal	0.0	Maxmimum distance the target can be for this mob to fire. If the target is further away, this mob will move first before firing
burst_interval	Decimal	0.0	Amount of time in seconds between each individual shot when firing multiple shots per attack
burst_shots	Integer	1	Number of shots fired every time the mob uses a charged attack
charge_charged_trigger	Decimal	0.0	The minimum amount of time in ticks the mob has to charge before firing a charged attack
charge_shoot_trigger	Decimal	0.0	The minimum amount of time in ticks for the mob to start charging a charged shot. Must be greater than 0 to enable burst shots
speed_multiplier	Decimal	1.0	Movement speed multiplier of the mob when using this AI Goal

minecraft:behavior.receive_love#

Description

Allows the villager to stop so another villager can breed with it. Can only be used by a Villager.

minecraft:behavior.restrict_open_door#

Description

Allows the mob to stay indoors during night time.

minecraft:behavior.restrict_sun#

Description

Allows the mob to automatically start avoiding the sun when its a clear day out.

minecraft:behavior.run_around_like_crazy#

Description

Allows the mob to run around aimlessly.

Parameters

Name	Type	Default Value	Description
speed_multiplier	Decimal	1.0	Movement speed multiplier of the mob when using this AI Goal

minecraft:behavior.send_event#

Description

Allows the mob to send an event to another mob.

Parameters

Name	Type	Default Value	Description
cast_duration	Decimal	Total delay of the steps	Time in seconds for the entire event sending process
sequence	List		List of events to send Name Type Default Value Description base_delay Decimal 0.0 Amount of time in seconds before starting this step event String The event to send to the entity sound_event String The sound event to play when this step happens

minecraft:behavior.share_items#

Description

Allows the mob to give items it has to others.

Parameters

Name	Type	Default Value	Description
entity_types	JSON Object		List of entities this mob will share items with Name Type Default Value Description filters Minecraft Filter Conditions that make this entry in the list valid max_dist Decimal 16 Maximum distance this mob can be away to be a valid choice must_see Boolean false If true, the mob has to be visible to be a valid choice sprint_speed_multiplier Decimal 1.0 Multiplier for the running speed. A value of 1.0 means the speed is unchanged walk_speed_multiplier Decimal 1.0 Multiplier for the walking speed. A value of 1.0 means the speed is unchanged
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

minecraft:behavior.silverfish_merge_with_stone#

Description

Allows the mob to go into stone blocks like Silverfish do. Currently it can only be used by Silverfish.

minecraft:behavior.silverfish_wake_up_friends#

Description

Allows the mob to alert mobs in nearby blocks to come out. Currently it can only be used by Silverfish.

minecraft:behavior.skeleton_horse_trap#

Description

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.

Parameters

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

minecraft:behavior.slime_attack#

Description

Can only be used by Slimes and Magma Cubes. Allows the mob to use a melee attack like the slime's.

minecraft:behavior.slime_float#

Description

Can only be used by Slimes and Magma Cubes. Controls their ability to float in water / lava.

minecraft:behavior.slime_keep_on_jumping#

Description

Can only be used by Slimes and Magma Cubes. Allows the mob to continuously jump around like a slime.

minecraft:behavior.slime_random_direction#

Description

Can only be used by Slimes and Magma Cubes. Allows the mob to move in random directions like a slime.

minecraft:behavior.squid_dive#

Description

Allows the squid to dive down in water. Can only be used by the Squid.

minecraft:behavior.squid_flee#

Description

Allows the squid to swim away. Can only be used by the Squid.

minecraft:behavior.squid_idle#

Description

Allows the squid to swim in place idly. Can only be used by the Squid.

minecraft:behavior.squid_move_away_from_ground#

Description

Allows the squid to move away from ground blocks and back to water. Can only be used by the Squid.

minecraft:behavior.squid_out_of_water#

Description

Allows the squid to stick to the ground when outside water. Can only be used by the Squid.

minecraft:behavior.stay_while_sitting#

Description

Allows the mob to stay put while it is in a sitting state instead of doing something else.

minecraft:behavior.stomp_attack#

Description

Allows the mob to use the polar bear's melee attack.

Parameters

Name	Type	Default Value	Description
attack_types	String		Defines the entity types this mob will attack
random_stop_interval	Integer	0	Defines the probability the mob will stop fighting. A value of 0 disables randomly stopping, while a value of 1 defines a 50% chance
reach_multiplier	Decimal	2.0	Multiplier for how far outside its box the mob can reach its target (this can be used to simulate a mob with longer arms by making this bigger)
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

minecraft:behavior.summon_entity#

Description

Allows the mob to attack the player by summoning other entities.

Parameters

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: Name Type Default Value Description cast_duration Decimal Total delay of the steps Time in seconds the spell casting will take cooldown_time Decimal 0.0 Time in seconds the mob has to wait before using the spell again do_casting Boolean true If true, the mob will do the casting animations and render spell particles filters Minecraft Filter max_activation_range Decimal -1.0 Upper bound of the activation distance in blocks for this spell min_activation_range Decimal 1.0 Lower bound of the activation distance in blocks for this spell particle_color Integer 0 The color of the particles for this spell sequence List List of steps for the spell. Each step has the following parameters: Name Type Default Value Description base_delay Decimal 0.0 Amount of time in seconds to wait before this step starts delay_per_summon Decimal 0.0 Amount of time in seconds before each entity is summoned in this step entity_lifespan Decimal -1.0 Amount of time in seconds that the spawned entity will be alive for. A value of -1.0 means it will remain alive for as long as it can entity_type String The entity type of the entities we will spawn in this step num_entities_spawned Integer 1 Number of entities that will be spawned in this step shape String line The base shape of this step. Valid values are circle and line size Decimal 1.0 The base size of the entity sound_event String The sound event to play for this step summon_cap Integer 0 Maximum number of summoned entities at any given time summon_cap_radius Decimal 0.0 target String self The target of the spell. This is where the spell will start (line will start here, circle will be centered here) start_sound_event String The sound event to play when using this spell weight Decimal 0.0 The weight of this spell. Controls how likely the mob is to choose this spell when casting one

minecraft:behavior.swell#

Description

Allows the creeper to swell up when a player is nearby. It can only be used by Creepers.

Parameters

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

minecraft:behavior.take_flower#

Description

Can only be used by Villagers. Allows the mob to accept flowers from Iron Golems.

minecraft:behavior.tempt#

Description

Allows the mob to be tempted by food they like.

Parameters

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
items	List		List of items this mob is tempted by
speed_multiplier	Decimal	1.0	Movement speed multiplier of the mob when using this AI Goal
within_radius	Decimal	0.0	Distance in blocks this mob can get tempted by a player holding an item they like

minecraft:behavior.trade_with_player#

Description

Allows the player to trade with this mob.

minecraft:behavior.vex_copy_owner_target#

Description

Allows the mob to target the same entity its owner is targeting.

Parameters

Name	Type	Default Value	Description
entity_types	JSON Object		List of entities this mob can copy the owner from Name Type Default Value Description filters Minecraft Filter Conditions that make this entry in the list valid max_dist Decimal 16 Maximum distance this mob can be away to be a valid choice must_see Boolean false If true, the mob has to be visible to be a valid choice sprint_speed_multiplier Decimal 1.0 Multiplier for the running speed. A value of 1.0 means the speed is unchanged walk_speed_multiplier Decimal 1.0 Multiplier for the walking speed. A value of 1.0 means the speed is unchanged

minecraft:behavior.vex_random_move#

Description

Allows the mob to move around randomly like the Vex.

minecraft:behavior.wither_random_attack_pos_goal#

Description

Allows the wither to launch random attacks. Can only be used by the Wither Boss.

minecraft:behavior.wither_target_highest_damage#

Description

Allows the wither to focus its attacks on whichever mob has dealt the most damage to it.

Parameters

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 Name Type Default Value Description filters Minecraft Filter Conditions that make this entry in the list valid max_dist Decimal 16 Maximum distance this mob can be away to be a valid choice must_see Boolean false If true, the mob has to be visible to be a valid choice sprint_speed_multiplier Decimal 1.0 Multiplier for the running speed. A value of 1.0 means the speed is unchanged walk_speed_multiplier Decimal 1.0 Multiplier for the walking speed. A value of 1.0 means the speed is unchanged

Filters#

Description

Filters allow data objects to specify test critera 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 paramters:

: 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' and 'any_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.



: Example:

: "all_of" : [

: { "test" : "moon_intensity", "subject" : "self", "operator" : "greater", "value" : "0.5" },

: { "test" : "in_water", "subject" : "target", "operator" : "equal", "value" : "true" }

: ]

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

clock_time#

Description

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

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Decimal		(Required) A floating point value.

Examples

{ "test": "clock_time", "subject": "self", "operator": "equals", "value": "0" }
{ "test": "clock_time", "value": "0" }

has_ability#

Description

Returns true when the subject entity has the named ability.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	String		(Required) The Ability type to test Options Description flySpeed flying instabuild invulnerable lightning mayfly mute noclip walkSpeed worldbuilder

Examples

{ "test": "has_ability", "subject": "self", "operator": "equals", "value": "instabuild" }
{ "test": "has_ability", "value": "instabuild" }

has_component#

Description

Returns true when the subject entity contains the named component.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	String		(Required) The component name to look for

Examples

{ "test": "has_component", "subject": "self", "operator": "equals", "value": "minecraft:explode" }
{ "test": "has_component", "value": "minecraft:explode" }

has_damage#

Description

Returns true when the subject entity receives the named damage type.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	String		(Required) The Damage type to test Options Description anvil attack block_explosion contact drowning entity_explosion fall falling_block fatal Any damage which kills the subject fire fire_tick fly_into_wall lava magic none override piston projectile starve suffocation suicide thorns void wither

Examples

{ "test": "has_damage", "subject": "self", "operator": "equals", "value": "fatal" }
{ "test": "has_damage", "value": "fatal" }

has_equipment#

Description

Tests for the presence of a named item in the designated slot of the subject entity.

Parameters

Name	Type	Default	Description
domain	String	any	(Optional) The equipment location to test Options Description any armor feet hand head leg torso
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	String		(Required) The item name to look for

Examples

{ "test": "has_equipment", "subject": "self", "domain": "any", "operator": "equals", "value": "dirt" }
{ "test": "has_equipment", "value": "dirt" }

in_caravan#

Description

Returns true if the subject entity is in a caravan.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Boolean	true	(Optional) true or false.

Examples

{ "test": "in_caravan", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "in_caravan" }

in_clouds#

Description

Returns true when the subject entity is in the clouds.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Boolean	true	(Optional) true or false.

Examples

{ "test": "in_clouds", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "in_clouds" }

in_lava#

Description

Returns true when the subject entity is in lava.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Boolean	true	(Optional) true or false.

Examples

{ "test": "in_lava", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "in_lava" }

in_water#

Description

Returns true when the subject entity is in water.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Boolean	true	(Optional) true or false.

Examples

{ "test": "in_water", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "in_water" }

is_altitude#

Description

Tests the current altitude against a provided value. 0= bedrock elevation.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Integer		(Required) The altitude value to compare with

Examples

{ "test": "is_altitude", "subject": "self", "operator": "equals", "value": "0" }
{ "test": "is_altitude", "value": "0" }

is_biome#

Description

Tests whether the Subject is currently in the named biome.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	String		(Required) The Biome type to test Options Description beach desert extreme_hills flat forest ice jungle mesa mushroom_island ocean plain river savanna stone_beach swamp taiga the_end the_nether

Examples

{ "test": "is_biome", "subject": "self", "operator": "equals", "value": "beach" }
{ "test": "is_biome", "value": "beach" }

is_brightness#

Description

Tests the current brightness against a provided value in the range (0.0f, 1.0f).

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Decimal		(Required) The brightness value to compare with.

Examples

{ "test": "is_brightness", "subject": "self", "operator": "equals", "value": "0.5" }
{ "test": "is_brightness", "value": "0.5" }

is_climbing#

Description

Returns true if the subject entity is climbing.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Boolean	true	(Optional) true or false.

Examples

{ "test": "is_climbing", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "is_climbing" }

is_color#

Description

Returns true if the subject entity is the named color.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	String		(Required) The Palette Color to test Options Description black blue brown cyan gray green light_blue light_green magenta orange pink purple red silver white yellow

Examples

{ "test": "is_color", "subject": "self", "operator": "equals", "value": "white" }
{ "test": "is_color", "value": "white" }

is_daytime#

Description

Returns true during the daylight hours.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Boolean	true	(Optional) true or false.

Examples

{ "test": "is_daytime", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "is_daytime" }

is_difficulty#

Description

Tests the current difficulty level of the game.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	String		(Required) The game's difficulty level to test Options Description easy hard normal peaceful

Examples

{ "test": "is_difficulty", "subject": "self", "operator": "equals", "value": "normal" }
{ "test": "is_difficulty", "value": "normal" }

is_family#

Description

Returns true when the subject entity is a member of the named family.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	String		(Required) The Family name to look for

Examples

{ "test": "is_family", "subject": "self", "operator": "equals", "value": "player" }
{ "test": "is_family", "value": "player" }

is_game_rule#

Description

Tests whether a named game rule is active.

Parameters

Name	Type	Default	Description
domain	String		(Required) The Game Rule to test.
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Boolean	true	(Optional) true or false.

Examples

{ "test": "is_game_rule", "subject": "self", "domain": "domobspawning", "operator": "equals", "value": "true" }
{ "test": "is_game_rule", "domain": "domobspawning" }

is_humid#

Description

Tests whether the Subject is in an area with humidity

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Boolean	true	(Optional) true or false.

Examples

{ "test": "is_humid", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "is_humid" }

is_immobile#

Description

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.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Boolean	true	(Optional) true or false.

Examples

{ "test": "is_immobile", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "is_immobile" }

is_moving#

Description

Returns true if the subject entity is moving.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Boolean	true	(Optional) true or false.

Examples

{ "test": "is_moving", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "is_moving" }

is_owner#

Description

Returns true if the subject entity is the owner of the calling entity.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Boolean	true	(Optional) true or false.

Examples

{ "test": "is_owner", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "is_owner" }

is_riding#

Description

Returns true if the subject entity is riding on another entity.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Boolean	true	(Optional) true or false.

Examples

{ "test": "is_riding", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "is_riding" }

is_sneaking#

Description

Returns true if the subject entity is sneaking.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Boolean	true	(Optional) true or false.

Examples

{ "test": "is_sneaking", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "is_sneaking" }

is_snow_covered#

Description

Tests whether the Subject is in an area with snow cover

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Boolean	true	(Optional) true or false.

Examples

{ "test": "is_snow_covered", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "is_snow_covered" }

is_target#

Description

Returns true if the subject entity is the target of the calling entity.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Boolean	true	(Optional) true or false.

Examples

{ "test": "is_target", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "is_target" }

is_temperature_type#

Description

Tests whether the current temperature is a given type.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	String		(Required) The Biome temperature catagory to test Options Description cold mild ocean warm

Examples

{ "test": "is_temperature_type", "subject": "self", "operator": "equals", "value": "cold" }
{ "test": "is_temperature_type", "value": "cold" }

is_temperature_value#

Description

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.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Decimal		(Required) The Biome temperature value to compare with.

Examples

{ "test": "is_temperature_value", "subject": "self", "operator": "equals", "value": "0.5" }
{ "test": "is_temperature_value", "value": "0.5" }

is_underground#

Description

Returns true when the subject entity is underground. An entity is considered underground if there are non-solid blocks above it.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Boolean	true	(Optional) true or false.

Examples

{ "test": "is_underground", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "is_underground" }

is_underwater#

Description

Returns true when the subject entity is under water. An entity is considered underwater if it is completely submerged in water blocks.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Boolean	true	(Optional) true or false.

Examples

{ "test": "is_underwater", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "is_underwater" }

is_variant#

Description

Returns true if the subject entity is the variant number provided.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Integer		(Required) An integer value.

Examples

{ "test": "is_variant", "subject": "self", "operator": "equals", "value": "0" }
{ "test": "is_variant", "value": "0" }

moon_intensity#

Description

Compares the current moon intensity with a float value in the range (0.0, 1.0)

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Decimal		(Required) A floating point value.

Examples

{ "test": "moon_intensity", "subject": "self", "operator": "equals", "value": "0" }
{ "test": "moon_intensity", "value": "0" }

moon_phase#

Description

Compares the current moon phase with an integer value in the range (0, 7).

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Integer		(Required) An integer value.

Examples

{ "test": "moon_phase", "subject": "self", "operator": "equals", "value": "0" }
{ "test": "moon_phase", "value": "0" }

on_ladder#

Description

Returns true when the subject entity is on a ladder.

Parameters

Name	Type	Default	Description
operator	String	equals	(Optional) The comparison to apply with 'value'. Options Description != Test for inequality. < Test for less-than the value. <= Test for less-than or equal to the value. <> Test for inequality. = Test for equality. == Test for equality. > Test for greater-than the value. >= Test for greater-than or equal to the value. equals Test for equality. not Test for inequality.
subject	String	self	(Optional) The subject of this filter test. Options Description other The other member of an interaction, not the caller. parent The caller's current parent. player The player involved with the interaction. self The entity or object calling the test target The caller's current target.
value	Boolean	true	(Optional) true or false.

Examples

{ "test": "on_ladder", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "on_ladder" }

Triggers#

minecraft:on_death#

Description

Only usable by the Ender Dragon. Adds a trigger to call on this entity's death.

Parameters

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
target	String	self	The target of the event

minecraft:on_friendly_anger#

Description

Adds a trigger that will run when a nearby entity of the same type as this entity becomes Angry.

Parameters

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
target	String	self	The target of the event

minecraft:on_hurt#

Description

Adds a trigger to call when this entity takes damage.

Parameters

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
target	String	self	The target of the event

minecraft:on_hurt_by_player#

Description

Adds a trigger to call when this entity is attacked by the player.

Parameters

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
target	String	self	The target of the event

minecraft:on_ignite#

Description

Adds a trigger to call when this entity is set on fire.

Parameters

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
target	String	self	The target of the event

minecraft:on_start_landing#

Description

Only usable by the Ender Dragon. Adds a trigger to call when this entity lands.

Parameters

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
target	String	self	The target of the event

minecraft:on_start_takeoff#

Description

Only usable by the Ender Dragon. Adds a trigger to call when this entity starts flying.

Parameters

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
target	String	self	The target of the event

minecraft:on_target_acquired#

Description

Adds a trigger to call when this entity finds a target.

Parameters

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
target	String	self	The target of the event

minecraft:on_target_escape#

Description

Adds a trigger to call when this entity loses the target it currently has.

Parameters

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
target	String	self	The target of the event

Built-in Events#

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.

Entities#

Identifier	Full ID	Short ID
agent	312	56
area_effect_cloud	95	95
armor_stand	317	61
arrow	4194384	80
bat	33043	19
blaze	2859	43
boat	90	90
cave_spider	265000	40
chest_minecart	524386	98
chicken	4874	10
command_block_minecart	524388	100
cow	4875	11
creeper	2849	33
donkey	2118424	24
dragon_fireball	4194383	79
egg	4194386	82
elder_guardian	2866	50
ender_crystal	71	71
ender_dragon	2869	53
ender_pearl	4194391	87
enderman	2854	38
endermite	265015	55
evocation_fang	4194407	103
evocation_illager	2920	104
eye_of_ender_signal	70	70
falling_block	66	66
fireball	4194389	85
fireworks_rocket	72	72
fishing_hook	77	77
ghast	2857	41
guardian	2865	49
hopper_minecart	524384	96
horse	2118423	23
husk	199471	47
iron_golem	788	20
item	64	64
leash_knot	88	88
lightning_bolt	93	93
lingering_potion	4194405	101
llama	4893	29
llama_spit	4194406	102
magma_cube	2858	42
minecart	524372	84
mooshroom	4880	16
moving_block	67	67
mule	2118425	25
ocelot	21270	22
painting	83	83
parrot	21278	30
pig	4876	12
player	319	63
polar_bear	4892	28
rabbit	4882	18
sheep	4877	13
shulker	2870	54
shulker_bullet	4194380	76
silverfish	264999	39
skeleton	1116962	34
skeleton_horse	2186010	26
slime	2853	37
small_fireball	4194398	94
snow_golem	789	21
snowball	4194385	81
spider	264995	35
splash_potion	4194390	86
squid	8977	17
stray	1116974	46
tnt	65	65
tnt_minecart	524385	97
vex	2921	105
villager	783	15
vindicator	2873	57
witch	2861	45
wither	68404	52
wither_skeleton	1116976	48
wither_skull	4194393	89
wither_skull_dangerous	4194395	91
wolf	21262	14
xp_bottle	4194372	68
xp_orb	69	69
zombie	199456	32
zombie_horse	2186011	27
zombie_pigman	68388	36
zombie_villager	199468	44

Blocks#

Name	ID
acacia_door	196
acacia_fence_gate	187
acacia_stairs	163
activator_rail	126
air	0
anvil	145
beacon	138
bed	26
bedrock	7
beetroot	244
birch_door	194
birch_fence_gate	184
birch_stairs	135
black_glazed_terracotta	235
blue_glazed_terracotta	231
bone_block	216
bookshelf	47
brewing_stand	117
brick_block	45
brick_stairs	108
brown_glazed_terracotta	232
brown_mushroom	39
brown_mushroom_block	99
cactus	81
cake	92
carpet	171
carrots	141
cauldron	118
chain_command_block	189
chest	54
chorus_flower	200
chorus_plant	240
clay	82
coal_block	173
coal_ore	16
cobblestone	4
cobblestone_wall	139
cocoa	127
command_block	137
concrete	236
concretePowder	237
crafting_table	58
cyan_glazed_terracotta	229
dark_oak_door	197
dark_oak_fence_gate	186
dark_oak_stairs	164
daylight_detector	151
daylight_detector_inverted	178
deadbush	32
detector_rail	28
diamond_block	57
diamond_ore	56
dirt	3
dispenser	23
double_plant	175
double_stone_slab	43
double_stone_slab2	181
double_wooden_slab	157
dragon_egg	122
dropper	125
emerald_block	133
emerald_ore	129
enchanting_table	116
end_bricks	206
end_gateway	209
end_portal	119
end_portal_frame	120
end_rod	208
end_stone	121
ender_chest	130
farmland	60
fence	85
fence_gate	107
fire	51
flower_pot	140
flowing_lava	10
flowing_water	8
frame	199
frosted_ice	207
furnace	61
glass	20
glass_pane	102
glowingobsidian	246
glowstone	89
gold_block	41
gold_ore	14
golden_rail	27
grass	2
grass_path	198
gravel	13
gray_glazed_terracotta	227
green_glazed_terracotta	233
hardened_clay	172
hay_block	170
heavy_weighted_pressure_plate	148
hopper	154
ice	79
info_update	248
info_update2	249
invisibleBedrock	95
iron_bars	101
iron_block	42
iron_door	71
iron_ore	15
iron_trapdoor	167
jukebox	84
jungle_door	195
jungle_fence_gate	185
jungle_stairs	136
ladder	65
lapis_block	22
lapis_ore	21
lava	11
leaves	18
leaves2	161
lever	69
light_blue_glazed_terracotta	223
light_weighted_pressure_plate	147
lime_glazed_terracotta	225
lit_furnace	62
lit_pumpkin	91
lit_redstone_lamp	124
lit_redstone_ore	74
log	17
log2	162
magenta_glazed_terracotta	222
magma	213
melon_block	103
melon_stem	105
mob_spawner	52
monster_egg	97
mossy_cobblestone	48
movingBlock	250
mycelium	110
nether_brick	112
nether_brick_fence	113
nether_brick_stairs	114
nether_wart	115
nether_wart_block	214
netherrack	87
netherreactor	247
noteblock	25
oak_stairs	53
observer	251
obsidian	49
orange_glazed_terracotta	221
packed_ice	174
pink_glazed_terracotta	226
piston	33
pistonArmCollision	34
planks	5
podzol	243
portal	90
potatoes	142
powered_comparator	150
powered_repeater	94
prismarine	168
pumpkin	86
pumpkin_stem	104
purple_glazed_terracotta	219
purpur_block	201
purpur_stairs	203
quartz_block	155
quartz_ore	153
quartz_stairs	156
rail	66
red_flower	38
red_glazed_terracotta	234
red_mushroom	40
red_mushroom_block	100
red_nether_brick	215
red_sandstone	179
red_sandstone_stairs	180
redstone_block	152
redstone_lamp	123
redstone_ore	73
redstone_torch	76
redstone_wire	55
reeds	83
repeating_command_block	188
reserved6	255
sand	12
sandstone	24
sandstone_stairs	128
sapling	6
seaLantern	169
shulker_box	218
silver_glazed_terracotta	228
skull	144
slime	165
snow	80
snow_layer	78
soul_sand	88
sponge	19
spruce_door	193
spruce_fence_gate	183
spruce_stairs	134
stained_glass	241
stained_glass_pane	160
stained_hardened_clay	159
standing_banner	176
standing_sign	63
sticky_piston	29
stone	1
stone_brick_stairs	109
stone_button	77
stone_pressure_plate	70
stone_slab	44
stone_slab2	182
stone_stairs	67
stonebrick	98
stonecutter	245
structure_block	252
tallgrass	31
tnt	46
torch	50
trapdoor	96
trapped_chest	146
tripWire	132
tripwire_hook	131
undyed_shulker_box	205
unlit_redstone_torch	75
unpowered_comparator	149
unpowered_repeater	93
vine	106
wall_banner	177
wall_sign	68
water	9
waterlily	111
web	30
wheat	59
white_glazed_terracotta	220
wooden_button	143
wooden_door	64
wooden_pressure_plate	72
wooden_slab	158
wool	35
yellow_flower	37
yellow_glazed_terracotta	224

Items#

Name	ID	Aux Values
acacia_door	430
anvil	145
apple	260
appleEnchanted	466
armor_stand	425
arrow	262
baked_potato	393
banner	446
beacon	138
bed	355
beef	363
beetroot	457
beetroot_seeds	458
beetroot_soup	459
birch_door	428
blaze_powder	377
blaze_rod	369
boat	333
bone	352
book	340
bow	261
bowl	281
bread	297
brewingStandBlock	117
brewing_stand	379
brick	336
brown_mushroom_block	99
bucket	325	0 = Empty Bucket 1 = Milk 10 = Lava 8 = Water
cake	354
carpet	171
carrot	391
carrotOnAStick	398
cauldron	380
chainmail_boots	305
chainmail_chestplate	303
chainmail_helmet	302
chainmail_leggings	304
chest_minecart	342
chicken	365
chorus_fruit	432
chorus_fruit_popped	433
clay_ball	337
clock	347
clownfish	461
coal	263
cobblestone_wall	139
command_block_minecart	443
comparator	404
compass	345
concrete	236
concrete_powder	237
cooked_beef	364
cooked_chicken	366
cooked_fish	350
cooked_porkchop	320
cooked_rabbit	412
cooked_salmon	463
cookie	357
dark_oak_door	431
diamond	264
diamond_axe	279
diamond_boots	313
diamond_chestplate	311
diamond_helmet	310
diamond_hoe	293
diamond_leggings	312
diamond_pickaxe	278
diamond_shovel	277
diamond_sword	276
dirt	3
double_plant	175
double_stone_slab	44
double_stone_slab2	182
dragon_breath	437
dye	351
egg	344
elytra	444
emerald	388
emptyMap	395
enchanted_book	403
end_crystal	426
end_portal_frame	120
ender_eye	381
ender_pearl	368
experience_bottle	384
feather	288
fence	85
fermented_spider_eye	376
fireball	385
fireworks	401
fireworksCharge	402
fish	349
fishing_rod	346
flint	318
flint_and_steel	259
flower_pot	390
frame	389
ghast_tear	370
glass_bottle	374
glowstone_dust	348
gold_ingot	266
gold_nugget	371
golden_apple	322
golden_axe	286
golden_boots	317
golden_carrot	396
golden_chestplate	315
golden_helmet	314
golden_hoe	294
golden_leggings	316
golden_pickaxe	285
golden_shovel	284
golden_sword	283
gunpowder	289
hopper	410
hopper_minecart	408
horsearmordiamond	419
horsearmorgold	418
horsearmoriron	417
horsearmorleather	416
iron_axe	258
iron_boots	309
iron_chestplate	307
iron_door	330
iron_helmet	306
iron_hoe	292
iron_ingot	265
iron_leggings	308
iron_nugget	452
iron_pickaxe	257
iron_shovel	256
iron_sword	267
jungle_door	429
lead	420
leather	334
leather_boots	301
leather_chestplate	299
leather_helmet	298
leather_leggings	300
leaves	18
leaves2	161
lingering_potion	441
log	17
log2	162
magma	213
magma_cream	378
map	358
melon	360
melon_seeds	362
minecart	328
monster_egg	97
mushroom_stew	282
muttonCooked	424
muttonRaw	423
nameTag	421
netherStar	399
nether_wart	372
netherbrick	405
painting	321
paper	339
piston	33
planks	5
poisonous_potato	394
porkchop	319
potato	392
potion	373
prismarine	168
prismarine_crystals	422
prismarine_shard	409
pufferfish	462
pumpkin_pie	400
pumpkin_seeds	361
purpur_block	201
quartz	406
quartz_block	155
rabbit	411
rabbit_foot	414
rabbit_hide	415
rabbit_stew	413
record_11	510
record_13	500
record_blocks	502
record_cat	501
record_chirp	503
record_far	504
record_mall	505
record_mellohi	506
record_stal	507
record_strad	508
record_wait	511
record_ward	509
red_flower	38
red_mushroom_block	100
red_sandstone	179
redstone	331
reeds	338
repeater	356
rotten_flesh	367
saddle	329
salmon	460
sand	12
sandstone	24
sapling	6
seaLantern	169
shears	359
shulker_box	218
shulker_shell	445
sign	323
skull	397	0 = Skeleton 1 = Wither 2 = Zombie 3 = Steve 4 = Creeper 5 = Dragon
slime_ball	341
snow_layer	78
snowball	332
spawn_egg	383
speckled_melon	382
spider_eye	375
splash_potion	438
sponge	19
spruce_door	427
stained_glass	241
stained_glass_pane	160
stained_hardened_clay	159
stick	280
sticky_piston	29
stone	1
stone_axe	275
stone_hoe	291
stone_pickaxe	274
stone_shovel	273
stone_sword	272
stonebrick	98
string	287
sugar	353
tallgrass	31
tnt_minecart	407
totem	450
undyed_shulker_box	205
waterlily	111
wheat	296
wheat_seeds	295
wooden_axe	271
wooden_door	324
wooden_hoe	290
wooden_pickaxe	270
wooden_shovel	269
wooden_slab	158
wooden_sword	268
wool	35
writable_book	386
written_book	387
yellow_flower	37