Entity Documentation - AI Goal Component list
Below is a list of all the available AI Goal Components within Minecraft: Bedrock Edition for use with Entity JSON files.
AI Goal Component | Description |
---|---|
minecraft:behavior.admire_item | minecraft:behavior.admire_item compels an entity to admire an object they are holding. |
minecraft:behavior.avoid_block | minecraft:behavior.avoid_block compels an entity to avoid certain blocks. |
minecraft:behavior.avoid_mob_type | minecraft:behavior.avoid_mob_type compels the entity to run away from other entities that meet the criteria specified. |
minecraft:behavior.barter | minecraft:behavior.barter compels an entity to drop an item in return after a player offers a trade by dropping a specific item near the entity. |
minecraft:behavior.beg | minecraft:behavior.beg compels an entity to react by tilting its head when a player is holding select items nearby. |
minecraft:behavior.break_door | minecraft:behavior.break_door compels an entity to break down doors. |
minecraft:behavior.breed | minecraft:behavior.breed inspires an entity to breed with other entities that have been assigned. |
minecraft:behavior.celebrate | minecraft:behavior.celebrate compels this entity to celebrate by making celebration sounds and jumping. |
minecraft:behavior.celebrate_survive | minecraft:behavior.celebrate_survive compels this entity to celebrate surviving a raid by shooting fireworks. |
minecraft:behavior.charge_attack | minecraft:behavior.charge_attack compels this entity to damage a target by using a running attack. |
minecraft:behavior.charge_held_item | minecraft:behavior.charge_held_item compels an entity to charge and use their held item. |
minecraft:behavior.circle_around_anchor | minecraft:behavior.circle_around_anchor causes an entity to circle around an anchor point placed near a point or target. |
minecraft:behavior.controlled_by_player | minecraft:behavior.controlled_by_player compels the entity to be controlled by the player using an item in the item_controllable property. On every tick, the entity will attempt to rotate towards where the player is facing with the control item whilst simultaneously moving forward. |
minecraft:behavior.croak | minecraft:behavior.croak compels the entity to croak at a random time interval with configurable conditions. |
minecraft:behavior.defend_trusted_target | minecraft:behavior.defend_trusted_target compels an entity to react with an event when a trusted target is attacked. |
minecraft:behavior.defend_village_target | minecraft:behavior.defend_village_target compels the entity to stay in a village and defend the village from aggressors. If a player is in bad standing with the village, this goal will cause the entity to attack the player regardless of filter conditions. |
minecraft:behavior.delayed_attack | minecraft:behavior.delayed_attack compels the entity to stay in a village and defend the village from aggressors. If a player is in bad standing with the village, this goal will cause the entity to attack the player regardless of filter conditions. |
minecraft:behavior.dig | minecraft:behavior.dig activates the "DIGGING" entity flag during the specified duration. Currently only Warden can use the dig goal. |
minecraft:behavior.door_interact | minecraft:behavior.door_interact allows an entity to interact with doors. |
minecraft:behavior.dragonchargeplayer | minecraft:behavior.dragonchargeplayer compels this entity to attack a player by charging at them. The player is chosen by the minecraft:behavior.dragonscanning . Can only be used by the Ender Dragon. |
minecraft:behavior.dragondeath | minecraft:behavior.dragondeath controls the entity's death state and animation. |
minecraft:behavior.dragonflaming | minecraft:behavior.dragonflaming compels this entity to use a flame-breath attack. Can only be used by the Ender Dragon. |
minecraft:behavior.dragonholdingpattern | minecraft:behavior.dragonholdingpattern compels an entity to fly around in a circle around the center podium located in The End . |
minecraft:behavior.dragonlanding | minecraft:behavior.dragonlanding compels an entity to stop flying and transition into perch mode. |
minecraft:behavior.dragonscanning | minecraft:behavior.dragonscanning compels an entity to look around for a player to attack while in perch mode. |
minecraft:behavior.dragonstrafeplayer | minecraft:behavior.dragonstrafeplayer compels this entity to fly around looking for a player to shoot fireballs at. Can only be used by the Ender Dragon. |
minecraft:behavior.dragontakeoff | minecraft:behavior.dragontakeoff compels an entity to leave perch mode and go back to flying around. |
minecraft:behavior.drink_milk | minecraft:behavior.drink_milk compels the mob to drink milk based on specified environment conditions. |
minecraft:behavior.drink_potion | minecraft:behavior.drink_potion compels an entity to drink a potion as a reaction to an event or when set conditions are met. |
minecraft:behavior.drop_item_for | minecraft:behavior.drop_item_for compels the entity to move toward a target, and drop an item near the target. This goal requires a minecraft:navigation to execute. |
minecraft:behavior.eat_block | minecraft:behavior.eat_block compels the entity to consume a block, replace the eaten block with another block, and trigger an event as a result. |
minecraft:behavior.eat_carried_item | minecraft:behavior.eat_carried_item allows an entity to eat any item in its inventory and gain the benefits of the item. |
minecraft:behavior.eat_mob | minecraft:behavior.eat_mob compels the entity to eat a specified mob. |
minecraft:behavior.emerge | minecraft:behavior.emerge activates the "EMERGING" entity flag during the specified duration and triggers "on_done" at the end. |
minecraft:behavior.enderman_leave_block | minecraft:behavior.enderman_leave_block compels the entity to drop the block they are currently holding. |
minecraft:behavior.enderman_take_block | minecraft:behavior.enderman_take_block compels the entity to pick up a nearby block and carry the block in its hands. |
minecraft:behavior.equip_item | minecraft:behavior.equip_item causes an entity to equip an item. |
minecraft:behavior.explore_outskirts | minecraft:behavior.explore_outskirts compels an entity to travel beyond the bounds of a village and wander while looking for any points of interest. |
minecraft:behavior.fertilize_farm_block | minecraft:behavior.fertilize_farm_block compels the mob to search within an area for a growable crop block. If found, the mob will use any available fertilizer in their inventory on the crop. This goal will not execute if the mob does not have a fertilizer item in its inventory. |
minecraft:behavior.find_cover | minecraft:behavior.find_cover compels an entity to locate shade in the world. |
minecraft:behavior.find_mount | minecraft:behavior.find_mount compels an entity to find another entity to mount. |
minecraft:behavior.find_underwater_treasure | minecraft:behavior.find_underwater_treasure compels an entity to locate and travel to the nearest point of interest labeled as ruin or shipwreck . |
minecraft:behavior.flee_sun | minecraft:behavior.flee_sun will make the entity actively avoid the sunlight. |
minecraft:behavior.float | minecraft:behavior.float allows an entity to float on water. |
minecraft:behavior.float_wander | minecraft:behavior.float_wander allows an entity to float around in a random direction, similar to the ghast entity. |
minecraft:behavior.follow_caravan | minecraft:behavior.follow_caravan allows an entity to be lead with a Lead item. Leading the entity actually signals up to ten nearby entities that have been set in the entity_types variable to follow each other, forming a caravan. |
minecraft:behavior.follow_mob | minecraft:behavior.follow_mob compels an entity to follow and gather around all types of mobs, both hostile and neutral mobs. |
minecraft:behavior.follow_owner | minecraft:behavior.follow_owner compels an entity to follow a player marked as an owner. |
minecraft:behavior.follow_parent | minecraft:behavior.follow_parent compels an entity that has been tagged as a baby to follow their parent around. |
minecraft:behavior.follow_target_captain | minecraft:behavior.follow_target_captain compels an entity to follow a targeted captain. |
minecraft:behavior.go_and_give_items_to_noteblock | minecraft:behavior.go_and_give_items_to_noteblock means the entity will attempt to toss the items from its inventory to a nearby recently played noteblock. |
minecraft:behavior.go_and_give_items_to_owner | minecraft:behavior.go_and_give_items_to_owner means the entity will attempt to toss the items from its inventory to its owner. |
minecraft:behavior.go_home | minecraft:behavior.go_home compels an entity to travel back to where it was spawned at and trigger events upon arrival. |
minecraft:behavior.guardian_attack | minecraft:behavior.guardian_attack allows this entity to use a laser beam attack. Can only be used by Guardians and Elder Guardians. |
minecraft:behavior.harvest_farm_block | minecraft:behavior.harvest_farm_block minecraft:behavior.harvest_farm_block compels the entity to search within an area for farmland with air above it. If found, the entity will replace the air block by planting a seed item from its inventory on the farmland block. This goal requires minecraft:inventory and minecraft:navigation to execute. This goal will not execute if the entity does not have an item in its inventory. |
minecraft:behavior.hide | minecraft:behavior.hide compels an entity to navigate to a specific point of interest that is tied to the entity. |
minecraft:behavior.hold_ground | minecraft:behavior.hold_ground compels an entity to stop in their current location, turn to face a mob they are targeting and react with an event. |
minecraft:behavior.hurt_by_target | minecraft:behavior.hurt_by_target compels an entity to react when hit by set target. |
minecraft:behavior.inspect_bookshelf | minecraft:behavior.inspect_bookshelf compels an entity to look at and inspect a bookshelf. |
minecraft:behavior.investigate_suspicious_location | minecraft:behavior.investigate_suspicious_location compels the entity to move towards a "suspicious" position based on data gathered in minecraft:suspect_tracking. |
minecraft:behavior.jump_to_block | minecraft:behavior.jump_to_block compels the mob to search around for a block to jump to and then jump to that block. |
minecraft:behavior.knockback_roar | minecraft:behavior.knockback_roar compels an entity to emit a roar effect that knocks back other entities in a set radius from where the roar was emitted. |
minecraft:behavior.lay_down | minecraft:behavior.lay_down compels an entity randomly lay down for a period of time. |
minecraft:behavior.lay_egg | minecraft:behavior.lay_egg compels an entity to lay eggs |
minecraft:behavior.leap_at_target | minecraft:behavior.leap_at_target compels an entity to jump towards a target. |
minecraft:behavior.look_at_entity | minecraft:behavior.look_at_entity compels an entity to look at a specific entity by rotating the head bone pose within a set limit. |
minecraft:behavior.look_at_player | minecraft:behavior.look_at_player compels an entity to look at the player by rotating the head bone pose within a set limit. |
minecraft:behavior.look_at_target | minecraft:behavior.look_at_target compels an entity to look at the target by rotating the head bone pose within a set limit. |
minecraft:behavior.look_at_trading_player | minecraft:behavior.look_at_trading_player compels an entity to look at the player that is currently trading with the entity. |
minecraft:behavior.make_love | minecraft:behavior.make_love compels an entity to interact with other similar entities to produce an offspring. |
minecraft:behavior.melee_attack | minecraft:behavior.melee_attack compels entities to make close combat melee attacks. |
minecraft:behavior.mingle | minecraft:behavior.mingle compels an entity to navigate to the village bell point of interest and interact with other entities that have been assigned. |
minecraft:behavior.mount_pathing | minecraft:behavior.mount_pathing compels an entity to move around on its own while mounted. minecraft:behavior.mount_pathing also will allow an entity to target another entity for an attack. |
minecraft:behavior.move_indoors | minecraft:behavior.move_indoors compels an entity to move indoors. |
minecraft:behavior.move_outdoors | minecraft:behavior.move_outdoors compels an entity to move outdoors. |
minecraft:behavior.move_through_village | minecraft:behavior.move_through_village can only be used by villagers. Allows the villagers to create paths around the village. |
minecraft:behavior.move_to_land | minecraft:behavior.move_to_land compels an entity to move to land when in a non-land medium such as lava or water. |
minecraft:behavior.move_to_lava | minecraft:behavior.move_to_lava compels an entity to move to lava when on land. |
minecraft:behavior.move_to_liquid | minecraft:behavior.move_to_liquid compels the mob to move into a liquid when on land. |
minecraft:behavior.move_to_random_block | minecraft:behavior.move_to_random_block compels an entity to move to a random block within a set radius. |
minecraft:behavior.move_to_village | minecraft:behavior.move_to_village compels an entity to travel to a random x,y,z coordinate in a village. |
minecraft:behavior.move_to_water | minecraft:behavior.move_to_water compels an entity to move to water when on land. |
minecraft:behavior.move_towards_dwelling_restriction | minecraft:behavior.move_towards_dwelling_restriction compels mobs with the dweller component to move toward their Village area that the mob should be restricted to. |
minecraft:behavior.move_towards_home_restriction | minecraft:behavior.move_towards_home_restriction compels mobs with the home component to move toward their pre-defined area that the mob should be restricted to. |
minecraft:behavior.move_towards_restriction | minecraft:behavior.move_towards_restriction compels mobs to move toward their pre-defined area that the mob should be restricted to. |
minecraft:behavior.move_towards_target | minecraft:behavior.move_towards_target compels an entity to move towards a target. |
minecraft:behavior.nap | minecraft:behavior.nap compels mobs to occasionally stop and take a nap under certain conditions. |
minecraft:behavior.nearest_attackable_target | minecraft:behavior.nearest_attackable_target compels an entity to attack the closest target within a given subset of specific target types. |
minecraft:behavior.nearest_prioritized_attackable_target | minecraft:behavior.nearest_prioritized_attackable_target compels an entity to target and prioritize the nearest valid target. |
minecraft:behavior.ocelot_sit_on_block | minecraft:behavior.ocelot_sit_on_block compels an entity to sit in place, similar to the ocelot entity animation pose. |
minecraft:behavior.ocelotattack | minecraft:behavior.ocelotattack compels an entity to attack by sneaking and pouncing. |
minecraft:behavior.offer_flower | minecraft:behavior.offer_flower compels an entity to offer a flower to another entity. |
minecraft:behavior.open_door | minecraft:behavior.open_door compels an entity to interact and open a door. |
minecraft:behavior.owner_hurt_by_target | minecraft:behavior.owner_hurt_by_target compels an entity to react when the owner is hit by a target. |
minecraft:behavior.owner_hurt_target | minecraft:behavior.owner_hurt_target compels an entity to react when the owner hits a target. |
minecraft:behavior.panic | minecraft:behavior.panic compels an entity to react when it receives damage. |
minecraft:behavior.pet_sleep_with_owner | minecraft:behavior.pet_sleep_with_owner compels an entity to sleep on a bed shared with its' owner. |
minecraft:behavior.pickup_items | minecraft:behavior.pickup_items compels an entity to pick up selected items off the ground. |
minecraft:behavior.play | minecraft:behavior.play compels an entity to play with entities that have been tagged as baby . |
minecraft:behavior.play_dead | minecraft:behavior.play_dead compels the mob to play dead when attacked by other entities. When playing dead, other entities will not target this mob. |
minecraft:behavior.player_ride_tamed | minecraft:behavior.player_ride_tamed compels an entity to be rideable after being tamed by a player. |
minecraft:behavior.raid_garden | minecraft:behavior.raid_garden compels an entity to eat crops that have been planted in a farm. |
minecraft:behavior.ram_attack | minecraft:behavior.ram_attack compels the mob to search for a random target and, if a direct path exists between the mob and the target, it will perform a charge. If the attack hits, the target will be knocked back based on the mob's speed. |
minecraft:behavior.random_breach | minecraft:behavior.random_breach compels an entity to breach the surface of the water at a random interval. |
minecraft:behavior.random_fly | minecraft:behavior.random_fly compels an entity to fly to a random spot |
minecraft:behavior.random_hover | minecraft:behavior.random_hover compels an entity to hover around in random locations. |
minecraft:behavior.random_look_around | minecraft:behavior.random_look_around compels an entity to choose a random direction to look in for a random duration within a range. |
minecraft:behavior.random_look_around_and_sit | minecraft:behavior.random_look_around_and_sit compels an entity to sit in place and look around in different directions. |
minecraft:behavior.random_sitting | minecraft:behavior.random_sitting compels an entity to stop and sit for a random duration of time. |
minecraft:behavior.random_stroll | minecraft:behavior.random_stroll compels an entity to choose a random direction to walk towards. |
minecraft:behavior.random_swim | minecraft:behavior.random_swim compels an entity to swim in a random point in water. |
minecraft:behavior.ranged_attack | minecraft:behavior.ranged_attack compels an entity to attack by using ranged shots. charge_shoot_trigger must be greater than 0 to enable charged up burst-shot attacks. |
minecraft:behavior.receive_love | minecraft:behavior.receive_love compels an entity to mate with another similar entity when approached to breed. |
minecraft:behavior.restrict_open_door | minecraft:behavior.restrict_open_door compels an entity to stay indoors while the sun is down. |
minecraft:behavior.restrict_sun | minecraft:behavior.restrict_sun compels an entity to actively avoid direct sunlight. |
minecraft:behavior.rise_to_liquid_level | minecraft:behavior.rise_to_liquid_level compels the mob to stay at a certain level when in liquid. |
minecraft:behavior.roar | minecraft:behavior.roar plays the provided sound and activates the "ROARING" entity flag during the specified duration. |
minecraft:behavior.roll | minecraft:behavior.roll compels an entity roll forward. |
minecraft:behavior.run_around_like_crazy | minecraft:behavior.run_around_like_crazy compels an entity to run around without a set goal. |
minecraft:behavior.scared | minecraft:behavior.scared compels the a mob to become scared when the weather outside is thundering. |
minecraft:behavior.send_event | minecraft:behavior.send_event compels an entity to send an event to another entity. |
minecraft:behavior.share_items | minecraft:behavior.share_items compels an entity to share items they have in their inventory with other specific entities that have been defined. |
minecraft:behavior.silverfish_merge_with_stone | minecraft:behavior.silverfish_merge_with_stone compels an entity to enter a stone block. |
minecraft:behavior.silverfish_wake_up_friends | minecraft:behavior.silverfish_wake_up_friends compels an entity to alert other entities of the same family to leave a stone block. |
minecraft:behavior.skeleton_horse_trap | minecraft:behavior.skeleton_horse_trap Allows an entity to be Horse Traps and be triggered like them, spawning a lightning bolt and a bunch of horses when a player is nearby. |
minecraft:behavior.sleep | minecraft:behavior.sleep compels an entity to sleep in a bed. |
minecraft:behavior.slime_attack | minecraft:behavior.slime_attack compels an entity to make a melee attack similar to the slime and magma_cube . |
minecraft:behavior.slime_float | minecraft:behavior.slime_float compels entities to float in water or lava. Can only be used by slime and magma_cube . |
minecraft:behavior.slime_keep_on_jumping | minecraft:behavior.slime_keep_on_jumping minecraft:behavior.slime_keep_on_jumping compels the entity to continuously jump around like a slime. |
minecraft:behavior.slime_random_direction | minecraft:behavior.slime_random_direction compels the entity to move in random directions like a slime. |
minecraft:behavior.snacking | minecraft:behavior.snacking compels an entity to stop and interact with select food items that are nearby. |
minecraft:behavior.sneeze | minecraft:behavior.sneeze compels an entity to sneeze and potentially started other entities. While sneezing, the entity may drop an item. |
minecraft:behavior.sniff | minecraft:behavior.sniff means the entity detects the nearest player within "sniffing_radius" and updates its "minecraft:suspect_tracking" component state. |
minecraft:behavior.sonic_boom | minecraft:behavior.sonic_boom plays the provided sounds and activates the "SONIC BOOM" entity flag during the specified duration. |
minecraft:behavior.squid_dive | minecraft:behavior.squid_dive compels an entity to dive underwater. |
minecraft:behavior.squid_flee | minecraft:behavior.squid_flee compels an entity to swim away when attacked. |
minecraft:behavior.squid_idle | minecraft:behavior.squid_idle compels an entity to swim in place. |
minecraft:behavior.squid_move_away_from_ground | minecraft:behavior.squid_move_away_from_ground compels an entity to swim away from the ground blocks. |
minecraft:behavior.squid_out_of_water | minecraft:behavior.squid_out_of_water compels an entity to stay close to a ground block when out of water. |
minecraft:behavior.stalk_and_pounce_on_target | minecraft:behavior.stalk_and_pounce_on_target compels an entity to stalk a specific target. Once within range of the target, the entity will then leap at the target and deal damage based upon its attack attribute. |
minecraft:behavior.stay_near_noteblock | minecraft:behavior.stay_near_noteblock means the entity will attempt to stay near a recently played noteblock. |
minecraft:behavior.stay_while_sitting | minecraft:behavior.stay_while_sitting compels an entity to stay in place while sitting. |
minecraft:behavior.stomp_attack | minecraft:behavior.stomp_attack compels an entity to attack using stomp AoE damage behavior. |
minecraft:behavior.stomp_turtle_egg | minecraft:behavior.stomp_turtle_egg compels an entity to target and stomp on turtle eggs when detected. |
minecraft:behavior.stroll_towards_village | minecraft:behavior.stroll_towards_village compels an entity to navigate and search for a nearby village. |
minecraft:behavior.summon_entity | minecraft:behavior.summon_entity compels an entity to attack other entities by summoning new entities. |
minecraft:behavior.swell | minecraft:behavior.swell compels an entity to grow in size when approached, and scale down back to normal after a certain distance. |
minecraft:behavior.swim_idle | minecraft:behavior.swim_idle compels the entity go idle, if swimming. Entity must be in water. |
minecraft:behavior.swim_up_for_breath | minecraft:behavior.swim_up_for_breath compels the mob to try to move to air when it is close to running out of its total breathable supply. Requires minecraft:breathable . |
minecraft:behavior.swim_wander | minecraft:behavior.swim_wander compels the entity to wander around while swimming, when not path-finding. |
minecraft:behavior.swim_with_entity | minecraft:behavior.swim_with_entity compels the entity follow another entity. Both entities must be swimming and in water. |
minecraft:behavior.swoop_attack | minecraft:behavior.swoop_attack compels an entity to attack using swoop attack behavior. Ideal for use with flying mobs. The behavior ends if the entity has a horizontal collision or gets hit. |
minecraft:behavior.take_flower | minecraft:behavior.take_flower compels an entity to receive flowers when presented from the iron_golem entity. |
minecraft:behavior.target_when_pushed | minecraft:behavior.target_when_pushed compels an entity to target an entity when pushed. |
minecraft:behavior.teleport_to_owner | minecraft:behavior.teleport_to_owner allows an entity to teleport to its owner. |
minecraft:behavior.tempt | minecraft:behavior.tempt compels an entity to be tempted by a set item. |
minecraft:behavior.timer_flag_1 | minecraft:behavior.timer_flag_1 fires an event when this behavior starts, then waits for a duration before stopping. |
minecraft:behavior.timer_flag_2 | minecraft:behavior.timer_flag_2 fires an event when this behavior starts, then waits for a duration before stopping. |
minecraft:behavior.timer_flag_3 | minecraft:behavior.timer_flag_3 fires an event when this behavior starts, then waits for a duration before stopping. |
minecraft:behavior.trade_interest | minecraft:behavior.trade_interest compels an entity to focus on a player that will initiate a trade. |
minecraft:behavior.trade_with_player | minecraft:behavior.trade_with_player compels an entity to focus on a player that will initiate a trade. |
minecraft:behavior.vex_copy_owner_target | minecraft:behavior.vex_copy_owner_target compels an entity of thevex family to target the same entity as its owner. |
minecraft:behavior.vex_random_move | minecraft:behavior.vex_random_move compels an entity of thevex family to move randomly. |
minecraft:behavior.wither_random_attack_pos_goal | minecraft:behavior.wither_random_attack_pos_goal compels an entity to attack at random. |
minecraft:behavior.wither_target_highest_damage | minecraft:behavior.wither_target_highest_damage compels an entity to focus its attacks on whichever hostile mob has dealt the most damage to it. |
minecraft:behavior.work | minecraft:behavior.work compels the NPC to use their jobsite POI. |
minecraft:behavior.work_composter | minecraft:behavior.work_composter compels the NPC to use the composter POI to convert excess seeds into bone meal. |