View source for Minecraft:Advancement/Conditions/entity

<div class="treeview">
<onlyinclude>
** {{nbt|list}}{{nbt|string|type}}: {{json ref|entity type|Java_Edition_data_values#Entities|tag=1}} &mdash; Test this entity's type.
** {{nbt|compound|components}}: Matches exact item component values. Each key in this object corresponds to a component to test, with its value as the desired data to compare. For example, can be used to avoid NBT serialisation when checking for mob variants or the exact text component match of a custom name.
*** See [[Minecraft:data component format]].
** {{nbt|compound|distance}}: To test the distance to the entity this predicate is invoked upon. Passes if the calculated distance is between the entered {{nbt|float|min}} and {{nbt|float|max}} values.
*** {{nbt|float}}{{nbt|compound|absolute}}: Test the distance between the two points in 3D space.
*** {{nbt|float}}{{nbt|compound|horizontal}}: Test the distance between the two points, ignoring the Y value.
*** {{nbt|float}}{{nbt|compound|x}}: Test the absolute difference between the X-coordinates of the two points.
*** {{nbt|float}}{{nbt|compound|y}}: Test the absolute difference between the Y-coordinates of the two points.
*** {{nbt|float}}{{nbt|compound|z}}: Test the absolute difference between the Z-coordinates of the two points.
** {{nbt|compound|effects}}: For testing the active [[Minecraft:Effect|status effects]] on the entity.
*** {{nbt|compound|<minecraft:effect_name>}}: A status effect that must be present.
**** {{nbt|int}}{{nbt|compound|amplifier}}: Test the effect's amplifier. Level I is represented by 0. Use an object with {{nbt|int|min}} and {{nbt|int|max}} to test for a range of values (inclusive).
**** {{nbt|int}}{{nbt|compound|duration}}: Test if the effect's remaining time (in ticks). Test if the effect's remaining time (in ticks) is between two numbers, inclusive. Use an object with {{nbt|int|min}} and {{nbt|int|max}} to test for a range of values (inclusive).
**** {{nbt|bool|ambient}}: Test whether the effect is from a beacon.
**** {{nbt|bool|visible}}: Test if the effect has visible particles.
** {{nbt|compound|equipment}}: For testing the items that this entity holds in its equipment slots.
*** {{nbt|compound|<equipment slot>}}: Test the item in the entity's equipment slot. Valid keys are {{cd|mainhand|offhand|head|chest|legs|feet|body|d=or}}.
**** {{nbt inherit/conditions/item}}
** {{nbt|compound|flags}}: To test flags of the entity.
*** {{nbt|bool|is_baby}}: Test whether the entity a baby variant (true) or an adult variant (false). Passes no matter what if this entity does not have baby and adult variants.
*** {{nbt|bool|is_on_fire}}: Test whether the entity has caught fire (true) or is not on fire (false). Does not pass if the entity has only been taking damage from a fire block for less than one second.
*** {{nbt|bool|is_sneaking}}: Test whether the entity is sneaking (true) or not sneaking (false).
*** {{nbt|bool|is_sprinting}}: Test whether the entity is sprinting (true) or not sprinting (false). Due to client-server desyncing bugs, it is possible for the player to be sprinting client-side while the server thinks that they have stopped, causing this flag to be false erroneously.
*** {{nbt|bool|is_swimming}}: Test whether the entity is swimming (true) or not swimming (false).
*** {{nbt|bool|is_on_ground}}: Test whether the entity is on the ground (true) or not on the ground (false). Teleporting an entity registers them as on the ground for one tick, even if they are teleported into the air.
*** {{nbt|bool|is_flying}}: Test whether the entity is either gliding with elytra or flying with creative mode (true) or is not (false).
*** {{nbt|bool|is_fall_flying}}: Test whether the entity is gliding with an elytra (true) or is not (false).
** {{nbt|compound|location}}: Test properties of this entity's location.
*** {{nbt inherit/conditions/location}}
** {{nbt|string}}{{nbt|compound|nbt}}: Test for a partial NBT data match with this entity. This is always the last test to be performed by the predicate, as it is the slowest check. Can either be specified as an NBT (compound) object, or as a string containing the SNBT representation of the NBT compound, meaning the outer braces (<code>{ }</code>) must be included within the string. Additional care is required if the NBT contains quotation marks (<code>" "</code>) as they must be escaped with a backslash before each (<code>\"</code>). If specified as an object rather than a string in a JSON file, the data type of any number value is implicitly checked for as the smallest data type that that number fits into, causing the test to fail and requiring you use the string format instead to specify the data type explicitly.
** {{nbt|compound|passenger}}: Test the entities directly riding this entity. At least one passenger must pass this condition for the predicate to pass.
*** {{nbt inherit/conditions/entity}}
** {{nbt|compound|slots}}: Test for items in specific inventory [[Minecraft:slot]]s.
*** {{nbt|compound|<slot range>}}: [[Minecraft:Slot]] or range of slots to test. At least one item matching the condition must exist in this range for the predicate to pass.
**** {{nbt inherit/conditions/item}}
** {{nbt|compound|stepping_on}}: Test properties of the block the entity is standing on, using a location predicate. The block may not be directly under the player's feet if they are crouching off of the side of the block.
*** {{nbt inherit/conditions/location}}
** {{nbt|compound|movement_affected_by}}: Test properties of the block {{cd|0.5}} blocks below the block the entity is standing on, using a location predicate.
*** {{nbt inherit/conditions/location}}
** {{nbt|string|team}}: Passes if the [[Minecraft:Scoreboard#Teams|team]] of this entity matches this string.
** {{nbt|compound|targeted_entity}}: Test properties of the entity which this mob's AI is targeting for attacks.
*** {{nbt inherit/conditions/entity}}
** {{nbt|compound|vehicle}}: Test properties of the [[Minecraft:Riding#Behaviors|vehicle]] entity that this entity is mounted on.
*** {{nbt inherit/conditions/entity}}
** {{nbt|compound|movement}}: Test the movement of the entity. For all fields, use an object with {{nbt|double|min}} and {{nbt|double|max}} to test for a range of values (inclusive).
*** {{nbt|double}}{{nbt|compound|x}}: Test the velocity along the x-axis in ''blocks per second''.
*** {{nbt|double}}{{nbt|compound|y}}: Test the velocity along the y-axis in ''blocks per second''.
*** {{nbt|double}}{{nbt|compound|z}}: Test the velocity along the z-axis in ''blocks per second''.
*** {{nbt|double}}{{nbt|compound|speed}}: Test the overall movement speed in ''blocks per second''.
*** {{nbt|double}}{{nbt|compound|horizontal_speed}}: Test the horizontal movement speed in ''blocks per second''. This tests the combined magnitude of the x and z velocities added together.
*** {{nbt|double}}{{nbt|compound|vertical_speed}}: Test the vertical movement speed in ''blocks per second''. This tests the absolute value of the {{code|y}} velocity.
*** {{nbt|double}}{{nbt|compound|fall_distance}}: Test the fall distance of the entity in blocks.
** {{nbt|int|periodic_tick}}: Tests that the age of the entity is divisible by the given positive integer. If the entity is loaded but not simulated, this check may be stuck as either passing or failing every tick until the entity gets close enough to a player again, so it should not be used for important delays.
** {{nbt|compound|predicates}}: Matches [[Minecraft:data component predicate]]s. For example, it can be used to check if an entity has any custom name, if a shulker has any color, or perform a partial check on the potion contents of an area effect cloud.
*** See [[Minecraft:data component predicate]].
** {{nbt|compound|type_specific}}: To test entity properties that can only be applied to certain entity types or groups of entity types.
*** {{nbt|string|type}}: Dictates which type-specific properties to test for.<p style="padding-block-end: 1em; margin: 0 0 0 0;">The possible values for {{nbt|string|type}} and associated extra contents:</p>
*** '''minecraft:fishing_hook''': Test properties unique to [[Minecraft:fishing bobber]] entities. Fails if the entity is not a fishing bobber.
**** {{nbt|boolean|in_open_water}}: Whether the fishing bobber was in [[Minecraft:Fishing#Junk_and_treasure|open water]].
*** '''minecraft:lightning''': Test properties unique to [[Minecraft:lightning bolt]] entities. Fails if the entity is not a lightning bolt.
**** {{nbt|int|}}{{nbt|compound|blocks_set_on_fire}}: Tests the number of blocks set on fire by this lightning bolt. Use an object with {{nbt|int|min}} and {{nbt|int|max}} to test for a range of values (inclusive).
**** {{nbt|compound|entity_struck}}: Test the properties of entities struck by this lightning bolt. Passes if at least one of the struck entities matches the entered conditions.
***** {{nbt inherit/conditions/entity}}
*** '''minecraft:player''': Tests properties unique to players. Fails if the entity is not a player.
**** {{nbt|compound|looking_at}}: Test properties of the entity that this player is looking at, as long as it is visible and within a radius of 100 blocks. Visibility is defined through the line from the player's eyes to the entity's eyes, rather than the direction that the player is looking in.
***** {{nbt inherit/conditions/entity}}
**** {{nbt|compound|advancements}}: To test the player's [[Minecraft:advancements]].
***** {{nbt|boolean|<advancement id>}}: Test whether an advancement is granted or not granted. Key is an advancement ID, value is <code>true</code> or <code>false</code> to test for granted/not granted respectively.
***** {{nbt|compound|<advancement id>}}: Test whether specific ''criteria'' of an advancement are marked as complete.
****** {{nbt|boolean|<criterion id>}}: Key is one of the criteria of the advancement, value is <code>true</code> or <code>false</code> to test for completed/not completed respectively.
**** {{nbt|list|gamemode}}: Test the [[Minecraft:game modes]] of this player. Any values in this list will match. Valid values are <code>survival</code>, <code>creative</code>, <code>adventure</code> and <code>spectator</code>.
**** {{nbt|int}}{{nbt|compound|level}}: Tests if experience level of this player. Use an object with {{nbt|int|min}} and {{nbt|int|max}} to test for a range of values (inclusive).
**** {{nbt|compound|recipes}}: To test if [[Minecraft:recipe]]s are known or unknown to this player.
***** {{nbt|boolean|<recipe id>}}: Key is the recipe ID; value is <code>true</code> or <code>false</code> to test for known/unknown respectively.
**** {{nbt|list|stats}}: To test this player's [[Minecraft:statistics]].
***** {{nbt|compound}} A statistic to test.
****** {{nbt|string|type}}: The statistic type. Valid values are <code>minecraft:custom</code>, <code>minecraft:crafted</code>, <code>minecraft:used</code>, <code>minecraft:broken</code>, <code>minecraft:mined</code>, <code>minecraft:killed</code>, <code>minecraft:picked_up</code>, <code>minecraft:dropped</code> and <code>minecraft:killed_by</code>.
****** {{nbt|string|stat}}: The statistic ID to test.
****** {{nbt|int}}{{nbt|compound|value}}: Tests the value of the statistic. Use an object with {{nbt|int|min}} and {{nbt|int|max}} to test for a range of values (inclusive).
**** {{nbt|compound|input}}: Test the inputs of this player.
***** {{nbt|boolean|forward}}: Tests whether the player is inputting Walk Forward.
***** {{nbt|boolean|backward}}: Tests whether the player is inputting Walk Backward.
***** {{nbt|boolean|left}}: Tests whether the player is inputting Strafe Left.
***** {{nbt|boolean|right}}: Tests whether the player is inputting Strafe Right.
***** {{nbt|boolean|jump}}: Tests whether the player is inputting Jump.
***** {{nbt|boolean|sneak}}: Tests whether the player is inputting Sneak.
***** {{nbt|boolean|sprint}}: Tests whether the player is inputting Sprint.
**** {{nbt|compound|food}}: Tests the food level and saturation of the player.
***** {{nbt|int}}{{nbt|compound|level}}: Tests the food level of the player. Use an object with {{nbt|int|min}} and {{nbt|int|max}} to test for a range of values (inclusive).
***** {{nbt|float}}{{nbt|compound|saturation}}: Tests the saturation of the player. Use an object with {{nbt|float|min}} and {{nbt|float|max}} to test for a range of values (inclusive).
*** '''minecraft:raider''' Test properties unique to [[Minecraft:Raid#Raiders|raiders]]. Fails if the entity is not a raider.
**** {{nbt|boolean|is_captain}}: Tests whether the raider is a captain.
**** {{nbt|boolean|has_raid}}: Tests whether the raider is part of a raid.
*** '''minecraft:sheep''' Test properties unique to [[Minecraft:sheep]]. Fails if the entity is not a sheep.
**** {{nbt|boolean|sheared}}: Whether the sheep has been sheared (<code>true</code>) or still has wool (<code>false</code>).
*** '''minecraft:slime'''{{until|JE 26.2}} '''minecraft:cube_mob'''{{upcoming|JE 26.2}} Test properties unique to [[Minecraft:slime]], [[Minecraft:magma cube]], and [[Minecraft:sulfur cube]]{{upcoming|JE 26.2}} entities. Fails if the entity is not a slime, magma cube, or sulfur cube.
**** {{nbt|int}}{{nbt|compound|size}}: Tests the size of the slime, magma cube, or sulfur cube, starting with 1 as the smallest size (always 1 more than the <code>Size</code> NBT tag). Use an object with {{nbt|int|min}} and {{nbt|int|max}} to test for a range of values (inclusive).
</onlyinclude></div><noinclude>
[[Category:Top-level data pages]]

[[Minecraft:fr:Progrès/Conditions/Entité]]
[[Minecraft:ja:進捗/条件/entity]]
[[Minecraft:ko:발전 과제/조건/개체]]
[[Minecraft:nl:Vooruitgangen/criteria/entiteit]]
[[Minecraft:pt:Progressos/Condições/entidade]]
[[Minecraft:ru:Достижение (Java Edition)/условия/сущность]]
[[Minecraft:th:ความก้าวหน้า/Conditions/entity]]
[[Minecraft:uk:Досягнення (Java Edition)/умова/сутність]]
[[Minecraft:zh:编码格式/CritereonPredicate#实体谓词]]
</noinclude>