Minecraft:Mob AI - Revision history

SyncBot: Sync: updated from Minecraft

2026-10-07T11:20:26Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:20, 7 October 2026
Line 3:		Line 3:
	{{cleanup}}		{{cleanup}}

	'''Mob AI''' is the mechanism through which [[Minecraft:mob]]s behave and adapt their behavior according to their environment. Despite its name, ~~mob AI does not~~ use ~~[[Minecraft:~~w~~:AI~~\|artificial intelligence]] to ~~work~~.		'''Mob AI''' is the mechanism through which [[Minecraft:mob]]s behave and adapt their behavior according to their environment. Despite its name, it refers to the traditional use of {{w\|artificial intelligence in video games}}, rather than the {{w\|generative AI}} commonly referred to simply as "AI" in recent years.

	This article describes the various components of a mob's AI that control its behavior.		This article describes the various components of a mob's AI that control its behavior.

SyncBot: Sync: updated from Minecraft

2026-09-22T11:10:17Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:10, 22 September 2026
Line 2:		Line 2:
	{{WIP}}		{{WIP}}
	{{cleanup}}		{{cleanup}}

			'''Mob AI''' is the mechanism through which [[Minecraft:mob]]s behave and adapt their behavior according to their environment. Despite its name, mob AI does not use [[Minecraft:w:AI\|artificial intelligence]] to work.

	This article describes the various components of a mob's AI that control its behavior.		This article describes the various components of a mob's AI that control its behavior.
Line 9:		Line 11:

	=== Memory ===		=== Memory ===

	A brain stores data as memories. The type a memory represents is called the memory module type. The data itself is stored within a corresponding memory slot. Within the memory slot the data value can be empty, signaling that the memory is empty, or it can have a value signaling that the memory is present. Additionally the memory may have a time-to-live. The time-to-live indicates the number of ticks after which the memory is forgotten, and the memory value will become empty again. If the time-to-live is not specified, it is assumed to be infinite, i.e. the memory is permanent.		A brain stores data as memories. The type a memory represents is called the memory module type. The data itself is stored within a corresponding memory slot. Within the memory slot the data value can be empty, signaling that the memory is empty, or it can have a value signaling that the memory is present. Additionally the memory may have a time-to-live. The time-to-live indicates the number of ticks after which the memory is forgotten, and the memory value will become empty again. If the time-to-live is not specified, it is assumed to be infinite, i.e. the memory is permanent.

Line 23:		Line 24:

	==== Memory statuses ====		==== Memory statuses ====

	Registered memory module types can have three states in a brain:		Registered memory module types can have three states in a brain:

Line 33:		Line 33:

	==== Memory module types ====		==== Memory module types ====

	{\|class= "wikitable collapsible collapsed stikitable"		{\|class= "wikitable collapsible collapsed stikitable"
	\|+ List of Memory module types {{in\|JE}}		\|+ List of Memory module types {{in\|JE}}
Line 782:		Line 781:
	* Otherwise, it returns true.		* Otherwise, it returns true.

	{{A\|can attack}}		{{Anchor\|can attack}}
	The table below shows when the conditions of a living entity (the targeter) can not attack another (the target). At least one condition must be satisfied for it not to attack.		The table below shows when the conditions of a living entity (the targeter) can not attack another (the target). At least one condition must be satisfied for it not to attack.

Line 833:		Line 832:
	\| {{EntityLink\|Warden}}		\| {{EntityLink\|Warden}}
	\|		\|
	* The {{Tooltip\|warden\|targeter}} can not target the target: {{a\|warden can target}}		* The {{Tooltip\|warden\|targeter}} can not target the target: {{Anchor\|warden can target}}
	{{Collapse\|content=		{{Collapse\|content=
	<!--:* The target is a living entity		<!--:* The target is a living entity
Line 985:		Line 984:
	\|NearestLivingEntitySensor		\|NearestLivingEntitySensor
	\|{{cd\|mobs}} and {{cd\|visible_mobs}}		\|{{cd\|mobs}} and {{cd\|visible_mobs}}
	\|{{A\|NearestLivingEntitySensor}}		\|{{Anchor\|NearestLivingEntitySensor}}
	Lists all other [[Minecraft:living entities]] that are alive and within a [[Minecraft:w:Cuboid\|cuboid]] generated by the mob's [[Minecraft:Hitbox#Entity hitboxes\|hitbox]] expanded by its {{attr\|follow_range}} in all directions. Sorts the entities by [[Minecraft:Euclidean distance]] from the mob and stores the list in the {{cd\|mobs}} memory.		Lists all other [[Minecraft:living entities]] that are alive and within a [[Minecraft:w:Cuboid\|cuboid]] generated by the mob's [[Minecraft:Hitbox#Entity hitboxes\|hitbox]] expanded by its {{attr\|follow_range}} in all directions. Sorts the entities by [[Minecraft:Euclidean distance]] from the mob and stores the list in the {{cd\|mobs}} memory.

Line 992:		Line 991:
	\|NearestVisibleLivingEntitySensor		\|NearestVisibleLivingEntitySensor
	\|{{cd\|visible_mobs}} and a memory defined by the subclass		\|{{cd\|visible_mobs}} and a memory defined by the subclass
	\|{{A\|NearestVisibleLivingEntitySensor}} Searches the {{cd\|visible_mobs}} memory for the closest [[Minecraft:living entity]] that matches the conditions defined by the subclass.		\|{{Anchor\|NearestVisibleLivingEntitySensor}} Searches the {{cd\|visible_mobs}} memory for the closest [[Minecraft:living entity]] that matches the conditions defined by the subclass.

	The matching entity is stored in the memory defined by the subclass. If no matching entity is found, the memory is set to empty.		The matching entity is stored in the memory defined by the subclass. If no matching entity is found, the memory is set to empty.
Line 1,798:		Line 1,797:
	* [[Minecraft:Mob infighting]]		* [[Minecraft:Mob infighting]]

	==Navigation==		== Navigation ==
	{{Navbox Java Edition technical\|general}}		{{Navbox Java Edition technical\|general}}

SyncBot: Sync: updated from Minecraft

2026-09-16T11:28:36Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:28, 16 September 2026
Line 776:		Line 776:
	*** Multiplying by {{cd\|0.175p}} if target is invisible and has {{cd\|p≥1}} equipaments in humanoid armor slot,		*** Multiplying by {{cd\|0.175p}} if target is invisible and has {{cd\|p≥1}} equipaments in humanoid armor slot,
	*** Multiplying by {{cd\|0.5}} if target is using the corresponding mob [[Minecraft:head]] in the {{cd\|head}} slot (for [[Minecraft:skeleton]], [[Minecraft:zombie]], [[Minecraft:piglin]], [[Minecraft:piglin brute]], and [[Minecraft:creeper]])		*** Multiplying by {{cd\|0.5}} if target is using the corresponding mob [[Minecraft:head]] in the {{cd\|head}} slot (for [[Minecraft:skeleton]], [[Minecraft:zombie]], [[Minecraft:piglin]], [[Minecraft:piglin brute]], and [[Minecraft:creeper]])
	**** This depends on the component {{DCL\|mob_visibility}}, more specifically, for each target's equipment slot ''s'' there is an item with the component {{DCL\|equippable.slot}} equal to ''s'', and the targeter is contained in {{cd\|mob_visibility.targeting_entity_types}}, the modifier is multiplied by {{cd\|mob_visibility.visibility}}.~~{{Upcoming\|Java 26.3}~~}		**** This depends on the component {{DCL\|mob_visibility}}, more specifically, for each target's equipment slot ''s'' there is an item with the component {{DCL\|equippable.slot}} equal to ''s'', and the targeter is contained in {{cd\|mob_visibility.targeting_entity_types}}, the modifier is multiplied by {{cd\|mob_visibility.visibility}}.}
	*** The modifier is limited by {{cd\|10.0}}.~~{{Upcoming\|Java 26.3}}~~		*** The modifier is limited by {{cd\|10.0}}.
	* If {{nbt\|bool\|checkLineOfSight}} is true, the targeter is a mob, and it is not possible to draw a straight line from the targeter's eye to the target without intersecting a block [[Minecraft:collision box]], return false.		* If {{nbt\|bool\|checkLineOfSight}} is true, the targeter is a mob, and it is not possible to draw a straight line from the targeter's eye to the target without intersecting a block [[Minecraft:collision box]], return false.
	** If the mob is a [[Minecraft:ravager]] with a stunned tick or roar tick greater than 0, return false.		** If the mob is a [[Minecraft:ravager]] with a stunned tick or roar tick greater than 0, return false.

SyncBot: Sync: updated from Minecraft

2026-09-08T11:08:54Z

Sync: updated from Minecraft

Show changes

SyncBot: Sync: updated from Minecraft

2026-09-04T11:09:01Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:09, 4 September 2026
Line 208:		Line 208:
	! memoryTimeToLive		! memoryTimeToLive
	\|-		\|-
	\|armadillo_scare_detected		\|{{cd\|armadillo_scare_detected}}
	\|5		\|5
	\| Armadillo.isScaredBy({{mono\|livingEntity}}):		\| Armadillo.isScaredBy({{mono\|livingEntity}}):
Line 234:		Line 234:
	! temptations		! temptations
	\|-		\|-
	\|food_temptations		\|{{cd\|food_temptations}}
	\| For each mob and item stack, test if the item is food for the mob. For mobs with these sensors, it means the item is tagged:		\| For each mob and item stack, test if the item is food for the mob. For mobs with these sensors, it means the item is tagged:
	* {{EntityLink\|Armadillo}} — Tag {{Tag link\|item\|armadillo_food}}		* {{EntityLink\|Armadillo}} — Tag {{Tag link\|item\|armadillo_food}}
Line 243:		Line 243:
	* {{EntityLink\|Sniffer}} — Tag {{Tag link\|item\|sniffer_food}}		* {{EntityLink\|Sniffer}} — Tag {{Tag link\|item\|sniffer_food}}
	\|-		\|-
	\|frog_temptations		\|{{cd\|frog_temptations}}
	\|		\|
	Check if the item is [[Minecraft:frog]] food (it's on the tag {{Tag link\|item\|frog_food}}), regardless of the mob.		Check if the item is [[Minecraft:frog]] food (it's on the tag {{Tag link\|item\|frog_food}}), regardless of the mob.
	\|-		\|-
	\|nautilus_temptations		\|{{cd\|nautilus_temptations}}
	\|		\|
	Check if the item is [[Minecraft:nautilus]] food (it's on the tag {{Tag link\|item\|nautilus_food}}), regardless of the mob.		Check if the item is [[Minecraft:nautilus]] food (it's on the tag {{Tag link\|item\|nautilus_food}}), regardless of the mob.

SyncBot: Sync: updated from Minecraft

2026-08-18T11:36:31Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:36, 18 August 2026
Line 467:		Line 467:
	\|{{cd\|nearest_bed}}		\|{{cd\|nearest_bed}}
	\|If the mob is a [[Minecraft:baby]]:		\|If the mob is a [[Minecraft:baby]]:
	* Searches for [[Minecraft:Point of Interest\|POIs]] of type <code>home</code> ([[Minecraft:bed]]) within 48 blocks of the mob. The sensor uses a cache to avoid repeatedly checking the same POIs and attempts to add up to 5 new beds to the cache during each scan.		* Searches for [[Minecraft:Point of Interest\|POIs]] of type <code>home</code> ([[Minecraft:bed]] head) within 48 blocks of the mob. The sensor uses a cache to avoid repeatedly checking the same POIs and attempts to add up to 5 new beds to the cache during each scan.
	* The sensor attempts to create a [[Minecraft:Mob AI#Pathfinding\|path]] to the found beds. If a path is found and can reach its target, and the target is a valid POI, it stores the target's position in the mob's {{cd\|nearest_bed}} memory.		* The sensor attempts to create a [[Minecraft:Mob AI#Pathfinding\|path]] to the found beds. If a path is found and can reach its target, and the target is a valid POI, it stores the target's position in the mob's {{cd\|nearest_bed}} memory.
	* If no reachable bed is found and fewer than 5 POIs were checked, it removes expired entries from the cache.{{fn\|group=sensor\|name=bedcache\| A POI is considered expired depending on whether the current {{cd\|lastUpdate}} exceeds the {{cd\|lastUpdate}} from when the POI was added to the cache by more than 40. The {{cd\|lastUpdate}} is an auxiliary variable defined as {{tooltip\|Gametime\|the total number of game ticks that have elapsed in the world}} + {{Tooltip\|random.nextInt(20)\|0 ≤ int < 20}}, at the beginning of the doTick.}}		* If no reachable bed is found and fewer than 5 POIs were checked, it removes expired entries from the cache.{{fn\|group=sensor\|name=bedcache\| A POI is considered expired depending on whether the current {{cd\|lastUpdate}} exceeds the {{cd\|lastUpdate}} from when the POI was added to the cache by more than 40. The {{cd\|lastUpdate}} is an auxiliary variable defined as {{tooltip\|Gametime\|the total number of game ticks that have elapsed in the world}} + {{Tooltip\|random.nextInt(20)\|0 ≤ int < 20}}, at the beginning of the doTick.}}

SyncBot: Sync: updated from Minecraft

2026-07-30T11:11:45Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:11, 30 July 2026
Line 10:		Line 10:
	Sensors are used to detect if a mob with a brain can perform certain tasks. Examples of sensors include a sensor to detect if an armadillo should be scared, a sensor to detect the nearest player, and a sensor to detect if a mob is in water.		Sensors are used to detect if a mob with a brain can perform certain tasks. Examples of sensors include a sensor to detect if an armadillo should be scared, a sensor to detect the nearest player, and a sensor to detect if a mob is in water.

	By default, sensors run~~, by default,~~ once every {{Convert\|20\|game ticks\|second}}, although individual sensor classes can have a different scan rate. When a sensor runs, it updates its targeting conditions to match the mob's current {{attr\|follow_range}} attribute before performing its [[#Targeting condition\|targeting condition]]. The first execution of each sensor is delayed by a random number of ticks, preventing multiple sensors from running simultaneously; the random number is an integer between 0 (inclusive) and the scam rate (exclusive).		By default, sensors run once every {{Convert\|20\|game ticks\|second}}, although individual sensor classes can have a different scan rate. When a sensor runs, it updates its targeting conditions to match the mob's current {{attr\|follow_range}} attribute before performing its [[#Targeting condition\|targeting condition]]. The first execution of each sensor is delayed by a random number of ticks, preventing multiple sensors from running simultaneously; the random number is an integer between 0 (inclusive) and the scam rate (exclusive).

	{\|class= "wikitable collapsible"		{\|class= "wikitable collapsible"
Line 452:		Line 452:
	\|IsInWaterSensor		\|IsInWaterSensor
	\|{{cd\|is_in_water}}		\|{{cd\|is_in_water}}
	\|Checks whether the mob is in [[Minecraft:water]]. If it is, it sets the {{cd\|is_in_water}} memory. Otherwise, it removes the {{cd\|is_in_water}} memory.		\|Checks whether the mob is in [[Minecraft:water]]: the hitbox intersects the fluid in the {{Tag link\|fluid\|water}} fluid tag, if the mob are on the [[Minecraft:boat]], reduce the y-min of the hitbox; disregard heights below the height of the boat, except if the boat is underwater.

			If it is, it sets the {{cd\|is_in_water}} memory. Otherwise, it removes the {{cd\|is_in_water}} memory.
	\|-		\|-
	\|MobSensor		\|MobSensor

SyncBot: Sync: updated from Minecraft

2026-07-27T11:09:06Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:09, 27 July 2026
Line 263:		Line 263:
	The test value is a boolean value that depends on the target and the targeter (and can be null), both [[Minecraft:living entity]] such that:		The test value is a boolean value that depends on the target and the targeter (and can be null), both [[Minecraft:living entity]] such that:
	* If target and targeter are the same entity, it returns false.		* If target and targeter are the same entity, it returns false.
	* If the target is not alive or is a player in [[Minecraft:Spectator]] mode, returns false.		* If the target is not alive or is a player in [[Minecraft:Spectator]] mode or an invisible or marker [[Minecraft:armor stand]], returns false.
	* If the '''selector''' is not null, and the target is valid in the '''selector''' test, return false.		* If the '''selector''' is not null, and the target is valid in the '''selector''' test, return false.
	* If the targeter is null, {{nbt\|bool\|isCombat}} is true, and target is invulnerable, or the difficulty is [[Minecraft:peaceful]], it returns false. The following points assume that targeter is not null.		* If the targeter is null, {{nbt\|bool\|isCombat}} is true, and target is invulnerable, or the difficulty is [[Minecraft:peaceful]], it returns false. The following points assume that targeter is not null.
Line 275:		Line 275:
	**** This depends on the component {{DCL\|mob_visibility}}, more specifically, for each target's equipment slot ''s'' there is an item with the component {{DCL\|equippable.slot}} equal to ''s'', and the targeter is contained in {{cd\|mob_visibility.targeting_entity_types}}, the modifier is multiplied by {{cd\|mob_visibility.visibility}}.{{Upcoming\|Java 26.3}}		**** This depends on the component {{DCL\|mob_visibility}}, more specifically, for each target's equipment slot ''s'' there is an item with the component {{DCL\|equippable.slot}} equal to ''s'', and the targeter is contained in {{cd\|mob_visibility.targeting_entity_types}}, the modifier is multiplied by {{cd\|mob_visibility.visibility}}.{{Upcoming\|Java 26.3}}
	*** The modifier is limited by {{cd\|10.0}}.{{Upcoming\|Java 26.3}}		*** The modifier is limited by {{cd\|10.0}}.{{Upcoming\|Java 26.3}}
	* If {{nbt\|bool\|checkLineOfSight}} is true, the targeter is a mob, and it is not possible to draw a straight line from the targeter's eye to the target without intersecting a block [[Minecraft:collision box]], return false.		* If {{nbt\|bool\|checkLineOfSight}} is true, the targeter is a mob, and it is not possible to draw a straight line from the targeter's eye to the target without intersecting a block [[Minecraft:collision box]], return false.
			** If the mob is a [[Minecraft:ravager]] with a stunned tick or roar tick greater than 0, return false.
	* Otherwise, it returns true.		* Otherwise, it returns true.

SyncBot: Sync: updated from Minecraft

2026-07-26T11:10:01Z

Sync: updated from Minecraft

Show changes

SyncBot: Sync: updated from Minecraft

2026-07-25T11:08:43Z

Sync: updated from Minecraft

Show changes

← Older revision		Revision as of 11:28, 16 September 2026
Line 776:		Line 776:
	*** Multiplying by {{cd\|0.175p}} if target is invisible and has {{cd\|p≥1}} equipaments in humanoid armor slot,		*** Multiplying by {{cd\|0.175p}} if target is invisible and has {{cd\|p≥1}} equipaments in humanoid armor slot,
	*** Multiplying by {{cd\|0.5}} if target is using the corresponding mob [[Minecraft:head]] in the {{cd\|head}} slot (for [[Minecraft:skeleton]], [[Minecraft:zombie]], [[Minecraft:piglin]], [[Minecraft:piglin brute]], and [[Minecraft:creeper]])		*** Multiplying by {{cd\|0.5}} if target is using the corresponding mob [[Minecraft:head]] in the {{cd\|head}} slot (for [[Minecraft:skeleton]], [[Minecraft:zombie]], [[Minecraft:piglin]], [[Minecraft:piglin brute]], and [[Minecraft:creeper]])
	**** This depends on the component {{DCL\|mob_visibility}}, more specifically, for each target's equipment slot ''s'' there is an item with the component {{DCL\|equippable.slot}} equal to ''s'', and the targeter is contained in {{cd\|mob_visibility.targeting_entity_types}}, the modifier is multiplied by {{cd\|mob_visibility.visibility}}.~~{{Upcoming\|Java 26.3}~~}		**** This depends on the component {{DCL\|mob_visibility}}, more specifically, for each target's equipment slot ''s'' there is an item with the component {{DCL\|equippable.slot}} equal to ''s'', and the targeter is contained in {{cd\|mob_visibility.targeting_entity_types}}, the modifier is multiplied by {{cd\|mob_visibility.visibility}}.}
	*** The modifier is limited by {{cd\|10.0}}.~~{{Upcoming\|Java 26.3}}~~		*** The modifier is limited by {{cd\|10.0}}.
	* If {{nbt\|bool\|checkLineOfSight}} is true, the targeter is a mob, and it is not possible to draw a straight line from the targeter's eye to the target without intersecting a block [[Minecraft:collision box]], return false.		* If {{nbt\|bool\|checkLineOfSight}} is true, the targeter is a mob, and it is not possible to draw a straight line from the targeter's eye to the target without intersecting a block [[Minecraft:collision box]], return false.
	** If the mob is a [[Minecraft:ravager]] with a stunned tick or roar tick greater than 0, return false.		** If the mob is a [[Minecraft:ravager]] with a stunned tick or roar tick greater than 0, return false.

← Older revision		Revision as of 11:36, 18 August 2026
Line 467:		Line 467:
	\|{{cd\|nearest_bed}}		\|{{cd\|nearest_bed}}
	\|If the mob is a [[Minecraft:baby]]:		\|If the mob is a [[Minecraft:baby]]:
	* Searches for [[Minecraft:Point of Interest\|POIs]] of type <code>home</code> ([[Minecraft:bed]]) within 48 blocks of the mob. The sensor uses a cache to avoid repeatedly checking the same POIs and attempts to add up to 5 new beds to the cache during each scan.		* Searches for [[Minecraft:Point of Interest\|POIs]] of type <code>home</code> ([[Minecraft:bed]] head) within 48 blocks of the mob. The sensor uses a cache to avoid repeatedly checking the same POIs and attempts to add up to 5 new beds to the cache during each scan.
	* The sensor attempts to create a [[Minecraft:Mob AI#Pathfinding\|path]] to the found beds. If a path is found and can reach its target, and the target is a valid POI, it stores the target's position in the mob's {{cd\|nearest_bed}} memory.		* The sensor attempts to create a [[Minecraft:Mob AI#Pathfinding\|path]] to the found beds. If a path is found and can reach its target, and the target is a valid POI, it stores the target's position in the mob's {{cd\|nearest_bed}} memory.
	* If no reachable bed is found and fewer than 5 POIs were checked, it removes expired entries from the cache.{{fn\|group=sensor\|name=bedcache\| A POI is considered expired depending on whether the current {{cd\|lastUpdate}} exceeds the {{cd\|lastUpdate}} from when the POI was added to the cache by more than 40. The {{cd\|lastUpdate}} is an auxiliary variable defined as {{tooltip\|Gametime\|the total number of game ticks that have elapsed in the world}} + {{Tooltip\|random.nextInt(20)\|0 ≤ int < 20}}, at the beginning of the doTick.}}		* If no reachable bed is found and fewer than 5 POIs were checked, it removes expired entries from the cache.{{fn\|group=sensor\|name=bedcache\| A POI is considered expired depending on whether the current {{cd\|lastUpdate}} exceeds the {{cd\|lastUpdate}} from when the POI was added to the cache by more than 40. The {{cd\|lastUpdate}} is an auxiliary variable defined as {{tooltip\|Gametime\|the total number of game ticks that have elapsed in the world}} + {{Tooltip\|random.nextInt(20)\|0 ≤ int < 20}}, at the beginning of the doTick.}}