Czech, Thai, and Turkish language wikis are now available. Please help with translating!

Pocket Edition entity components

From Minecraft Wiki
Jump to: navigation, search

Contents

Version: 1.1.4.51[edit | edit source]

Properties[edit | edit source]

minecraft:ambient_sound_interval[edit | edit source]

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


minecraft:burns_in_daylight[edit | edit source]

Description
Sets that this entity burns if exposed to daylight.


minecraft:can_climb[edit | edit source]

Description
Allows this entity to climb up ladders.


minecraft:can_fly[edit | edit source]

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[edit | edit source]

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


minecraft:collision_box[edit | edit source]

Description
Sets the width and height of the Entity's collision box.
Parameters
Parameters Type Default Description
width Decimal 1 Width and Depth of the Collision Box in Blocks
height Decimal 1 Height of the Collision Box in Blocks


minecraft:color[edit | edit source]

Description
Defines the entity's color
Parameters
Parameters Type Default Description
value Integer 0 The Palette Color value of the entity


minecraft:default_look_angle[edit | edit source]

Description
Sets this entity's default head rotation angle.


minecraft:equipment[edit | edit source]

Description
Sets the Equipment table to use for this Entity
Parameters
Parameters Type Default Description
table String The path to the equipment table, relative to the Behavior Pack's root


minecraft:fire_immune[edit | edit source]

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


minecraft:floats_in_liquid[edit | edit source]

Description
Sets that this entity can float in liquid blocks.


minecraft:flying_speed[edit | edit source]

Description
Speed in Blocks that this entity flies at.
Parameters
Parameters Type Default Description
value Decimal 0 Flying speed in blocks per tick


minecraft:foot_size[edit | edit source]

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


minecraft:friction_modifier[edit | edit source]

Description
Defines how much does friction affect this entity.


minecraft:ground_offset[edit | edit source]

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


minecraft:hurt_when_wet[edit | edit source]

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


minecraft:identifier[edit | edit source]

Description
Sets the name for this entity's description.
Parameters
Parameters Type Default Description
id String The identifier by which this entity definition can be recognized. Should be unique


minecraft:input_ground_controlled[edit | edit source]

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


minecraft:is_baby[edit | edit source]

Description
Sets that this entity is a baby.


minecraft:is_charged[edit | edit source]

Description
Sets that this entity is charged.


minecraft:is_chested[edit | edit source]

Description
Sets that this entity is currently carrying a chest.


minecraft:is_dyeable[edit | edit source]

Description
Allows dyes to be used on this entity to change its color.
Parameters
Parameters Type Default 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[edit | edit source]

Description
Sets that this entity is currently on fire.


minecraft:is_saddled[edit | edit source]

Description
Sets that this entity is currently saddled.


minecraft:is_shaking[edit | edit source]

Description
Sets that this entity is currently shaking.


minecraft:is_sheared[edit | edit source]

Description
Sets that this entity is currently sheared.


minecraft:is_stackable[edit | edit source]

Description
Sets that this entity can be stacked.


minecraft:is_tamed[edit | edit source]

Description
Sets that this entity is currently tamed.


minecraft:item_controllable[edit | edit source]

Description
Defines what items can be used to control this entity while ridden
Parameters
Parameters Type Default Description
control_items List List of items that can be used to control this entity


minecraft:loot[edit | edit source]

Description
Sets the loot table for what items this entity drops upon death.
Parameters
Parameters Type Default Description
table String The path to the loot table, relative to the Behavior Pack's root


minecraft:mark_variant[edit | edit source]

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


minecraft:push_through[edit | edit source]

Description
Sets the distance through which the entity can push through.


minecraft:scale[edit | edit source]

Description
Sets the entity's visual size.
Parameters
Parameters Type Default Description
value Decimal 1 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[edit | edit source]

Description
Sets the entity's base volume for sound effects.


minecraft:type_family[edit | edit source]

Description
Defines the families this entity belongs to.
Parameters
Parameters Type Default Description
family List List of family names


minecraft:variant[edit | edit source]

Description
Used to differentiate the component group of a variant of an entity from others (e.g. ocelot, villager)
Parameters
Parameters Type Default Description
value Integer 1 The ID of the variant. By convention, 0 is the ID of the base entity


minecraft:walk_animation_speed[edit | edit source]

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


minecraft:wants_jockey[edit | edit source]

Description
Sets that this entity wants to become a jockey.



Attributes[edit | edit source]

minecraft:attack[edit | edit source]

Description
Defines an entity's melee attack and any additional effects on it.
Parameters
Parameters Type Default Description
damage Range [a, b] Range of the random amount of damage the melee attack deals
effect_duration Decimal 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[edit | edit source]

Description
Defines what mob effects to add and remove to the entity when adding this component.
Parameters
Parameters Type Default Description
add_effects String List of effects to add to this entity after adding this component
remove_effects List List of names of effects to be removed from this entity after adding this component


minecraft:strength[edit | edit source]

Description
Defines the entity's strength to carry items


Components[edit | edit source]

minecraft:addrider[edit | edit source]

Description
Adds a rider to the entity. Requires minecraft:rideable.
Parameters
Parameters Type Default Description
entity_type String The entity type that will be riding this entity.


minecraft:ageable[edit | edit source]

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
Parameters Type Default Description
duration Decimal 1200 Amount of time before the entity grows
grow_up Trigger Event to run when this entity grows up
feedItems String 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


minecraft:angry[edit | edit source]

Description
Defines the entity's 'angry' state using a timer.
Parameters
Parameters Type Default Description
broadcastAnger Boolean false If true, other entities of the same entity definition within the broadcastRange will also become angry
duration Integer 25 The amount of time in seconds that the entity will be angry
calm_event Trigger Event to run after the number of seconds specified in duration expires (when the entity stops being 'angry'
broadcastRange Integer 20 Distance in blocks within which other entities of the same entity definition will become angry


minecraft:boostable[edit | edit source]

Description
Defines the conditions and behavior of a rideable entity's boost
Parameters
Parameters Type Default Description
speed_multiplier Decimal 1 Factor by which the entity's normal speed increases. E.g. 2.0 means go twice as fast
duration Decimal 3 Time in seconds for the boost
boost_items String List of items that can be used to boost while riding this entity


minecraft:breathable[edit | edit source]

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


minecraft:breedable[edit | edit source]

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


minecraft:damage_sensor[edit | edit source]

Description
Defines what events to call when this entity is damaged by specific entities or items
Parameters
Parameters Type Default 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 Trigger 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[edit | edit source]

Description
Creates a trigger based on environment conditions.
Parameters
Parameters Type Default Description
on_environment Trigger The list of triggers that fire when the environment conditions match the given filter criteria.


minecraft:equippable[edit | edit source]

Description
Defines an entity's behavior for having items equipped to it
Parameters
Parameters Type Default Description
slots String List of slots and the item that can be equipped


minecraft:explode[edit | edit source]

Description
Defines how the entity explodes.
Parameters
Parameters Type Default Description
fuseLength Range [a, b] The range for the random amount of time the fuse will be lit before exploding. A negative value means the explosion will be immediate
power Decimal 3 The radius of the explosion in blocks and the amount of damage the explosion deals
maxResistance Decimal -2147483648 Blocks with less resistance than this value will be broken by the explosion
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
fuseLit Boolean false If true, the fuse is already lit when this component is added to the entity
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


minecraft:healable[edit | edit source]

Description
Defines the interactions with this entity for healing it.
Parameters
Parameters Type Default Description
items String The list of items that can be used to heal this entity


minecraft:interact[edit | edit source]

Description
Defines interactions with this entity.
Parameters
Parameters Type Default Description
use_item Boolean false If true, the interaction will use an item
cooldown Decimal 0 Time in seconds before this entity can be interacted with again
swing Boolean false If true, the player will do the 'swing' animation when interacting with this entity
hurt_item Integer 0 The amount of damage the item will take when used to interact with this entity. A value of 0 means the item won't lose durability
interact_text String Text to show when the player is able to interact in this way with this entity when playing with Touch-screen controls
table String File path, relative to the Behavior Pack's path, to the loot table file
add_items String Loot table with items to add to the player's inventory upon successful interaction
spawn_items String Loot table with items to drop on the ground upon successful interaction
transform_to_item String The item used will transform to this item upon successful interaction. Format: itemName:auxValue
play_sounds List List of sounds to play when the interaction occurs
on_interact Trigger Event to fire when the interaction occurs


minecraft:inventory[edit | edit source]

Description
Defines this entity's inventory properties.
Parameters
Parameters Type Default Description
container_type String none Type of container this entity has. Can be horse, minecart_chest, minecart_hopper, inventory, container or hopper
can_be_siphoned_from Boolean false If true, the contents of this inventory can be removed by a hopper
linked_slots_size Integer 0 Number of linked slots (e.g. Player Hotbar) the container has
inventory_size Integer 5 Number of slots the container has
restrict_to_owner Boolean false If true, the entity's inventory can only be accessed by its owner or itself
private Boolean false If true, only the entity can access the inventory


minecraft:item_hopper[edit | edit source]

Description
Determines that this entity is an item hopper


minecraft:jump.dynamic[edit | edit source]

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


minecraft:jump.static[edit | edit source]

Description
Gives the entity the ability to jump.


minecraft:leashable[edit | edit source]

Description
Allows this entity to be leashed and Defines the conditions and events for this entity when is leashed.
Parameters
Parameters Type Default Description
max_distance Decimal 10 Distance in blocks at which the leash breaks
hard_distance Decimal 6 Distance in blocks at which the leash stiffens, restricting movement
soft_distance Decimal 4 Distance in blocks at which the 'spring' effect starts acting to keep this entity close to the entity that leashed it
on_unleash Trigger Event to call when this entity is unleashed
on_leash Trigger Event to call when this entity is leashed


minecraft:lookat[edit | edit source]

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


minecraft:movement.basic[edit | edit source]

Description
This component accents the movement of an entity.
Parameters
Parameters Type Default Description
max_turn Decimal 30 The maximum number in degrees the mob can turn per tick.


minecraft:movement.jump[edit | edit source]

Description
Move control that causes the mob to jump as it moves with a specified delay between jumps.
Parameters
Parameters Type Default Description
jump_delay Range [a, b] Delay after landing when using the slime move control.
max_turn Decimal 30 The maximum number in degrees the mob can turn per tick.


minecraft:movement.skip[edit | edit source]

Description
This move control causes the mob to hop as it moves.
Parameters
Parameters Type Default Description
max_turn Decimal 30 The maximum number in degrees the mob can turn per tick.


minecraft:movement.sway[edit | edit source]

Description
This move control causes the mob to sway side to side giving the impression it is swimming.
Parameters
Parameters Type Default Description
max_turn Decimal 30 The maximum number in degrees the mob can turn per tick.


minecraft:nameable[edit | edit source]

Description
Allows this entity to be named (e.g. using a name tag)
Parameters
Parameters Type Default Description
name_actions String Describes the special names for this entity and the events to call when the entity acquires those names
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 Trigger Trigger to run when this entity is successfully renamed


minecraft:navigation.climb[edit | edit source]

Description
Describes to the mobs pathfinder how it can generate paths.
Parameters
Parameters Type Default Description
can_pass_doors Boolean true Whether a path can be created through a door
avoid_sun Boolean false Whether or not the pathfinder should avoid tiles that are exposed to the when creating paths
can_float Boolean false Tells the pathfinder whether or not it can float in water
avoid_portals Boolean false Tells the pathfinder to avoid portals (like nether portals) when finding a path
avoid_water Boolean false Tells the pathfinder to avoid water when creating a path
can_open_doors Boolean false Tells the pathfinder that it can path through a closed door assuming the AI will open the door


minecraft:navigation.float[edit | edit source]

Description
Describes to the mobs pathfinder how it can generate paths.
Parameters
Parameters Type Default Description
can_pass_doors Boolean true Whether a path can be created through a door
avoid_sun Boolean false Whether or not the pathfinder should avoid tiles that are exposed to the when creating paths
can_float Boolean false Tells the pathfinder whether or not it can float in water
avoid_portals Boolean false Tells the pathfinder to avoid portals (like nether portals) when finding a path
avoid_water Boolean false Tells the pathfinder to avoid water when creating a path
can_open_doors Boolean false Tells the pathfinder that it can path through a closed door assuming the AI will open the door


minecraft:navigation.swim[edit | edit source]

Description
Describes to the mobs pathfinder how it can generate paths.
Parameters
Parameters Type Default Description
can_pass_doors Boolean true Whether a path can be created through a door
avoid_sun Boolean false Whether or not the pathfinder should avoid tiles that are exposed to the when creating paths
can_float Boolean false Tells the pathfinder whether or not it can float in water
avoid_portals Boolean false Tells the pathfinder to avoid portals (like nether portals) when finding a path
avoid_water Boolean false Tells the pathfinder to avoid water when creating a path
can_open_doors Boolean false Tells the pathfinder that it can path through a closed door assuming the AI will open the door


minecraft:navigation.walk[edit | edit source]

Description
Describes to the mobs pathfinder how it can generate paths.
Parameters
Parameters Type Default Description
can_pass_doors Boolean true Whether a path can be created through a door
avoid_sun Boolean false Whether or not the pathfinder should avoid tiles that are exposed to the when creating paths
can_float Boolean false Tells the pathfinder whether or not it can float in water
avoid_portals Boolean false Tells the pathfinder to avoid portals (like nether portals) when finding a path
avoid_water Boolean false Tells the pathfinder to avoid water when creating a path
can_open_doors Boolean false Tells the pathfinder that it can path through a closed door assuming the AI will open the door


minecraft:peek[edit | edit source]

Description
Defines the entity's 'peek' behavior, defining the events that should be called during it
Parameters
Parameters Type Default Description
on_target_open Trigger Event to call when the entity's target entity starts peeking
on_close Trigger Event to call when the entity is done peeking
on_open Trigger Event to call when the entity starts peeking


minecraft:projectile[edit | edit source]

Description
Allows the entity to be a thrown entity.
Parameters
Parameters Type Default Description
homing Boolean false If true, the projectile homes in to the nearest entity
gravity Decimal 0 The gravity applied to this entity when thrown. The higher the value, the faster the entity falls
reflectOnHurt Boolean false If true, this entity will be reflected back when hit
destroyOnHurt Boolean false If true, this entity will be destroyed when hit
particle String iconcrack Particle to use upon collision
angleoffset Decimal 0 Determines the angle at which the projectile is thrown
offset Vector [a, b, c] [0, 0.5, 0] The offset from the entity's anchor where the projectile will spawn
power Decimal 1 Determines the velocity of the projectile
uncertaintyMultiplier Decimal 0 Determines how much difficulty affects accuracy. Accuracy is determined by the formula uncertaintyBase - difficultyLevel * uncertaintyMultiplier
fireAffectedByGriefing Boolean false If true, whether the projectile causes fire is affected by the mob griefing game rule
uncertaintyBase Decimal 0 The base accuracy. Accuracy is determined by the formula uncertaintyBase - difficultyLevel * uncertaintyMultiplier
critParticleOnHurt Boolean false If true, the projectile will produce additional particles when a critical hit happens
knockback Boolean true If true, the projectile will knock back the entity it hits
filter String Entity Definitions defined here can't be hurt by the projectile
semirandomdiffdamage Boolean false If true, damage will be randomized based on damage and speed
catchFire Boolean false If true, the entity hit will be set on fire
onFireTime Decimal 5 Time in seconds that the entity hit will be on fire for
potionEffect Integer -1 Defines the effect the arrow will apply to the entity it hits
splashRange Decimal 4 Radius in blocks of the 'splash' effect
shoottarget Boolean true If true, the projectile will be shot towards the target of the entity firing it
splashPotion Boolean false If true, the projectile will be treated like a splash potion
isdangerous Boolean false If true, the projectile will be treated as dangerous to the players
shootSound String The sound that plays when the projectile is shot
hitSound String The sound that plays when the projectile hits something
inertia Decimal 0 The fraction of the projectile's speed maintained every frame while traveling in air
shouldbounce Boolean false If true, the projectile will bounce upon hit
liquid_inertia Decimal 0 The fraction of the projectile's speed maintained every frame while traveling in water


minecraft:rail_movement[edit | edit source]

Description
Defines the entity's movement on the rails. An entity with this component is only allowed to move on the rail.
Parameters
Parameters Type Default Description
max_speed Decimal 0 Maximum speed that this entity will move at when on the rail


minecraft:rail_sensor[edit | edit source]

Description
Defines the behavior of the entity when the rail gets activated or deactivated.
Parameters
Parameters Type Default Description
tick_command_block_on_activate Boolean true If true, command blocks will start ticking when passing over an activated rail
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
tick_command_block_on_deactivate Boolean false If false, command blocks will stop ticking when passing over a deactivated rail
on_deactivate Trigger Event to call when the rail is deactivated
on_activate Trigger Event to call when the rail is activated
eject_on_deactivate Boolean false If true, this entity will eject all of its riders when it passes over a deactivated rail


minecraft:rideable[edit | edit source]

Description
Determines whether this entity can be ridden. Allows specifying the different seat positions and quantity.
Parameters
Parameters Type Default Description
seat_count Integer 1 The number of entities that can ride this entity at the same time
crouching_skip_interact Boolean true If true, this entity can't be interacted with if the entity interacting with it is crouching
interact_text String The text to display when the player can interact with the entity when playing with Touch-screen controls
seats String The list of positions and number of riders for each position for entities riding this entity
controlling_seat Integer 0 The seat that designates the driver of the entity
family_types List List of entities that can ride this entity


minecraft:scale_by_age[edit | edit source]

Description
Defines the entity's size interpolation based on the entity's age.
Parameters
Parameters Type Default Description
start_scale Decimal 1 Initial scale of the newborn entity
end_scale Decimal 1 Ending scale of the entity when it's fully grown


minecraft:shareables[edit | edit source]

Description
Defines a list of items the mob wants to share.


minecraft:shooter[edit | edit source]

Description
Defines the entity's ranged attack behavior.
Parameters
Parameters Type Default Description
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
auxVal Integer -1 ID of the Potion effect to be applied on hit


minecraft:sittable[edit | edit source]

Description
Defines the entity's 'sit' state.
Parameters
Parameters Type Default Description
stand_event Trigger Event to run when the entity exits the 'sit' state
sit_event Trigger Event to run when the entity enters the 'sit' state


minecraft:spawn_entity[edit | edit source]

Description
Adds a timer after which this entity will spawn another entity or item (similar to vanilla's chicken's egg-laying behavior.
Parameters
Parameters Type Default Description
spawn_sound String plop Name of the sound effect to play when the entity is spawned
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_method String born Method to use to spawn the entity
spawn_entity String Identifier of the entity to spawn. Leave empty to spawn the item defined above instead
spawn_item String egg Name of the item to spawn
spawn_event String minecraft:entity_born Event to call when the entity is spawned


minecraft:tameable[edit | edit source]

Description
Defines the rules for a mob to be tamed by the player.
Parameters
Parameters Type Default Description
tameItems List The list of items that can be used to tame this entity
probability Decimal 1 The chance of taming the entity with each item use between 0.0 and 1.0, where 1.0 is 100%
tame_event Trigger Event to run when this entity becomes tamed


minecraft:tamemount[edit | edit source]

Description
Allows the Entity to be tamed by mounting it.
Parameters
Parameters Type Default Description
feedItems String The list of items that can be used to increase the entity's temper and speed up the taming process
feed_text String The text that shows in the feeding interact button
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
attemptTemperMod Integer 5 The amount the entity's temper will increase when mounted
ride_text String The text that shows in the riding interact button
tame_event Trigger Event that triggers when the entity becomes tamed
autoRejectItems String The list of items that, if carried while interacting with the entity, will anger it


minecraft:target_nearby_sensor[edit | edit source]

Description
Defines the entity's range within which it can see or sense other entities to target them.
Parameters
Parameters Type Default Description
inside_range Decimal 1 Maximum distance in blocks that another entity will be considered in the 'inside' range
outside_range Decimal 5 Maximum distance in blocks that another entity will be considered in the 'outside' range
on_outside_range Trigger Event to call when an entity gets in the outside range. Can specify 'event' for the name of the event and 'target' for the target of the event
on_inside_range Trigger 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


minecraft:teleport[edit | edit source]

Description
Defines an entity's teleporting behavior.
Parameters
Parameters Type Default Description
randomTeleports Boolean true If true, the entity will teleport randomly
maxRandomTeleportTime Decimal 20 Maximum amount of time in seconds between random teleports
minRandomTeleportTime Decimal 0 Minimum amount of time in seconds between random teleports
target_teleport_chance Decimal 1 The chance that the entity will teleport between 0.0 and 1.0. 1.0 means 100%
targetDistance Decimal 16 Maximum distance the entity will teleport when chasing a target
randomTeleportCube Vector [a, b, c] [32, 16, 32] Entity will teleport to a random position within the area defined by this cube
darkTeleportChance Decimal 0 Modifies the chance that the entity will teleport if the entity is in darkness
lightTeleportChance Decimal 0 Modifies the chance that the entity will teleport if the entity is in daylight


minecraft:timer[edit | edit source]

Description
Adds a timer after which an event will fire.
Parameters
Parameters Type Default Description
looping Boolean true If true, the timer will restart every time after it fires
time_down_event Trigger Event to fire when the time on the timer runs out
time Range [a, b] Amount of time in seconds for the timer. Can be specified as a number or a pair of numbers (min and max)
randomInterval Boolean true If true, the amount of time on the timer will be random between the min and max values specified in time


minecraft:trade_table[edit | edit source]

Description
Defines this entity's ability to trade with players.
Parameters
Parameters Type Default 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[edit | edit source]

Description
Defines an entity's transformation from the current definition into another
Parameters
Parameters Type Default Description
begin_transform_sound List Sound to play when the transformation starts
into String Entity Definition that this entity will transform into
transformation_sound List Sound to play when the entity is done transforming
add String List of components to add to the entity after the transformation
component_groups List Names of component groups to add
delay String Defines the properties of the delay for the transformation
value Decimal 0 Time in seconds before the entity transforms
block_assist_chance Decimal 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_radius Integer 0 Distance in Blocks that the entity will search for blocks that can help 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_chance Decimal 0 Chance that, once a block is found, will help speed up the transformation
block_types List List of blocks that can help the transformation of this entity


Entity Triggers[edit | edit source]

Name Default Description
minecraft:on_friendly_anger Adds the On Friendly Anger trigger to this entity.
minecraft:on_death Adds a trigger to call on this entity's death.
minecraft:on_hurt_by_player Adds a trigger to call when this entity is attacked by the player.
minecraft:on_hurt Adds a trigger to call when this entity takes damage.
minecraft:on_target_acquired Adds a trigger to call when this entity finds a target.
minecraft:on_start_takeoff Adds a trigger to call when this entity starts flying.
minecraft:on_start_landing Adds a trigger to call when this entity lands.
minecraft:on_ignite Adds a trigger to call when this entity is set on fire.
minecraft:on_target_escape Adds a trigger to call when this entity loses the target it currently has.


Filters[edit | edit source]

Parameter Description
with_item Return true if any of the items listed is in the owning entity's hands.
target_without_armor Returns true if all of the items listed aren't being worn by the owning entity's target.
player_with_instabuild Checks if the player is in creative mode.
without_item Return true if all of the items listed aren't in the owning entity's hands.
without_armor Return true if all of the items listed aren't being worn by the owning entity.
with_armor Return true if any of the items listed are being worn by the owning entity.
without_equipment Return true if all of the items listed aren't in the hands or being worn by the owning entity.
target_without_components Returns true if the owning entity's target has none of the components listed.
with_equipment Return true if all of the items listed are either in the hands or being worn by the owning entity.
with_families Returns true if the owning entity has any of the families listed.
without_components Returns true if the owning entity has none of the components listed.
target_without_families Returns true if the owning entity's target has none of the families listed.
with_components Returns true if the owning entity has all the components listed.
other_without_color Returns true if the entity being filtered is not of a specific color.
without_families Returns true if the owning entity has none of the families listed.
is_in_caravan Returns true if the owning entity is part of a caravan.
other_with_color Returns true if the entity being filtered is of a specific color.
target_without_variant Returns true if the owning entity's target is not a variant.
is_not_in_caravan Returns true if the owning entity is not part of a caravan.
with_variant Returns true if the owning entity is a variant.
is_game_rule_true Returns true if the specified game rule is active.
without_variant Returns true if the owning entity is not a variant.
with_environment_any Return true if any of the environmental conditions listed exist in the owning entity's surroundings.
with_color Returns true if the owning entity is a special color.
without_color Returns true if the owning entity is not a special color.
other_without_armor Return true if all of the items listed aren't being worn by the entity being filtered.
with_damage_cause Only valid in damage sensor trigger. Return true if damage is of type listed.
with_damage_fatal Only valid in damage sensor trigger. Return true if damage taken is fatal.
without_environment_any Return true if any of the environmental conditions listed do not exist in the owning entity's surroundings.
with_environment_every Return true if all of the environmental conditions listed exist in the owning entity's surroundings.
without_environment_every Return true if all of the environmental conditions listed do not exist in the owning entity's surroundings.
target_with_item Returns true if any of the items listed is in the owning entity's targets hands.
other_with_equipment Return true if all of the items listed are either in the hands or being worn by the entity being filtered.
target_without_item Returns true if all of the items listed aren't in the owning entity's targets hands.
other_without_components Returns true if the entity being filtered has none of the components listed.
target_with_armor Returns true if any of the items listed are being worn by the owning entity's target.
target_with_equipment Returns true if all of the items listed are either in the hands or being worn by the owning entity's target.
other_is_owner Returns true if the entity being filtered is owned by this entity.
target_without_equipment Returns true if all of the items listed aren't in the hands or being worn by the owning entity's target.
target_with_components Returns true if the owning entity's target has all the components listed.
other_with_families Returns true if the entity being filtered has any of the families listed.
target_with_families Returns true if the owning entity's target has any of the families listed.
other_without_variant Returns true if the entity being filtered is not a variant.
target_with_variant Returns true if the owning entity's target is a variant.
target_with_color Returns true if the owning entity's target is of a specific color.
target_without_color Returns true if the owning entity's target is not of a specific color.
other_with_item Return true if any of the items listed is in the hands of the entity being filtered.
other_without_item Return true if all of the items listed aren't in the hands of the entity being filtered.
other_with_armor Return true if any of the items listed are being worn by entity being filtered.
other_without_equipment Return true if all of the items listed aren't in the hands or being worn by the entity being filtered.
other_with_components Returns true if the entity being filtered has all the components listed.
other_without_families Returns true if the entity being filtered has none of the families listed.
other_is_target Returns true if the entity being filtered is this entity's current target.
other_is_in_caravan Returns true if the entity being filtered is in a caravan.
other_is_not_in_caravan Returns true if the entity being filtered is not in a caravan.
other_with_variant Returns true if the entity being filtered is a variant.
is_world_difficulty Returns true if the world has the specified difficulty set.
is_not_world_difficulty Returns true if the world does not have the specified difficulty set.
is_game_rule_false Returns true if the specified game rule is not active.


Environment Filter Conditions[edit | edit source]

Condition Description
underground
surface
altitude_greater
altitude_less
brightness_greater
brightness_less
night
day
biome


Biomes[edit | edit source]

Biome Description
beach
mesa
jungle
swamp
desert
flat
river
the_nether
plain
forest
extreme_hills
ice
mushroom_island
ocean
savanna
stone_beach
taiga
the_end


AI Goals[edit | edit source]

Behavior Description
minecraft:behavior.avoid_mob_type Allows this entity to avoid certain mob types.
minecraft:behavior.beg Allows this mob to look at and follow the player that holds food they like.
minecraft:behavior.break_door Allows this mob to break doors.
minecraft:behavior.breed Allows this mob to breed with other mobs.
minecraft:behavior.charge_attack Allows the mob to attack its target by running at it.
minecraft:behavior.controlled_by_player Allows the mob to be controlled by the player.
minecraft:behavior.defend_village_target Allows the mob to stay in the village and fight mobs hostile to the villagers.
minecraft:behavior.door_interact Allows the mob to open and close doors.
minecraft:behavior.dragonchargeplayer Allows the dragon to attack a player by flying fast at them. The player is chosen by the dragonscanninggoal. Can only be used by the Ender Dragon.
minecraft:behavior.dragondeath 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 Allows the dragon to use its flame breath attack. Can only be used by the Ender Dragon.
minecraft:behavior.dragonholdingpattern Allows the Dragon to fly around in a circle around the center podium. Can only be used by the Ender Dragon.
minecraft:behavior.dragonlanding Allows the Dragon to stop flying and transition into perching mode. Can only be used by the Ender Dragon.
minecraft:behavior.dragonscanning 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 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 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 Allows the mob to eat a block (for example, sheeps eating grass).
minecraft:behavior.enderman_leave_block Allows the enderman to drop a block they are carrying. Can only be used by Endermen.
minecraft:behavior.enderman_take_block Allows the enderman to take a block and carry it around. Can only be used by Endermen.
minecraft:behavior.find_mount Allows the mob to look around for another mob to ride atop it.
minecraft:behavior.flee_sun Allows the mob to run away from direct sunlight and seek shade.
minecraft:behavior.float Allows the mob to stay afloat while swimming.
minecraft:behavior.float_wander Allows the mob to float around like the Ghast.
minecraft:behavior.follow_caravan Allows the mob to follow mobs that are in a caravan.
minecraft:behavior.follow_owner Allows the mob to follow the player that owns them.
minecraft:behavior.follow_parent Allows the mob to follow their parent around.
minecraft:behavior.guardian_attack Allows the guardian to use its laser beam attack. Can only be used by Guardians and Elder Guardians.
minecraft:behavior.harvest_farm_block Allows the villager to harvest nearby farms. Can only be used by Villagers.
minecraft:behavior.hurt_by_target Allows the mob to target another mob that hurts them.
minecraft:behavior.leap_at_target Allows monsters to jump at and attack their target. Can only be used by hostile mobs.
minecraft:behavior.look_at_entity Allows the mob to look at nearby entities.
minecraft:behavior.look_at_player Allows the mob to look at the player when the player is nearby.
minecraft:behavior.look_at_target Allows the mob to look at the entity they are targetting.
minecraft:behavior.look_at_trading_player Allows the mob to look at the player they are trading with.
minecraft:behavior.make_love Allows the villager to look for a mate to spawn other villagers with. Can only be used by Villagers.
minecraft:behavior.melee_attack Allows the mob to use close combat melee attacks.
minecraft:behavior.mount_pathing Allows the mob to move around on its own while mounted.
minecraft:behavior.move_indoors Can only be used by Villagers. Allows them to seek shelter indoors.
minecraft:behavior.move_through_village Allows mob to path through villages. (This is done by making the entity visit all the doors in the village. It's more of a patrol than pathing through the village)
minecraft:behavior.move_towards_restriction Allows mob to move towards a defined area that the mob should be restricted to.
minecraft:behavior.move_towards_target Allows mob to move towards its current target.
minecraft:behavior.nearest_attackable_target Allows the mob to check for and pursue the nearest valid target.
minecraft:behavior.ocelot_sit_on_block Allows to mob to be able to sit in place like the ocelot.
minecraft:behavior.ocelotattack Allows the mob to attack like the ocelot.
minecraft:behavior.offer_flower Allows the mob to offer the player a flower like the Iron Golem does.
minecraft:behavior.open_door 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.
minecraft:behavior.owner_hurt_by_target Allows the mob to target another mob that hurts their owner.
minecraft:behavior.owner_hurt_target Allows the mob to target a mob that is hurt by their owner.
minecraft:behavior.panic Allows the mob to enter the panic state and run around in panic.
minecraft:behavior.peek Allows the mob to peek out. This is what the shulker uses to look out of its shell.
minecraft:behavior.pickup_items Allows the mob to pick up items on the ground.
minecraft:behavior.play Allows the mob to play with other baby villagers. This can only be used by Villagers.
minecraft:behavior.player_ride_tamed Allows the mob to be ridden by the player after being tamed.
minecraft:behavior.raid_garden Allows the mob to eat crops out of farms until they are full.
minecraft:behavior.random_look_around Allows the mob to randomly look around.
minecraft:behavior.random_stroll Allows a mob to randomly stroll around.
minecraft:behavior.ranged_attack Allows the mob to use ranged attacks like shooting arrows.
minecraft:behavior.receive_love Allows the villager to stop so another villager can breed with it. Can only be used by a Villager.
minecraft:behavior.restrict_open_door Allows the mob to stay indoors during night time.
minecraft:behavior.restrict_sun Allows the mob to automatically start avoiding the sun when its a clear day out.
minecraft:behavior.run_around_like_crazy Allows the mob to run around aimlessly.
minecraft:behavior.send_event Allows the mob to send an event to another mob.
minecraft:behavior.share_items Allows the mob to give items it has to others.
minecraft:behavior.silverfish_merge_with_stone 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 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 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.
minecraft:behavior.slime_attack Allows the mob to use a melee attack like the slime's.
minecraft:behavior.slime_float Allows the mob to float like slimes.
minecraft:behavior.slime_keep_on_jumping Allows the mob to continuously jump around like a slime.
minecraft:behavior.slime_random_direction Allows the mob to move in random directions like a slime.
minecraft:behavior.squid_dive Allows the squid to dive down in water. Can only be used by the Squid.
minecraft:behavior.squid_flee Allows the squid to swim away. Can only be used by the Squid.
minecraft:behavior.squid_idle Allows the squid to swim in place idly. Can only be used by the Squid.
minecraft:behavior.squid_move_away_from_ground 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 Allows the squid to stick to the ground when outside water. Can only be used by the Squid.
minecraft:behavior.stay_while_sitting Allows the mob to stay put while it is in a sitting state instead of doing something else.
minecraft:behavior.stomp_attack Allows the mob to use the stomp attack.
minecraft:behavior.summon_entity Allows the mob to attack the player by summoning other entities.
minecraft:behavior.swell Allows the creeper to swell up when a player is nearby. It can only be used by Creepers.
minecraft:behavior.take_flower Allows the mob to accept flowers from Iron Golems.
minecraft:behavior.tempt Allows the mob to be tempted by food they like.
minecraft:behavior.trade_with_player Allows the player to trade with this mob.
minecraft:behavior.vex_copy_owner_target Allows the mob to target the same entity its owner is targeting.
minecraft:behavior.vex_random_move Allows the mob to move around randomly like the Vex.
minecraft:behavior.wither_random_attack_pos_goal Allows the wither to launch random attacks. Can only be used by the Wither Boss.
minecraft:wither_target_highest_damage Allows the wither to target the player that has dealt the most damage to it. Can only be used by the Wither Boss.