ADDONS DOCUMENTATION
Version: 1.8.0.0

Index

Entity Definition Properties
do_not_upgrade
format_version
Entity Description Properties
minecraft:identifier
minecraft:is_experimental
minecraft:is_summonable
minecraft:runtime_identifier
minecraft:spawn_egg
Attributes
minecraft:attack
minecraft:spell_effects
minecraft:strength
Properties
minecraft:ambient_sound_interval
minecraft:can_climb
minecraft:can_fly
minecraft:can_power_jump
minecraft:collision_box
minecraft:color
minecraft:color2
minecraft:default_look_angle
minecraft:equipment
minecraft:fire_immune
minecraft:floats_in_liquid
minecraft:flying_speed
minecraft:foot_size
minecraft:friction_modifier
minecraft:ground_offset
minecraft:input_ground_controlled
minecraft:is_baby
minecraft:is_charged
minecraft:is_chested
minecraft:is_dyeable
minecraft:is_ignited
minecraft:is_saddled
minecraft:is_shaking
minecraft:is_sheared
minecraft:is_stackable
minecraft:is_tamed
minecraft:item_controllable
minecraft:loot
minecraft:mark_variant
minecraft:push_through
minecraft:scale
minecraft:sound_volume
minecraft:type_family
minecraft:variant
minecraft:walk_animation_speed
minecraft:wants_jockey
Component IDs
Components
minecraft:addrider
minecraft:ageable
minecraft:angry
minecraft:boostable
minecraft:breathable
minecraft:breedable
minecraft:bribeable
minecraft:burns_in_daylight
minecraft:damage_over_time
minecraft:damage_sensor
minecraft:environment_sensor
minecraft:equippable
minecraft:explode
minecraft:genetics
minecraft:healable
minecraft:hurt_when_wet
minecraft:insomnia
minecraft:interact
minecraft:inventory
minecraft:item_hopper
minecraft:jump.dynamic
minecraft:jump.static
minecraft:leashable
minecraft:lookat
minecraft:movement.amphibious
minecraft:movement.basic
minecraft:movement.fly
minecraft:movement.generic
minecraft:movement.jump
minecraft:movement.skip
minecraft:movement.sway
minecraft:nameable
minecraft:navigation.climb
minecraft:navigation.float
minecraft:navigation.fly
minecraft:navigation.generic
minecraft:navigation.swim
minecraft:navigation.walk
minecraft:peek
minecraft:projectile
minecraft:rail_movement
minecraft:rail_sensor
minecraft:rideable
minecraft:scaffolding_climber
minecraft:scale_by_age
minecraft:shareables
minecraft:shooter
minecraft:sittable
minecraft:spawn_entity
minecraft:tameable
minecraft:tamemount
minecraft:target_nearby_sensor
minecraft:teleport
minecraft:tick_world
minecraft:timer
minecraft:trade_table
minecraft:transformation
minecraft:trusting
AI Goals
minecraft.behavior.scared
minecraft:behavior.avoid_mob_type
minecraft:behavior.beg
minecraft:behavior.break_door
minecraft:behavior.breed
minecraft:behavior.charge_attack
minecraft:behavior.circle_around_anchor
minecraft:behavior.controlled_by_player
minecraft:behavior.defend_village_target
minecraft:behavior.door_interact
minecraft:behavior.dragonchargeplayer
minecraft:behavior.dragondeath
minecraft:behavior.dragonflaming
minecraft:behavior.dragonholdingpattern
minecraft:behavior.dragonlanding
minecraft:behavior.dragonscanning
minecraft:behavior.dragonstrafeplayer
minecraft:behavior.dragontakeoff
minecraft:behavior.drop_item_for
minecraft:behavior.eat_block
minecraft:behavior.enderman_leave_block
minecraft:behavior.enderman_take_block
minecraft:behavior.find_mount
minecraft:behavior.find_underwater_treasure
minecraft:behavior.flee_sun
minecraft:behavior.float
minecraft:behavior.float_wander
minecraft:behavior.follow_caravan
minecraft:behavior.follow_mob
minecraft:behavior.follow_owner
minecraft:behavior.follow_parent
minecraft:behavior.go_home
minecraft:behavior.guardian_attack
minecraft:behavior.harvest_farm_block
minecraft:behavior.hurt_by_target
minecraft:behavior.lay_down
minecraft:behavior.lay_egg
minecraft:behavior.leap_at_target
minecraft:behavior.look_at_entity
minecraft:behavior.look_at_player
minecraft:behavior.look_at_target
minecraft:behavior.look_at_trading_player
minecraft:behavior.make_love
minecraft:behavior.melee_attack
minecraft:behavior.mount_pathing
minecraft:behavior.move_indoors
minecraft:behavior.move_through_village
minecraft:behavior.move_to_land
minecraft:behavior.move_to_water
minecraft:behavior.move_towards_restriction
minecraft:behavior.move_towards_target
minecraft:behavior.nearest_attackable_target
minecraft:behavior.ocelot_sit_on_block
minecraft:behavior.ocelotattack
minecraft:behavior.offer_flower
minecraft:behavior.open_door
minecraft:behavior.owner_hurt_by_target
minecraft:behavior.owner_hurt_target
minecraft:behavior.panic
minecraft:behavior.peek
minecraft:behavior.pet_sleep_with_owner
minecraft:behavior.pickup_items
minecraft:behavior.play
minecraft:behavior.player_ride_tamed
minecraft:behavior.raid_garden
minecraft:behavior.random_breach
minecraft:behavior.random_fly
minecraft:behavior.random_look_around
minecraft:behavior.random_sitting
minecraft:behavior.random_stroll
minecraft:behavior.random_swim
minecraft:behavior.ranged_attack
minecraft:behavior.receive_love
minecraft:behavior.restrict_open_door
minecraft:behavior.restrict_sun
minecraft:behavior.roll
minecraft:behavior.run_around_like_crazy
minecraft:behavior.send_event
minecraft:behavior.share_items
minecraft:behavior.silverfish_merge_with_stone
minecraft:behavior.silverfish_wake_up_friends
minecraft:behavior.skeleton_horse_trap
minecraft:behavior.slime_attack
minecraft:behavior.slime_float
minecraft:behavior.slime_keep_on_jumping
minecraft:behavior.slime_random_direction
minecraft:behavior.snacking
minecraft:behavior.sneeze
minecraft:behavior.squid_dive
minecraft:behavior.squid_flee
minecraft:behavior.squid_idle
minecraft:behavior.squid_move_away_from_ground
minecraft:behavior.squid_out_of_water
minecraft:behavior.stay_while_sitting
minecraft:behavior.stomp_attack
minecraft:behavior.stomp_turtle_egg
minecraft:behavior.summon_entity
minecraft:behavior.swell
minecraft:behavior.swim_wander
minecraft:behavior.swoop_attack
minecraft:behavior.take_flower
minecraft:behavior.tempt
minecraft:behavior.trade_with_player
minecraft:behavior.vex_copy_owner_target
minecraft:behavior.vex_random_move
minecraft:behavior.wither_random_attack_pos_goal
minecraft:behavior.wither_target_highest_damage
Filters
clock_time
has_ability
has_biome_tag
has_component
has_damage
has_equipment
in_caravan
in_clouds
in_lava
in_water
in_water_or_rain
is_altitude
is_biome
is_brightness
is_climbing
is_color
is_daytime
is_difficulty
is_family
is_game_rule
is_humid
is_immobile
is_moving
is_owner
is_riding
is_sneaking
is_snow_covered
is_target
is_temperature_type
is_temperature_value
is_underground
is_underwater
is_variant
moon_intensity
moon_phase
on_ground
on_ladder
Triggers
minecraft:on_death
minecraft:on_friendly_anger
minecraft:on_hurt
minecraft:on_hurt_by_player
minecraft:on_ignite
minecraft:on_start_landing
minecraft:on_start_takeoff
minecraft:on_target_acquired
minecraft:on_target_escape
minecraft:on_wake_with_owner
Built-in Events
minecraft:entity_born
minecraft:entity_spawned
minecraft:entity_transformed
minecraft:on_prime
Entities
Blocks
Geometry
Blocks
Back to top

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.
Back to top

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.
Back to top

Vanilla entities that use this

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


Entity Description Properties

Description

This section defines properties required to identify and construct the entity

minecraft:identifier

Description

Sets the name for this entity's description.

Parameters

Name Type Default Value Description
id String The identifier for this entity
Back to top

minecraft:is_experimental

Description

Sets whether or not this entity is experimental. Experimental entities are only enabled when the experimental toggle is enabled.

Parameters

Name Type Default Value Description
value Boolean false Flag to mark this entity as being experimental or not.
Back to top

minecraft:is_summonable

Description

Sets whether or not we can summon this entity using commands such as /summon.

Parameters

Name Type Default Value Description
value Boolean false Flag to mark this entity as being summonable or not.
Back to top

minecraft:runtime_identifier

Description

Sets the name for the Vanilla Minecraft identifier this entity will use to build itself from.

Parameters

Name Type Default Value Description
id String The identifier for the class to construct this entity with
Back to top

minecraft:spawn_egg

Description

Sets whether or not this entity has a spawn egg in the creative ui.

Parameters

Name Type Default Value Description
value Boolean false Set to determine if this entity has a spawn egg.
Back to top



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
Back to top

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
Back to top

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
Back to top



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
Back to top

minecraft:can_climb

Description

Allows this entity to climb up ladders.
Back to top

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.
Back to top

minecraft:can_power_jump

Description

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

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
Back to top

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
Back to top

minecraft:color2

Description

Defines the entity's second texture color. Only works on vanilla entities that have a second predefined color values (tropical fish).

Parameters

Name Type Default Value Description
value Integer 0 The second Palette Color value of the entity
Back to top

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
Back to top

minecraft:equipment

Description

Sets the Equipment table to use for this Entity.

Parameters

Name Type Default Value Description
slot_drop_chance String A list of slots with the chance to drop an equipped item from that slot.
table String The path to the equipment table, relative to the Behavior Pack's root
Back to top

minecraft:fire_immune

Description

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

minecraft:floats_in_liquid

Description

Sets that this entity can float in liquid blocks.
Back to top

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
Back to top

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
Back to top

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
Back to top

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
Back to top

minecraft:input_ground_controlled

Description

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

minecraft:is_baby

Description

Sets that this entity is a baby.
Back to top

minecraft:is_charged

Description

Sets that this entity is charged.
Back to top

minecraft:is_chested

Description

Sets that this entity is currently carrying a chest.
Back to top

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
Back to top

minecraft:is_ignited

Description

Sets that this entity is currently on fire.
Back to top

minecraft:is_saddled

Description

Sets that this entity is currently saddled.
Back to top

minecraft:is_shaking

Description

Sets that this entity is currently shaking.
Back to top

minecraft:is_sheared

Description

Sets that this entity is currently sheared.
Back to top

minecraft:is_stackable

Description

Sets that this entity can be stacked.
Back to top

minecraft:is_tamed

Description

Sets that this entity is currently tamed.
Back to top

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
Back to top

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
Back to top

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
Back to top

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
Back to top

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
Back to top

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
Back to top

minecraft:type_family

Description

Defines the families this entity belongs to.

Parameters

Name Type Default Value Description
family List List of family names
Back to top

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
Back to top

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
Back to top

minecraft:wants_jockey

Description

Sets that this entity wants to become a jockey.
Back to top



Component IDs

JSON Name ID
0
minecraft.behavior.scared 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.circle_around_anchor -698025586
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.drop_item_for 1846615759
minecraft:behavior.eat_block 1972447274
minecraft:behavior.enderman_leave_block -717580550
minecraft:behavior.enderman_take_block -537294220
minecraft:behavior.find_mount 731306871
minecraft:behavior.find_underwater_treasure -1602192311
minecraft:behavior.flee_sun -617664229
minecraft:behavior.float 1758503000
minecraft:behavior.float_wander -1122048364
minecraft:behavior.follow_caravan 9936402
minecraft:behavior.follow_mob -1524701626
minecraft:behavior.follow_owner 1213259599
minecraft:behavior.follow_parent 2127040136
minecraft:behavior.go_home -1579225026
minecraft:behavior.guardian_attack -579215554
minecraft:behavior.harvest_farm_block 10843010
minecraft:behavior.hurt_by_target -1710404297
minecraft:behavior.lay_down -2074934675
minecraft:behavior.lay_egg -1207740530
minecraft:behavior.leap_at_target 256926956
minecraft:behavior.look_at_entity -1735428573
minecraft:behavior.look_at_player -1892159379
minecraft:behavior.look_at_target -885375871
minecraft:behavior.look_at_trading_player -2094605693
minecraft:behavior.make_love -1551283431
minecraft:behavior.melee_attack 1848335663
minecraft:behavior.mount_pathing 1112137677
minecraft:behavior.move_indoors 2107078532
minecraft:behavior.move_through_village 779377630
minecraft:behavior.move_to_land -943551837
minecraft:behavior.move_to_water 1886139445
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.pet_sleep_with_owner 1379392240
minecraft:behavior.pickup_items 644287189
minecraft:behavior.play -505601580
minecraft:behavior.player_ride_tamed 603869698
minecraft:behavior.raid_garden -1145687602
minecraft:behavior.random_breach 928528911
minecraft:behavior.random_fly -446385505
minecraft:behavior.random_look_around 1177762851
minecraft:behavior.random_sitting 1722716662
minecraft:behavior.random_stroll -1643504294
minecraft:behavior.random_swim -1465281278
minecraft:behavior.ranged_attack -2093407250
minecraft:behavior.receive_love 1156694272
minecraft:behavior.restrict_open_door 715583988
minecraft:behavior.restrict_sun -382716017
minecraft:behavior.roll 817471653
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.snacking 875141064
minecraft:behavior.sneeze 1528584076
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.stomp_turtle_egg 851839416
minecraft:behavior.summon_entity -2005850647
minecraft:behavior.swell -1473132493
minecraft:behavior.swim_wander -1576142514
minecraft:behavior.swoop_attack 770804235
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:bribeable 0
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:color2 0
minecraft:damage_over_time 0
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:genetics -82484670
minecraft:ground_offset -1816881803
minecraft:healable -54247424
minecraft:hurt_when_wet 237531867
minecraft:identifier 0
minecraft:input_ground_controlled -646415617
minecraft:insomnia -300455606
minecraft:interact -1996861528
minecraft:inventory 1941951218
minecraft:is_baby 1853172763
minecraft:is_charged 125340337
minecraft:is_chested -817599379
minecraft:is_dyeable 1381448355
minecraft:is_experimental 0
minecraft:is_ignited 905710223
minecraft:is_saddled 1037901616
minecraft:is_shaking 523951884
minecraft:is_sheared 1154836813
minecraft:is_stackable 1184456737
minecraft:is_summonable 0
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.amphibious 0
minecraft:movement.basic 3354475
minecraft:movement.fly -1487316136
minecraft:movement.generic 0
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.generic 0
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:on_wake_with_owner -1543219003
minecraft:peek -863721039
minecraft:projectile 1922456869
minecraft:push_through -138030768
minecraft:rail_movement -78235634
minecraft:rail_sensor 1273161273
minecraft:rideable 1656173828
minecraft:runtime_identifier 0
minecraft:scaffolding_climber 169799877
minecraft:scale 77854436
minecraft:scale_by_age 64881972
minecraft:shareables 1301057082
minecraft:shooter 184150118
minecraft:sittable -1376274106
minecraft:sound_volume 937951776
minecraft:spawn_egg 0
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:trusting 936499892
minecraft:type_family -255011285
minecraft:variant -1789583977
minecraft:walk_animation_speed 972393614
minecraft:wants_jockey 1832515141
Back to top

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
Back to top

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
drop_items List List of items that the entity drops when it grows up.
duration Decimal 1200.0 Amount of time before the entity grows
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
Back to top

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
duration_delta Integer 0 Variance in seconds added to the duration [-delta, delta]
Back to top

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
Back to top

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
inhaleTime Decimal 0.0 Time in seconds to recover breath to maximum
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
Back to top

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
blend_attributes Boolean true If true, the entities will blend their attributes in the offspring after they breed. For example, horses blend their health, movement, and jump_strength in their offspring.
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
causes_pregnancy Boolean false If true, the entity will become pregnant instead of spawning a baby.
environment_requirements List The list of nearby block requirements to get the entity into the 'love' state.

block

Description

The block types required nearby for the entity to breed.
Back to top

count

Description

The number of the required block types nearby for the entity to breed.
Back to top

radius

Description

How many blocks radius from the mob's center to search in for the required blocks. Bounded between 0 and 16.
Back to top

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.
Back to top

minecraft:bribeable

Description

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

Parameters

Name Type Default Value Description
bribe_cooldown Decimal 2.0 Time in seconds before the Entity can be bribed again
bribe_items List The list of items that can be used to bribe the entity
Back to top

minecraft:burns_in_daylight

Description

Specifies if/how a mob burns in daylight.
Back to top

minecraft:damage_over_time

Description

Applies defined amount of damage to the entity at specified intervals

Parameters

Name Type Default Value Description
damagePerHurt Integer 1 Amount of damage caused each hurt
timeBetweenHurt Integer 0 Time in seconds between damage
Back to top

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
Back to top

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.
Back to top

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
Back to top

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
Back to top

minecraft:genetics

Description

Defines the way a mob's genes and alleles are passed on to it's offspring, and how those traits manifest in the child. Compatible parent genes are crossed together, the alleles are handed down from the parents to the child, and any matching genetic variants fire off JSON events to modify the child and express the traits.

Parameters

Name Type Default Value Description
genes List The list of genes that this entity has and will cross with a partner during breeding.
Name Type Default Value Description
allele_range Integer The range of positive integer allele values for this gene. Spawned mobs will have a random number in this range assigned to them.
Name Type Default Value Description
range_max Integer 0 Upper bound of the allele values for this gene.
range_min Integer 0 Lower bound of the allele values for this gene.
genetic_variants List The list of genetic variants for this gene. These check for particular allele combinations and fire events when all of them are satisfied.
Name Type Default Value Description
birth_event String Event to run when this mob is created and matches the above allele conditions.
both_allele Integer -1 If this value is non-negative, compare both the mob's main and hidden alleles with this value for a match with both. Can also be a range of integers.
either_allele Integer -1 If this value is non-negative, compare both the mob's main and hidden alleles with this value for a match with either. Can also be a range of integers.
hidden_allele Integer -1 If this value is non-negative, compare the mob's hidden allele with this value for a match. Can also be a range of integers.
main_allele Integer -1 If this value is non-negative, compare the mob's main allele with this value for a match. Can also be a range of integers.
name String The name of the gene.
mutation_rate Decimal 0.03125 Chance that an allele will be replaced with a random one instead of the parent's allele during birth.
Back to top

minecraft:healable

Description

Defines the interactions with this entity for healing it.

Parameters

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
items List The list of items that can be used to heal this entity
Name Type Default Value Description
filters Minecraft Filter The filters to test before applying any healing for the item
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
Back to top

minecraft:hurt_when_wet

Description

Specifies if an actor is hurt when wet.
Back to top

minecraft:insomnia

Description

Adds a timer since last rested to see if phantoms should spawn.

Parameters

Name Type Default Value Description
days_until_insomnia Decimal 3.0 Number of days the mob has to stay up until the insomnia effect begins.
Back to top

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
Back to top

particle_type

Description

The type of particle that will be spawned
Back to top

particle_y_offset

Description

Will offset the particle this amount in the y direction
Back to top

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
Back to top

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
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
Back to top

minecraft:item_hopper

Description

Determines that this entity is an item hopper
Back to top

minecraft:jump.dynamic

Description

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

minecraft:jump.static

Description

Gives the entity the ability to jump.

Parameters

Name Type Default Value Description
jump_power Decimal 0.42 The initial vertical velocity for the jump
Back to top

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
Back to top

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
Back to top

minecraft:movement.amphibious

Description

This move control allows the mob to swim in water and walk on land.

Parameters

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

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.
Back to top

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.
Back to top

minecraft:movement.generic

Description

This move control allows a mob to fly, swim, climb, etc.

Parameters

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

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.
Back to top

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.
Back to top

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.
Back to top

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'
Back to top

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_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
can_path_over_water Boolean false Tells the pathfinder whether or not it can travel on the surface of the water
can_sink Boolean true Tells the pathfinder whether or not it will be pulled down by gravity while in water
Back to top

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_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
can_path_over_water Boolean false Tells the pathfinder whether or not it can travel on the surface of the water
can_sink Boolean true Tells the pathfinder whether or not it will be pulled down by gravity while in water
Back to top

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_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
can_path_over_water Boolean false Tells the pathfinder whether or not it can travel on the surface of the water
can_sink Boolean true Tells the pathfinder whether or not it will be pulled down by gravity while in water
Back to top

minecraft:navigation.generic

Description

Allows this entity to generate paths by walking, swimming, flying and/or climbing around and jumping up and down a block.

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_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
can_path_over_water Boolean false Tells the pathfinder whether or not it can travel on the surface of the water
can_sink Boolean true Tells the pathfinder whether or not it will be pulled down by gravity while in water
Back to top

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_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
can_path_over_water Boolean false Tells the pathfinder whether or not it can travel on the surface of the water
can_sink Boolean true Tells the pathfinder whether or not it will be pulled down by gravity while in water
Back to top

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_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
can_path_over_water Boolean false Tells the pathfinder whether or not it can travel on the surface of the water
can_sink Boolean true Tells the pathfinder whether or not it will be pulled down by gravity while in water
Back to top

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
Back to top

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
lightning Boolean false If true, the entity hit will be struck by lightning
liquid_inertia Decimal 0.6 The fraction of the projectile's speed maintained every frame while traveling in water
multipletargets Boolean true If true, the projectile can hit multiple entities per flight
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
Back to top

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
Back to top

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
Back to top

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
rider_can_interact Boolean false If true, this entity will be picked when looked at by the rider
seat_count Integer 1 The number of entities that can ride this entity at the same time
seats List The list of positions and number of riders for each position for entities riding this entity
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
Back to top

minecraft:scaffolding_climber

Description

Allows the player to detect and manuever on the scaffolding block.
Back to top

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
Back to top

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
items List List of items that the entity wants to share

craft_into

Description

Defines the item this entity wants to craft with the item defined above. Should be an item name
Back to top

item

Description

The name of the item
Back to top

surplus_amount

Description

Number of this item considered extra that the entity wants to share
Back to top

want_amount

Description

Number of this item this entity wants to share
Back to top

Back to top

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
Back to top

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
Back to top

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
Back to top

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
Back to top

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
Back to top

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
Back to top

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%
Back to top

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.
Back to top

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
Back to top

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
Back to top

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
drop_equipment Boolean Cause the entity to drop all equipment upon transformation
into String Entity Definition that this entity will transform into
transformation_sound String Sound to play when the entity is done transforming
Back to top

minecraft:trusting

Description

Defines the rules for a mob to trust players.

Parameters

Name Type Default Value Description
probability Decimal 1.0 The chance of the entity trusting with each item use between 0.0 and 1.0, where 1.0 is 100%
trust_event String Event to run when this entity becomes trusting
trust_items List The list of items that can be used to get the entity to trust players
Back to top



AI Goals

minecraft.behavior.scared

Description

Allows the a mob to become scared when the weather outside is thundering

Parameters

Name Type Default Value Description
sound_interval Integer 0 The interval in which a sound will play when active in a 1/delay chance to kick off
Back to top

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
ignore_visibility Boolean false If true, visbility between this entity and the mob type will not be checked.
max_dist Decimal 0.0 Maximum distance to look for an entity
max_flee Decimal 0.5 Distance in blocks within the mob considers it should stop fleeing.
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
Back to top

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
Back to top

minecraft:behavior.break_door

Description

Allows this mob to break doors.
Back to top

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
Back to top

minecraft:behavior.charge_attack

Description

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

minecraft:behavior.circle_around_anchor

Description

Allows the mob to move in a circle around a point or a target.

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
height_above_target_range Range [a, b] [0.0, 0.0] When the mob finds a target, the range of height in blocks above the target to start the anchor point.
height_change_chance Integer 350 A random value to determine when to change the height of the mob from the anchor point. This has a 1/value chance every tick to do so.
height_offset_range Range [a, b] [0.0, 0.0] The range of height in blocks offset the mob can have from it's anchor point.
radius_change_chance Integer 250 A random value to determine when to increase the size of the radius up to the maximum. This has a 1/value chance every tick to do so.
radius_range Range [a, b] [5.0, 15.0] Range of radius in blocks of the circle to move around.
speed_multiplier Decimal 1.0 Movement speed multiplier of the mob when using this AI Goal
Back to top

minecraft:behavior.controlled_by_player

Description

Allows the mob to be controlled by the player.
Back to top

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
Back to top

minecraft:behavior.door_interact

Description

Allows the mob to open and close doors.
Back to top

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.
Back to top

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.
Back to top

minecraft:behavior.dragonflaming

Description

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

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.
Back to top

minecraft:behavior.dragonlanding

Description

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

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.
Back to top

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.
Back to top

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.
Back to top

minecraft:behavior.drop_item_for

Description

Allows the mob to move near a target and drop an item.

Parameters

Name Type Default Value Description
drop_item_chance Decimal [1.0] The probability that the mob will drop an item.
entity_types JSON Object List of entity types this mob will drop items for.
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
loot_table String Loot table to select items from.
max_dist Decimal 0.0 Maximum distance in blocks this mob will look for entities to drop an item for.
offering_distance Decimal [1.0] The distance in blocks the mob will try to be away from the entity when it drops the item.
on_drop_attempt String Event to run when this mob attempts to drop an item.
search_height Integer 1 Height in blocks from the target the mob can be.
search_range Integer 0 The distance in blocks from the target the mob can be.
speed_multiplier Decimal 1.0 Movement speed multiplier of the mob when using this AI Goal
time_of_day_range Range [a, b] [0.0, 1.0] The valid times of day that this goal can be used. For reference: noon is 0.0, sunset is 0.25, midnight is 0.5, and sunrise is 0.75, and back to noon for 1.0.
Back to top

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
Back to top

minecraft:behavior.enderman_leave_block

Description

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

minecraft:behavior.enderman_take_block

Description

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

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
Back to top

minecraft:behavior.find_underwater_treasure

Description

Allows the mob to move towards the nearest underwater ruin or shipwreck.

Parameters

Name Type Default Value Description
search_range Integer 0 The range that the mob will search for a treasure chest within a ruin or shipwreck to move towards.
speed_multiplier Decimal 1.0 Movement speed multiplier of the mob when using this AI Goal
stop_distance Decimal 2.0 The distance the mob will move before stopping.
Back to top

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
Back to top

minecraft:behavior.float

Description

Allows the mob to stay afloat while swimming.
Back to top

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
Back to top

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
Back to top

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
Back to top

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
Back to top

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
Back to top

minecraft:behavior.go_home

Description

Allows the mob to move back to the position they were spawned.

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
interval Integer 120 A random value to determine when to randomly move somewhere. This has a 1/interval chance to choose this goal
on_home String Event to run when this mob gets home.
speed_multiplier Decimal 1.0 Movement speed multiplier of the mob when using this AI Goal
Back to top

minecraft:behavior.guardian_attack

Description

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

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
Back to top

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
Back to top

minecraft:behavior.lay_down

Description

Allows mobs to lay down at times

Parameters

Name Type Default Value Description
interval Integer 120 A random value to determine at what intervals something can occur. This has a 1/interval chance to choose this goal
random_stop_interval Integer 120 a random value in which the goal can use to pull out of the behavior. This is a 1/interval chance to play the sound
Back to top

minecraft:behavior.lay_egg

Description

Allows the mob to lay an egg block on a sand block if the mob is pregnant.

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
on_lay String Event to run when this mob lays the egg.
search_count Integer 10 The number of blocks each tick that the mob will check within it's search range and height for a valid block to move to. A value of 0 will have the mob check every block within range in one tick
search_height Integer 1 Height in blocks the mob will look for sand block to move towards
search_range Integer 0 The distance in blocks it will look for a sand block to move towards
speed_multiplier Decimal 1.0 Movement speed multiplier of the mob when using this AI Goal
Back to top

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
Back to top

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%
Back to top

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%
Back to top

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%
Back to top

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%
Back to top

minecraft:behavior.make_love

Description

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

minecraft:behavior.melee_attack

Description

Allows the mob to use close combat melee attacks.

Parameters

Name Type Default Value Description
attack_once Boolean false If true, this mob will attack only one time.
attack_types String Defines the entity types this mob will attack
melee_fov Decimal 90.0 The allowable FOV the actor will use to determine if it can make a valid melee 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
Back to top

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
Back to top

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
Back to top

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
Back to top

minecraft:behavior.move_to_land

Description

Allows the mob to move back onto land when in water.

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
search_count Integer 10 The number of blocks each tick that the mob will check within it's search range and height for a valid block to move to. A value of 0 will have the mob check every block within range in one tick
search_height Integer 1 Height in blocks the mob will look for land to move towards
search_range Integer 0 The distance in blocks it will look for land to move towards
speed_multiplier Decimal 1.0 Movement speed multiplier of the mob when using this AI Goal
Back to top

minecraft:behavior.move_to_water

Description

Allows the mob to move back into water when on land.

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
search_count Integer 10 The number of blocks each tick that the mob will check within it's search range and height for a valid block to move to. A value of 0 will have the mob check every block within range in one tick
search_height Integer 1 Height in blocks the mob will look for water to move towards
search_range Integer 0 The distance in blocks it will look for water to move towards
speed_multiplier Decimal 1.0 Movement speed multiplier of the mob when using this AI Goal
Back to top

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
Back to top

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
Back to top

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
persist_time Decimal 0.0f Time in seconds for a valid target to stay targeted when it becomes and invalid target.
reselect_targets Boolean false If true, the target will change to the current closest entity whenever a different entity is closer
scan_interval Integer 10 How many ticks to wait between scanning for a target.
target_search_height Decimal -1.0f Height in blocks to search for a target mob. -1.0f means the height does not matter.
within_radius Decimal 0.0 Distance in blocks that the target can be within to launch an attack
Back to top

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
Back to top

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
Back to top

minecraft:behavior.offer_flower

Description

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

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
Back to top

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
Back to top

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
Back to top

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
prefer_water Boolean false If true, the mob will prefer water over land
speed_multiplier Decimal 1.0 Movement speed multiplier of the mob when using this AI Goal
Back to top

minecraft:behavior.peek

Description

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

minecraft:behavior.pet_sleep_with_owner

Description

Allows the pet mob to move onto a bed with it's owner while sleeping.

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
search_height Integer 1 Height in blocks from the owner the pet can be to sleep with owner.
search_range Integer 0 The distance in blocks from the owner the pet can be to sleep with owner.
speed_multiplier Decimal 1.0 Movement speed multiplier of the mob when using this AI Goal
Back to top

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
Back to top

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
Back to top

minecraft:behavior.player_ride_tamed

Description

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

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
Back to top

minecraft:behavior.random_breach

Description

Allows the mob to randomly break surface of the water.

Parameters

Name Type Default Value Description
cooldown_time Decimal 0.0 Time in seconds the mob has to wait before using the goal again
interval Integer 120 A random value to determine when to randomly move somewhere. This has a 1/interval chance to choose this goal
speed_multiplier Decimal 1.0 Movement speed multiplier of the mob when using this AI Goal
xz_dist Integer 10 Distance in blocks on ground that the mob will look for a new spot to move to. Must be at least 1
y_dist Integer 7 Distance in blocks that the mob will look up or down for a new spot to move to. Must be at least 1
Back to top

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
Back to top

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
Back to top

minecraft:behavior.random_sitting

Description

Allows the mob to randomly sit for a duration.

Parameters

Name Type Default Value Description
cooldown Decimal 100 The cooldown time in seconds before the mob may sit again
min_sit_time Decimal 10 The minimum amount of time in seconds before the mob can stand back up
start_chance Decimal 0.1 This is the chance that the mob will start sitting, from 0 to 1
stop_chance Decimal 0.3 This is the chance that the mob will stop sitting, from 0 to 1
Back to top

minecraft:behavior.random_stroll

Description

Allows a mob to randomly stroll around.

Parameters

Name Type Default Value Description
interval Integer 120 A random value to determine when to randomly move somewhere. This has a 1/interval chance to choose this goal
speed_multiplier Decimal 1.0 Movement speed multiplier of the mob when using this AI Goal
xz_dist Integer 10 Distance in blocks on ground that the mob will look for a new spot to move to. Must be at least 1
y_dist Integer 7 Distance in blocks that the mob will look up or down for a new spot to move to. Must be at least 1
Back to top

minecraft:behavior.random_swim

Description

Allows an entity to randomly move through water

Parameters

Name Type Default Value Description
interval Integer 120 A random value to determine when to randomly move somewhere. This has a 1/interval chance to choose this goal
speed_multiplier Decimal 1.0 Movement speed multiplier of the mob when using this AI Goal
xz_dist Integer 10 Distance in blocks on ground that the mob will look for a new spot to move to. Must be at least 1
y_dist Integer 7 Distance in blocks that the mob will look up or down for a new spot to move to. Must be at least 1
Back to top

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
ranged_fov Decimal 90.0 The allowable FOV the actor will use to determine if it can make a valid ranged attack
speed_multiplier Decimal 1.0 Movement speed multiplier of the mob when using this AI Goal
Back to top

minecraft:behavior.receive_love

Description

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

minecraft:behavior.restrict_open_door

Description

Allows the mob to stay indoors during night time.
Back to top

minecraft:behavior.restrict_sun

Description

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

minecraft:behavior.roll

Description

This allows the mob to roll forward.

Parameters

Name Type Default Value Description
probability Decimal [1.0] The probability that the mob will use the goal.
Back to top

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
Back to top

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
Back to top

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
Back to top

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.
Back to top

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.
Back to top

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
Back to top

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.
Back to top

minecraft:behavior.slime_float

Description

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

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.
Back to top

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.
Back to top

minecraft:behavior.snacking

Description

Allows the mob to take a load off and snack on food that it found nearby.

Parameters

Name Type Default Value Description
items List Items that we are interested in snacking on
snacking_cooldown Decimal 7.5 The cooldown time in seconds before the mob is able to snack again
snacking_cooldown_min Decimal 0.5f The minimum time in seconds before the mob is able to snack again
snacking_stop_chance Decimal 0.0017 This is the chance that the mob will stop snacking, from 0 to 1
Back to top

minecraft:behavior.sneeze

Description

Allows the mob to stop and sneeze possibly startling nearby mobs and dropping an item.

Parameters

Name Type Default Value Description
cooldown_time Decimal 0.0 Time in seconds the mob has to wait before using the goal again
drop_item_chance Decimal 1.0 The probability that the mob will drop an item when it sneezes.
entity_types JSON Object List of entity types this mob will startle (cause to jump) when it sneezes.
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
loot_table String Loot table to select dropped items from.
prepare_sound String Sound to play when the sneeze is about to happen.
prepare_time Decimal 1.0 The time in seconds that the mob takes to prepare to sneeze (while the prepare_sound is playing).
probability Decimal 0.02 The probability of sneezing. A value of 1.00 is 100%
sound String Sound to play when the sneeze occurs.
within_radius Decimal 0.0 Distance in blocks that mobs will be startled.
Back to top

minecraft:behavior.squid_dive

Description

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

minecraft:behavior.squid_flee

Description

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

minecraft:behavior.squid_idle

Description

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

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.
Back to top

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.
Back to top

minecraft:behavior.stay_while_sitting

Description

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

minecraft:behavior.stomp_attack

Description

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

Parameters

Name Type Default Value Description
attack_once Boolean false If true, this mob will attack only one time.
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
Back to top

minecraft:behavior.stomp_turtle_egg

Description

Allows this mob to stomp turtle eggs

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
interval Integer 120 A random value to determine when to randomly move somewhere. This has a 1/interval chance to choose this goal
search_count Integer 10 The number of blocks each tick that the mob will check within it's search range and height for a valid block to move to. A value of 0 will have the mob check every block within range in one tick
search_height Integer 1 Height in blocks the mob will look for turtle eggs to move towards
search_range Integer 0 The distance in blocks it will look for turtle eggs to move towards
speed_multiplier Decimal 1.0 Movement speed multiplier of the mob when using this AI Goal
Back to top

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
Back to top

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
Back to top

minecraft:behavior.swim_wander

Description

Has the fish swim around when they can't pathfind

Parameters

Name Type Default Value Description
speed_multiplier Decimal 10 speed of the entity
Back to top

minecraft:behavior.swoop_attack

Description

Allows the mob to move to attack a target. The goal ends if it has a horizontal collision or gets hit. Built to be used with flying mobs.

Parameters

Name Type Default Value Description
delay_range Range [a, b] [10.0, 20.0] Range of time in seconds between uses of this goal.
speed_multiplier Decimal 1.0 Movement speed multiplier of the mob when using this AI Goal
Back to top

minecraft:behavior.take_flower

Description

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

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
Back to top

minecraft:behavior.trade_with_player

Description

Allows the player to trade with this mob.
Back to top

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
Back to top

minecraft:behavior.vex_random_move

Description

Allows the mob to move around randomly like the Vex.
Back to top

minecraft:behavior.wither_random_attack_pos_goal

Description

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

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
Back to top



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.00" }
{ "test": "clock_time", "value": "0.00" }
Back to top

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" }
Back to top

has_biome_tag

Description

Tests whether the biome the subject is in has the specified tag.

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 tag to look for

Examples

{ "test": "has_biome_tag", "subject": "self", "operator": "equals", "value": " " }
{ "test": "has_biome_tag", "value": " " }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

in_water_or_rain

Description

Returns true when the subject entity is in water or rain.

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_or_rain", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "in_water_or_rain" }
Back to top

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" }
Back to top

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" }
Back to top

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.50" }
{ "test": "is_brightness", "value": "0.50" }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

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.50" }
{ "test": "is_temperature_value", "value": "0.50" }
Back to top

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" }
Back to top

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" }
Back to top

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" }
Back to top

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.00" }
{ "test": "moon_intensity", "value": "0.00" }
Back to top

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" }
Back to top

on_ground

Description

Returns true when the subject entity is on ground.

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_ground", "subject": "self", "operator": "equals", "value": "true" }
{ "test": "on_ground" }
Back to top

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" }
Back to top



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
Back to top

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
Back to top

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
Back to top

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
Back to top

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
Back to top

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
Back to top

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
Back to top

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
Back to top

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
Back to top

minecraft:on_wake_with_owner

Description

Adds a trigger to call when this pet's owner awakes after sleeping with the pet.

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
Back to top



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.
Back to top

Entities

Identifier Full ID Short ID
agent 312 56
area_effect_cloud 95 95
armor_stand 317 61
arrow 12582992 80
balloon 107 107
bat 33043 19
blaze 2859 43
boat 90 90
cat 21323 75
cave_spider 265000 40
chalkboard 78 78
chest_minecart 524386 98
chicken 4874 10
cod 9072 112
command_block_minecart 524388 100
cow 4875 11
creeper 2849 33
dolphin 8991 31
donkey 2118424 24
dragon_fireball 4194383 79
drowned 199534 110
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
ice_bomb 4194410 106
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
npc 307 51
ocelot 21270 22
painting 83 83
panda 4977 113
parrot 21278 30
phantom 68410 58
pig 4876 12
player 319 63
polar_bear 4892 28
pufferfish 9068 108
rabbit 4882 18
salmon 9069 109
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
thrown_trident 12582985 73
tnt 65 65
tnt_minecart 524385 97
tripod_camera 318 62
tropicalfish 9071 111
turtle 4938 74
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
Back to top

Blocks

Name
minecraft:acacia_button
minecraft:acacia_door
minecraft:acacia_fence_gate
minecraft:acacia_pressure_plate
minecraft:acacia_stairs
minecraft:acacia_trapdoor
minecraft:activator_rail
minecraft:air
minecraft:anvil
minecraft:bamboo
minecraft:bamboo_sapling
minecraft:barrier
minecraft:beacon
minecraft:bed
minecraft:bedrock
minecraft:beetroot
minecraft:birch_button
minecraft:birch_door
minecraft:birch_fence_gate
minecraft:birch_pressure_plate
minecraft:birch_stairs
minecraft:birch_trapdoor
minecraft:black_glazed_terracotta
minecraft:blue_glazed_terracotta
minecraft:blue_ice
minecraft:bone_block
minecraft:bookshelf
minecraft:brewing_stand
minecraft:brick_block
minecraft:brick_stairs
minecraft:brown_glazed_terracotta
minecraft:brown_mushroom
minecraft:brown_mushroom_block
minecraft:bubble_column
minecraft:cactus
minecraft:cake
minecraft:carpet
minecraft:carrots
minecraft:carved_pumpkin
minecraft:cauldron
minecraft:chain_command_block
minecraft:chemical_heat
minecraft:chemistry_table
minecraft:chest
minecraft:chorus_flower
minecraft:chorus_plant
minecraft:clay
minecraft:coal_block
minecraft:coal_ore
minecraft:cobblestone
minecraft:cobblestone_wall
minecraft:cocoa
minecraft:colored_torch_bp
minecraft:colored_torch_rg
minecraft:command_block
minecraft:concrete
minecraft:concretePowder
minecraft:conduit
minecraft:coral
minecraft:coral_block
minecraft:coral_fan
minecraft:coral_fan_dead
minecraft:coral_fan_hang
minecraft:coral_fan_hang2
minecraft:coral_fan_hang3
minecraft:crafting_table
minecraft:cyan_glazed_terracotta
minecraft:dark_oak_button
minecraft:dark_oak_door
minecraft:dark_oak_fence_gate
minecraft:dark_oak_pressure_plate
minecraft:dark_oak_stairs
minecraft:dark_oak_trapdoor
minecraft:dark_prismarine_stairs
minecraft:daylight_detector
minecraft:daylight_detector_inverted
minecraft:deadbush
minecraft:detector_rail
minecraft:diamond_block
minecraft:diamond_ore
minecraft:dirt
minecraft:dispenser
minecraft:double_plant
minecraft:double_stone_slab
minecraft:double_stone_slab2
minecraft:double_wooden_slab
minecraft:dragon_egg
minecraft:dried_kelp_block
minecraft:dropper
minecraft:element_0
minecraft:element_1
minecraft:element_10
minecraft:element_100
minecraft:element_101
minecraft:element_102
minecraft:element_103
minecraft:element_104
minecraft:element_105
minecraft:element_106
minecraft:element_107
minecraft:element_108
minecraft:element_109
minecraft:element_11
minecraft:element_110
minecraft:element_111
minecraft:element_112
minecraft:element_113
minecraft:element_114
minecraft:element_115
minecraft:element_116
minecraft:element_117
minecraft:element_118
minecraft:element_12
minecraft:element_13
minecraft:element_14
minecraft:element_15
minecraft:element_16
minecraft:element_17
minecraft:element_18
minecraft:element_19
minecraft:element_2
minecraft:element_20
minecraft:element_21
minecraft:element_22
minecraft:element_23
minecraft:element_24
minecraft:element_25
minecraft:element_26
minecraft:element_27
minecraft:element_28
minecraft:element_29
minecraft:element_3
minecraft:element_30
minecraft:element_31
minecraft:element_32
minecraft:element_33
minecraft:element_34
minecraft:element_35
minecraft:element_36
minecraft:element_37
minecraft:element_38
minecraft:element_39
minecraft:element_4
minecraft:element_40
minecraft:element_41
minecraft:element_42
minecraft:element_43
minecraft:element_44
minecraft:element_45
minecraft:element_46
minecraft:element_47
minecraft:element_48
minecraft:element_49
minecraft:element_5
minecraft:element_50
minecraft:element_51
minecraft:element_52
minecraft:element_53
minecraft:element_54
minecraft:element_55
minecraft:element_56
minecraft:element_57
minecraft:element_58
minecraft:element_59
minecraft:element_6
minecraft:element_60
minecraft:element_61
minecraft:element_62
minecraft:element_63
minecraft:element_64
minecraft:element_65
minecraft:element_66
minecraft:element_67
minecraft:element_68
minecraft:element_69
minecraft:element_7
minecraft:element_70
minecraft:element_71
minecraft:element_72
minecraft:element_73
minecraft:element_74
minecraft:element_75
minecraft:element_76
minecraft:element_77
minecraft:element_78
minecraft:element_79
minecraft:element_8
minecraft:element_80
minecraft:element_81
minecraft:element_82
minecraft:element_83
minecraft:element_84
minecraft:element_85
minecraft:element_86
minecraft:element_87
minecraft:element_88
minecraft:element_89
minecraft:element_9
minecraft:element_90
minecraft:element_91
minecraft:element_92
minecraft:element_93
minecraft:element_94
minecraft:element_95
minecraft:element_96
minecraft:element_97
minecraft:element_98
minecraft:element_99
minecraft:emerald_block
minecraft:emerald_ore
minecraft:enchanting_table
minecraft:end_bricks
minecraft:end_gateway
minecraft:end_portal
minecraft:end_portal_frame
minecraft:end_rod
minecraft:end_stone
minecraft:ender_chest
minecraft:farmland
minecraft:fence
minecraft:fence_gate
minecraft:fire
minecraft:flower_pot
minecraft:flowing_lava
minecraft:flowing_water
minecraft:frame
minecraft:frosted_ice
minecraft:furnace
minecraft:glass
minecraft:glass_pane
minecraft:glowingobsidian
minecraft:glowstone
minecraft:gold_block
minecraft:gold_ore
minecraft:golden_rail
minecraft:grass
minecraft:grass_path
minecraft:gravel
minecraft:gray_glazed_terracotta
minecraft:green_glazed_terracotta
minecraft:hard_glass
minecraft:hard_glass_pane
minecraft:hard_stained_glass
minecraft:hard_stained_glass_pane
minecraft:hardened_clay
minecraft:hay_block
minecraft:heavy_weighted_pressure_plate
minecraft:hopper
minecraft:ice
minecraft:info_update
minecraft:info_update2
minecraft:invisibleBedrock
minecraft:iron_bars
minecraft:iron_block
minecraft:iron_door
minecraft:iron_ore
minecraft:iron_trapdoor
minecraft:jukebox
minecraft:jungle_button
minecraft:jungle_door
minecraft:jungle_fence_gate
minecraft:jungle_pressure_plate
minecraft:jungle_stairs
minecraft:jungle_trapdoor
minecraft:kelp
minecraft:ladder
minecraft:lapis_block
minecraft:lapis_ore
minecraft:lava
minecraft:leaves
minecraft:leaves2
minecraft:lever
minecraft:light_blue_glazed_terracotta
minecraft:light_weighted_pressure_plate
minecraft:lime_glazed_terracotta
minecraft:lit_furnace
minecraft:lit_pumpkin
minecraft:lit_redstone_lamp
minecraft:lit_redstone_ore
minecraft:log
minecraft:log2
minecraft:magenta_glazed_terracotta
minecraft:magma
minecraft:melon_block
minecraft:melon_stem
minecraft:mob_spawner
minecraft:monster_egg
minecraft:mossy_cobblestone
minecraft:movingBlock
minecraft:mycelium
minecraft:nether_brick
minecraft:nether_brick_fence
minecraft:nether_brick_stairs
minecraft:nether_wart
minecraft:nether_wart_block
minecraft:netherrack
minecraft:netherreactor
minecraft:noteblock
minecraft:oak_stairs
minecraft:observer
minecraft:obsidian
minecraft:orange_glazed_terracotta
minecraft:packed_ice
minecraft:pink_glazed_terracotta
minecraft:piston
minecraft:pistonArmCollision
minecraft:planks
minecraft:podzol
minecraft:portal
minecraft:potatoes
minecraft:powered_comparator
minecraft:powered_repeater
minecraft:prismarine
minecraft:prismarine_bricks_stairs
minecraft:prismarine_stairs
minecraft:pumpkin
minecraft:pumpkin_stem
minecraft:purple_glazed_terracotta
minecraft:purpur_block
minecraft:purpur_stairs
minecraft:quartz_block
minecraft:quartz_ore
minecraft:quartz_stairs
minecraft:rail
minecraft:red_flower
minecraft:red_glazed_terracotta
minecraft:red_mushroom
minecraft:red_mushroom_block
minecraft:red_nether_brick
minecraft:red_sandstone
minecraft:red_sandstone_stairs
minecraft:redstone_block
minecraft:redstone_lamp
minecraft:redstone_ore
minecraft:redstone_torch
minecraft:redstone_wire
minecraft:reeds
minecraft:repeating_command_block
minecraft:reserved6
minecraft:sand
minecraft:sandstone
minecraft:sandstone_stairs
minecraft:sapling
minecraft:scaffolding
minecraft:seaLantern
minecraft:sea_pickle
minecraft:seagrass
minecraft:shulker_box
minecraft:silver_glazed_terracotta
minecraft:skull
minecraft:slime
minecraft:snow
minecraft:snow_layer
minecraft:soul_sand
minecraft:sponge
minecraft:spruce_button
minecraft:spruce_door
minecraft:spruce_fence_gate
minecraft:spruce_pressure_plate
minecraft:spruce_stairs
minecraft:spruce_trapdoor
minecraft:stained_glass
minecraft:stained_glass_pane
minecraft:stained_hardened_clay
minecraft:standing_banner
minecraft:standing_sign
minecraft:sticky_piston
minecraft:stone
minecraft:stone_brick_stairs
minecraft:stone_button
minecraft:stone_pressure_plate
minecraft:stone_slab
minecraft:stone_slab2
minecraft:stone_stairs
minecraft:stonebrick
minecraft:stonecutter
minecraft:stripped_acacia_log
minecraft:stripped_birch_log
minecraft:stripped_dark_oak_log
minecraft:stripped_jungle_log
minecraft:stripped_oak_log
minecraft:stripped_spruce_log
minecraft:structure_block
minecraft:tallgrass
minecraft:tnt
minecraft:torch
minecraft:trapdoor
minecraft:trapped_chest
minecraft:tripWire
minecraft:tripwire_hook
minecraft:turtle_egg
minecraft:underwater_torch
minecraft:undyed_shulker_box
minecraft:unlit_redstone_torch
minecraft:unpowered_comparator
minecraft:unpowered_repeater
minecraft:vine
minecraft:wall_banner
minecraft:wall_sign
minecraft:water
minecraft:waterlily
minecraft:web
minecraft:wheat
minecraft:white_glazed_terracotta
minecraft:wooden_button
minecraft:wooden_door
minecraft:wooden_pressure_plate
minecraft:wooden_slab
minecraft:wool
minecraft:yellow_flower
minecraft:yellow_glazed_terracotta
Back to top

Geometry

Blocks

Parameters

Name Type Default Value Description
elements List List of elements that make up the geometry of this block

boxes

Description

List of cubes that make up the geometry of this element

Parameters

faces

Description

List of the 6 faces of the box. If specified, there MUST be 6 faces (front, back, left side, right side, top, bottom)

Parameters

material

Description

The material of this face if different from the box's
Back to top

rotation

Description

UV Rotation of this face. Only acceptable values are 0, 90 and 270 degrees. This allows reusing a texture and just rotating it for different faces
Back to top

uv

Description

Texture coordinates of this face, given as min x, min y, max x, max y withg values between 0.0 and 1.0
Back to top

Back to top

material

Description

The material of this box if different from the element's
Back to top

origin

Description

The position of the center of the box relative to the geometry
Back to top

size

Description

Scale of the box in the x, y and z coordinates. A typical block is of scale 1, 1, 1
Back to top

Back to top

material

Description

The material of this element if different from the block's
Back to top

name

Description

Name of the element
Back to top

parent

Description

Name of the parent element of this element. Pivot and box positions are made relative to the parent element's pivot
Back to top

pivot

Description

Position in model space of the pivot point of the element. This is used as the "center" position of the element, as well as the point around which to rotate
Back to top

rotation

Description

The rotation of this element about its pivot
Back to top

format_version String 0.0.0.0 Version of the block geometry being used. This is used to determine if backwards compatibility is needed
materials List #0 List of materials used by this model
parent String Parent model of this model
Back to top