diff --git a/paper-api/src/main/java/org/bukkit/entity/LivingEntity.java b/paper-api/src/main/java/org/bukkit/entity/LivingEntity.java index a5ea8f4457..88a9362761 100644 --- a/paper-api/src/main/java/org/bukkit/entity/LivingEntity.java +++ b/paper-api/src/main/java/org/bukkit/entity/LivingEntity.java @@ -443,6 +443,8 @@ public interface LivingEntity extends Attributable, Damageable, ProjectileSource /** * Sets whether an entity will have AI. * + * The entity will be completely unable to move if it has no AI. + * * @param ai whether the mob will have AI or not. */ void setAI(boolean ai); @@ -450,6 +452,8 @@ public interface LivingEntity extends Attributable, Damageable, ProjectileSource /** * Checks whether an entity has AI. * + * The entity will be completely unable to move if it has no AI. + * * @return true if the entity has AI, otherwise false. */ boolean hasAI(); diff --git a/paper-api/src/main/java/org/bukkit/entity/Mob.java b/paper-api/src/main/java/org/bukkit/entity/Mob.java index 838440ff8a..be9334a8b5 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Mob.java +++ b/paper-api/src/main/java/org/bukkit/entity/Mob.java @@ -25,4 +25,26 @@ public interface Mob extends LivingEntity, Lootable { */ @Nullable public LivingEntity getTarget(); + + /** + * Sets whether this mob is aware of its surroundings. + * + * Unaware mobs will still move if pushed, attacked, etc. but will not move + * or perform any actions on their own. Unaware mobs may also have other + * unspecified behaviours disabled, such as drowning. + * + * @param aware whether the mob is aware + */ + public void setAware(boolean aware); + + /** + * Gets whether this mob is aware of its surroundings. + * + * Unaware mobs will still move if pushed, attacked, etc. but will not move + * or perform any actions on their own. Unaware mobs may also have other + * unspecified behaviours disabled, such as drowning. + * + * @return whether the mob is aware + */ + public boolean isAware(); }