Struct BatEntity 

pub struct BatEntity {
    base: EntityBase,
    entity_type: EntityTypeRef,
    living_base: LivingEntityBase,
    mob_base: MobBase,
    entity_data: SyncMutex<BatEntityData>,
    target_position: SyncMutex<Option<BlockPos>>,
}

Vanilla bat entity.

Fields

base: EntityBase

entity_type: EntityTypeRef

living_base: LivingEntityBase

mob_base: MobBase

entity_data: SyncMutex<BatEntityData>

target_position: SyncMutex<Option<BlockPos>>

Implementations

impl BatEntity

pub(crate) const SPAWN_RULE: fn(EntityTypeRef, &dyn LevelReader, EntitySpawnReason, BlockPos, &mut dyn Rng) -> bool = Self::check_bat_spawn_rules

pub(crate) fn check_bat_spawn_rules( entity_type: EntityTypeRef, level: &dyn LevelReader, spawn_reason: EntitySpawnReason, pos: BlockPos, random: &mut dyn Rng, ) -> bool

Bats spawn below the world surface in dark places on bats_spawnable_on blocks.

pub fn new( entity_type: EntityTypeRef, id: i32, position: DVec3, world: Weak<World>, ) -> Self

Creates a new bat at runtime.

pub fn from_saved(entity_type: EntityTypeRef, load: EntityBaseLoad) -> Self

Reconstructs a bat from persisted base entity state.

fn new_with_base(base: EntityBase, entity_type: EntityTypeRef) -> Self

pub fn is_resting(&self) -> bool

Returns if the bat is resting.

pub fn set_resting(&self, resting: bool)

Sets if the bat is resting.

fn update_dirty_mob_effect_entity_data(&self)

fn tick_resting_ai(&self, world: &World, pos: BlockPos, above: BlockPos)

Ticks the AI while the bat is resting.

fn tick_flying_ai(&self, world: &World, above: BlockPos)

Ticks the AI while the bat is flying.

fn random_target_position(&self) -> BlockPos

Picks a random target block around the bat.

Trait Implementations

impl DefaultEntityPush for BatEntity

fn push_snapshot(&self, known_pushable: bool) -> Option<EntityPushSnapshot>

Push inputs for one contact, or None while riding. known_pushable skips the is_pushable check when the selector has already passed this entity.

impl DowncastType for BatEntity

const TYPE_KEY: DowncastTypeKey

The process-wide key for this concrete type.

impl Entity for BatEntity

fn is_hard_collision_relevant(&self) -> bool

Whether movement queries must consider this entity for hard collisions.

fn as_default_entity_push(&self) -> Option<&dyn DefaultEntityPush>

Opts this entity into the DefaultEntityPush fast path. It is read under the entity manager lock, so it must give the same answer for the entity’s whole lifetime and have no side effects.

fn base(&self) -> &EntityBase

Returns a reference to the entity’s shared vanilla base fields.

fn entity_type(&self) -> EntityTypeRef

Gets the entity type containing tracking range, dimensions, etc.

fn base_tick(&self)

Runs vanilla Entity.baseTick pieces Steel currently implements.

fn tick(self: Arc<Self>)

Called every game tick when the entity is in a ticked chunk.

fn dimensions_for_pose(&self, _pose: EntityPose) -> EntityDimensions

Returns vanilla dimensions for a physical pose.

fn synced_data(&self) -> Option<&dyn EntitySyncedData>

Returns the synchronized entity-data container for entities with vanilla data accessors.

fn update_data_before_sync(&self)

Updates synchronized entity data just before tracker sync.

fn max_up_step(&self) -> f32

Maximum height this entity can step up during normal movement.

fn is_pushable(&self) -> bool

Returns whether this entity participates in vanilla push separation.

fn is_ignoring_block_triggers(&self) -> bool

Returns whether this entity is excluded from pressure plates and tripwires.

fn movement_emission(&self) -> EntityMovementEmission

Returns vanilla movement side effects emitted by this entity.

fn check_fall_damage( self: Arc<Self>, _vertical_movement: f64, _on_ground: bool, _on_state: BlockStateId, _pos: BlockPos, _world: &Arc<World>, )

Accumulates fall distance, applies landing damage from the block fallen on, and resets it.

fn is_flapping(&self) -> bool

Returns whether the entity is currently flapping.

fn hurt(&self, world: &World, source: &DamageSource, amount: f32) -> bool

Applies damage to this entity.

fn save_additional(&self, nbt: &mut NbtCompound)

Saves type-specific entity data to NBT.

fn load_additional(&self, nbt: BorrowedNbtCompoundView<'_, '_>)

Loads type-specific entity data from NBT.

fn is_always_ticking(&self) -> bool

Returns whether this entity ignores chunk ticking visibility.

fn broadcast_to_player(&self, _player: &Player) -> bool

Returns whether this entity should be broadcast to the given player.

fn id(&self) -> i32

Gets the entity’s unique network ID (session-local).

fn generation(&self) -> EntityGeneration

Gets the generation counter of this runtime construction of the entity.

fn uuid(&self) -> Uuid

Gets the UUID of the entity (persistent identifier).

fn scoreboard_name(&self) -> String

Returns this entity’s vanilla scoreboard holder name.

fn name(&self) -> TextComponent

Returns this entity’s vanilla name component before team decoration.

fn display_name(&self) -> TextComponent

Returns this entity’s vanilla display name.

fn plain_text_name(&self) -> String

Returns this entity’s plain vanilla name.

fn nbt_for_data_compare(&self) -> NbtCompound

Returns the vanilla-shaped entity NBT used by command predicates.

fn nbt_for_passenger_save(&self) -> Option<NbtCompound>

Returns passenger-save NBT including the entity type id.

fn position(&self) -> DVec3

Gets the entity’s current position.

fn spawn_position(&self) -> DVec3

Gets the position to send in this entity’s add-entity packet.

fn block_position(&self) -> BlockPos

Gets the entity’s current block position.

fn in_block_state(&self, world: &World) -> BlockStateId

Returns the block state this entity’s origin currently overlaps.

fn old_position(&self) -> DVec3

Gets the entity position used by vanilla movement traces.

fn bounding_box(&self) -> WorldAabb

Gets the entity’s bounding box for collision queries.

fn is_free(&self, delta: DVec3) -> bool

Returns whether the bounding box shifted by delta is free of block collisions and liquids.

fn blocks_building(&self) -> bool

Returns whether this entity obstructs block placement.

fn is_pickable(&self) -> bool

Returns whether this entity can be targeted by picking and interaction raycasts.

fn attackable(&self) -> bool

Returns whether this entity can be attacked.

fn skip_attack_interaction(&self, _source: &SharedEntity) -> bool

Returns whether this entity handles and consumes an attack before normal damage.

fn is_pushed_by_fluid(&self) -> bool

Returns whether vanilla fluid currents can push this entity.

fn on_above_bubble_column(&self, drag_down: bool, pos: BlockPos)

Applies bubble-column surface push velocity, dispatching to the projectile override when this entity is a projectile.

fn default_on_above_bubble_column(&self, drag_down: bool, pos: BlockPos)

Applies the base entity’s clamped bubble-column surface movement.

fn on_inside_bubble_column(&self, drag_down: bool)

Applies bubble-column push velocity while submerged in the column, dispatching to the projectile override when this entity is a projectile.

fn default_on_inside_bubble_column(&self, drag_down: bool)

Applies the base entity’s clamped movement inside a bubble-column.

fn is_spectator(&self) -> bool

Returns whether this entity is invisible to normal entity selectors.

fn explosion_indirect_source(&self) -> Option<SharedEntity>

Returns the living entity credited as this explosion’s indirect source.

fn explosion_damage_origin(&self) -> DVec3

Returns the point used to calculate this entity’s explosion direction.

fn ignore_explosion(&self, _explosion: &dyn Explosion) -> bool

Returns whether this entity is wholly ignored by an explosion.

fn block_explosion_resistance( &self, explosion: &dyn Explosion, world: &World, pos: BlockPos, state: BlockStateId, fluid: FluidState, resistance: f32, ) -> f32

Lets an entity source modify effective block or fluid resistance.

fn should_block_explode( &self, explosion: &dyn Explosion, world: &World, pos: BlockPos, state: BlockStateId, power: f32, ) -> bool

Lets an entity source veto one affected block position.

fn on_explosion_hit(&self, _explosion_source: Option<&dyn Entity>)

Called after this entity is processed by an explosion.

fn piston_push_reaction(&self) -> PushReaction

Returns how vanilla lets this entity respond to piston movement.

fn is_supported_by(&self, pos: BlockPos) -> bool

Returns whether this entity’s main supporting block is pos.

fn can_interact_with_level(&self) -> bool

Returns whether vanilla lets this entity interact with its loaded level.

fn is_invisible(&self) -> bool

Returns whether this entity is invisible, per its synced entity data.

fn is_discrete(&self) -> bool

Returns whether this entity is sneaking (shift key down), per its synced entity data.

fn is_allied_to(&self, _other: &dyn Entity) -> bool

Returns whether this entity is allied to other.

fn is_marker_armor_stand(&self) -> bool

Returns whether this entity is a marker armor stand.

fn is_tame_owned_by(&self, _owner: &dyn LivingEntity) -> bool

Returns whether this entity is a tameable animal owned by owner.

fn projectile_owner_uuid(&self) -> Option<Uuid>

Returns the vanilla Projectile owner UUID when this entity exposes one.

fn projectile_owner(&self) -> Option<SharedEntity>

Returns the live vanilla Projectile owner when this entity exposes one.

fn is_flying_player(&self) -> bool

Returns true for vanilla players whose abilities have flying set.

fn can_be_collided_with(&self, _other: Option<&dyn Entity>) -> bool

Returns whether other can collide with this entity.

fn can_be_hit_by_projectile(&self) -> bool

Returns whether projectile collision may interact with this entity.

fn deflection(&self, _projectile: &dyn Projectile) -> ProjectileDeflection

Returns this entity’s Vanilla projectile deflection behavior.

fn vehicle(&self) -> Option<SharedEntity>

Gets the vehicle this entity is riding, if present.

fn controlled_vehicle(&self) -> Option<SharedEntity>

Returns the vehicle this entity directly controls, if any.

fn is_passenger(&self) -> bool

Returns whether this entity is riding another entity.

fn can_ride(&self, _vehicle: &dyn Entity) -> bool

Returns whether vanilla allows this entity to start riding vehicle.

fn stop_riding(&self)

Stops riding the current vehicle, if any.

fn eject_passengers(&self)

Dismounts every passenger from this entity.

fn start_riding(&self, entity_to_ride: &SharedEntity) -> bool

Starts riding entity_to_ride if vanilla boarding rules allow it.

fn passengers(&self) -> Vec<SharedEntity>

Gets this entity’s direct passengers.

fn count_player_passengers(&self) -> usize

Counts indirect player passengers.

fn has_exactly_one_player_passenger(&self) -> bool

Returns whether this entity has exactly one indirect player passenger.

fn first_passenger(&self) -> Option<SharedEntity>

Gets this entity’s first direct passenger.

fn controlling_passenger(&self) -> Option<SharedEntity>

Returns the living passenger currently controlling this entity, if any.

fn can_control_vehicle(&self) -> bool

Returns whether this entity can control a vehicle it is riding.

fn has_controlling_passenger(&self) -> bool

Returns whether this entity currently has a controlling passenger.

fn is_vehicle(&self) -> bool

Returns whether this entity has any direct passengers.

fn dismounts_underwater(&self) -> bool

Returns whether this entity’s passengers are forced to dismount when it goes underwater, per the dismounts_underwater entity type tag.

fn has_passenger(&self, passenger: &dyn Entity) -> bool

Returns whether passenger is a direct passenger of this entity.

fn can_add_passenger(&self, _passenger: &dyn Entity) -> bool

Returns whether this entity can accept passenger as a direct passenger.

fn could_accept_passenger(&self) -> bool

Returns whether this entity can accept any passenger.

fn passenger_index(&self, passenger: &dyn Entity) -> Option<usize>

Returns the current direct passenger index for attachment lookup.

fn vehicle_attachment_point(&self, _vehicle: &dyn Entity) -> DVec3

Returns this passenger’s vehicle attachment point.

fn default_passenger_attachment_point(&self, passenger: &dyn Entity) -> DVec3

Returns this vehicle’s passenger attachment point for this entity’s dimensions and seat index, rotated by the vehicle’s yaw.

fn passenger_attachment_point(&self, passenger: &dyn Entity) -> DVec3

Returns the vehicle-relative position where this passenger attaches to.

fn passenger_riding_position(&self, passenger: &dyn Entity) -> DVec3

Returns the world position where passenger should ride this vehicle.

fn position_rider(&self, passenger: &dyn Entity)

Repositions a direct passenger from this vehicle’s attachment point.

fn root_vehicle_id(&self) -> i32

Returns this entity’s root vehicle ID, or this entity’s ID when it is not riding.

fn root_vehicle(&self) -> Option<SharedEntity>

Returns this entity’s root vehicle, if this entity is riding one.

fn is_passenger_of_same_vehicle(&self, other: &dyn Entity) -> bool

Returns whether this entity and other share the same root vehicle.

fn has_indirect_passenger(&self, entity: &dyn Entity) -> bool

Returns whether entity is an indirect passenger of this entity.

fn can_collide_with(&self, other: &dyn Entity) -> bool

Returns whether this entity can collide with other.

fn push_impulse(&self, impulse: DVec3)

Adds an impulse to this entity’s velocity and marks velocity for sync.

fn push_entity(&self, entity: &dyn Entity)

Applies vanilla entity-to-entity push separation.

fn make_bounding_box_at(&self, position: DVec3) -> WorldAabb

Builds this entity’s default bounding box at position.

fn get_relative_portal_position( &self, axis: Axis, portal_area: FoundRectangle, ) -> DVec3

Returns this entity’s position relative to the portal, in portal-local space; living entities have their forward-axis offset reset to zero.

fn default_tick(&self)

Concrete entity ticks that mirror vanilla super.tick() should call this rather than calling Self::base_tick directly.

fn ride_tick(self: Arc<Self>)

Called every game tick while this entity is riding another entity.

fn default_ride_tick(self: Arc<Self>)

The default implementation of Entity.rideTick when not overridden.

fn handle_portal(&self)

Runs vanilla Entity.handlePortal behavior currently implemented by Steel.

fn entity_base_tick(&self)

Runs only vanilla Entity.baseTick behavior.

fn check_below_world(&self)

Applies vanilla below-world handling.

fn on_below_world(&self)

Runs entity-specific behavior after falling below the world.

fn check_despawn(&self)

Runs vanilla pre-tick despawn checks.

fn apply_inside_block_effect(&self, effect_type: InsideBlockEffectType)

Applies an inside-block effect queued by vanilla’s step-based collector.

fn level(&self) -> Option<Arc<World>>

Gets the world this entity is in.

fn pack_dirty_entity_data(&self) -> Option<Vec<DataValue>>

Packs dirty entity data for network synchronization.

fn pack_all_entity_data(&self) -> Vec<DataValue>

Packs all non-default entity data for initial spawn.

fn is_removed(&self) -> bool

Returns true if the entity has been marked for removal.

fn is_alive(&self) -> bool

Returns whether this entity is alive for vanilla generic entity checks.

fn begin_pending_world_change(&self) -> Option<PendingWorldChangeToken>

Marks this entity as waiting for a prepared world change.

fn finish_pending_world_change(&self, token: PendingWorldChangeToken) -> bool

Clears a pending world change if it still matches the provided token.

fn is_world_change_pending(&self) -> bool

Returns true while this entity is waiting for a prepared world change.

fn is_world_change_token_pending(&self, token: PendingWorldChangeToken) -> bool

Returns true if the given world-change token is still pending.

fn can_use_portal(&self, ignore_passenger: bool) -> bool

Returns whether this entity may enter a portal.

fn dimension_changing_delay(&self) -> i32

Returns vanilla’s dimension-changing portal cooldown delay in ticks.

fn removal_reason(&self) -> Option<RemovalReason>

Returns why this entity was removed, if it has been removed.

fn set_removed(&self, reason: RemovalReason)

Marks the entity as removed with the given reason.

fn game_event_with_source_entity( &self, event: GameEventRef, source_entity: Option<&dyn Entity>, )

Emits a vanilla game event from this entity’s exact position with an explicit source entity.

fn game_event(&self, event: GameEventRef)

Emits a vanilla game event from this entity’s exact position.

fn kill(&self, world: &World)

Kills this entity using vanilla’s living/non-living class split.

fn restore_owner_reference(&self, _owner: &SharedEntity)

Caches a live owner reference after restoring persisted owner-linked entities. Most entities do not store owner references.

fn on_teleported(&self)

Called after a teleport completes successfully.

fn set_level_callback(&self, callback: Arc<dyn EntityLevelCallback>)

Sets the level callback for lifecycle events (movement, removal).

fn notify_leash_holder(&self, _leashable: &dyn Entity)

Called by leashables while this entity is their live leash holder.

fn notify_leashee_removed(&self, _leashable: &dyn Entity)

Called when a leashable stops using this entity as its live leash holder.

fn player_touch(self: Arc<Self>, _player: &Arc<Player>)

Called when a player touches this entity during nearby pickup processing.

fn leashables_leashed_to(&self) -> Vec<SharedEntity>

Finds leashable mobs in vanilla’s nearby leash scan whose holder is this entity.

fn leashables_leashed_to_holder_in_area( &self, holder: &dyn Entity, ) -> Vec<SharedEntity>

Finds leashable mobs in this entity’s nearby leash scan whose holder is holder.

fn transfer_leashables_from_holder(&self, old_holder: &dyn Entity) -> bool

Transfers leashables currently held by old_holder to this entity.

fn drop_all_leash_connections(&self, player: Option<&Player>) -> bool

Drops this entity’s leash and all leashables attached to it.

fn shear_off_all_leash_connections(&self, player: Option<&Player>) -> bool

Shears off all leash connections reachable from this entity.

fn attempt_to_shear_equipment( &self, player: &Player, hand: InteractionHand, ) -> bool

Shears the first shearable equipped item on this mob, spawning it as a dropped item and playing its shearing sound; returns whether anything was sheared.

fn interact( &self, player: &Player, hand: InteractionHand, location: DVec3, ) -> InteractionResult

Handles vanilla entity right-click interaction.

fn interact_entity( &self, player: &Player, hand: InteractionHand, _location: DVec3, ) -> InteractionResult

Shared right-click interaction for mobs: leashing/unleashing, cutting leash connections, or shearing equipment with shears.

fn is_living_entity(&self) -> bool

Returns true for entities that implement vanilla living-entity behavior.

fn is_abstract_arrow(&self) -> bool

Returns whether this entity belongs to vanilla’s AbstractArrow hierarchy.

fn as_projectile(&self) -> Option<&dyn Projectile>

Returns this entity as a projectile when it has projectile behavior.

fn as_living_entity(&self) -> Option<&dyn LivingEntity>

Returns this entity as a living entity when it has living behavior.

fn as_item_frame(&self) -> Option<&dyn ItemFrame>

Returns this entity as an item frame when it has item-frame behavior.

fn as_player(&self) -> Option<&Player>

Returns this entity as a player when it is the concrete server player.

fn with_weapon_item(&self, visitor: &mut dyn FnMut(Option<&ItemStack>))

Visits vanilla Entity.getWeaponItem without copying inventory state.

fn is_pathfinder_mob(&self) -> bool

Returns true for mobs with pathfinding navigation.

fn as_pathfinder_mob(&self) -> Option<&dyn PathfinderMob>

Returns this entity as a pathfinder mob when it has pathfinding behavior.

fn is_mob(&self) -> bool

Returns true for entities that implement vanilla mob behavior.

fn as_mob(&self) -> Option<&dyn Mob>

Returns this entity as a mob when it has mob behavior.

fn as_leashable(&self) -> Option<&dyn Leashable>

Returns this entity as a Leashable if it has Leashable behavior.

fn as_abstract_minecart(&self) -> Option<&dyn AbstractMinecart>

Returns this entity as an AbstractMinecart if it has AbstractMinecart behavior.

fn is_animal(&self) -> bool

Returns true for entities that implement vanilla animal behavior.

fn as_animal(&self) -> Option<&dyn Animal>

Returns this entity as an animal when it has animal behavior.

fn is_monster(&self) -> bool

Returns true for entities that implement vanilla hostile-mob behavior.

fn as_monster(&self) -> Option<&dyn Monster>

Returns the Monster capability, equivalent to vanilla’s instanceof Monster.

fn is_enemy(&self) -> bool

Whether this entity implements the Enemy marker.

fn as_enemy(&self) -> Option<&dyn Enemy>

Returns the Enemy marker, equivalent to vanilla’s instanceof Enemy.

fn is_ageable_mob(&self) -> bool

Returns true for entities that implement vanilla ageable-mob behavior.

fn as_ageable_mob(&self) -> Option<&dyn AgeableMob>

Returns this entity as an ageable mob when it has ageable behavior.

fn is_item_steerable(&self) -> bool

Returns true for entities that implement vanilla item-steered boosts.

fn as_item_steerable(&self) -> Option<&dyn ItemSteerable>

Returns this entity as item steerable when it has item-steering behavior.

fn forces_fall_flying_velocity_sync(&self) -> bool

Returns whether this entity’s velocity should sync every tick because it’s currently fall-flying with an elytra.

fn uses_client_movement_packets(&self) -> bool

Returns true when movement is driven by serverbound movement packets.

fn is_server_driven_movement(&self) -> bool

Returns true when normal server ticks drive this entity’s movement.

fn can_simulate_movement(&self) -> bool

Returns true when vanilla allows this side to apply movement simulation side effects.

fn is_effective_ai(&self) -> bool

Returns true when vanilla allows this side to run entity AI/travel logic.

fn is_suppressing_bounce(&self) -> bool

Returns true when vanilla landing bounce should be suppressed.

fn is_stepping_carefully(&self) -> bool

Returns true when vanilla block step-on hooks should treat this entity as careful.

fn is_descending(&self) -> bool

Returns true when vanilla collision context should treat the entity as descending.

fn set_shared_shift_key_down(&self, shift_key_down: bool)

Sets the vanilla shift-key-down shared flag.

fn set_shared_swimming(&self, swimming: bool)

Sets the vanilla swimming shared flag.

fn update_swimming(&self)

Updates the vanilla swimming shared flag.

fn default_update_swimming(&self)

Shared body of vanilla Entity.updateSwimming for player overrides.

fn set_shared_sprinting(&self, sprinting: bool)

Sets the vanilla sprinting shared flag.

fn set_shared_fall_flying(&self, fall_flying: bool)

Sets the vanilla fall-flying shared flag.

fn is_flying_vehicle(&self) -> bool

Returns whether vanilla excludes this vehicle from floating kicks.

fn on_climbable(&self) -> bool

Returns true if vanilla rules consider this entity to be on a climbable block.

fn default_known_movement(&self) -> DVec3

Returns vanilla’s base known movement before entity-specific adjustments.

fn known_movement(&self) -> DVec3

Returns the movement vector vanilla exposes for block-contact logic.

fn known_speed(&self) -> DVec3

Returns the base-tick displacement vanilla exposes as getKnownSpeed.

fn tick_count(&self) -> i32

Returns the number of ticks this entity has existed for.

fn is_first_tick(&self) -> bool

Returns whether this entity has not completed its first tick.

fn set_first_tick(&self, first_tick: bool)

Sets whether this entity has not completed its first tick.

fn advance_tick_count(&self)

Advances this entity’s tick counter by one.

fn fall_sounds(&self) -> (SoundEventRef, SoundEventRef)

Returns vanilla small and big fall sounds for this entity.

fn rotation(&self) -> (f32, f32)

Gets the entity’s rotation as (yaw, pitch) in degrees.

fn set_rotation(&self, rotation: (f32, f32))

Sets the entity’s rotation as (yaw, pitch) in degrees.

fn direction_yaw(&self) -> Direction

Gets the nearest horizontal direction to the entity’s yaw (horizontal rotation).

fn motion_direction(&self) -> Direction

Returns the horizontal direction used for movement-dependent behavior.

fn look_at(&self, from_anchor: EntityAnchor, target: DVec3)

Rotates this entity to face a fixed position.

fn look_at_entity( &self, from_anchor: EntityAnchor, target: &dyn Entity, target_anchor: EntityAnchor, )

Rotates this entity to follow an anchored point on another entity.

fn head_yaw(&self) -> f32

Returns this entity’s head yaw; 0.0 for non-living entities.

fn spawn_data(&self) -> i32

Extra spawn-packet data used by vanilla for entity-specific construction.

fn get_eye_height(&self) -> f64

Gets the eye height for this entity.

fn get_fluid_jump_threshold(&self) -> f64

Returns the fluid-surface height threshold used for fluid-jump physics: 0.0 for entities with eye height under 0.4, otherwise 0.4.

fn get_eye_y(&self) -> f64

Gets the Y coordinate of the entity’s eyes.

fn is_in_wall(&self) -> bool

Returns whether the entity is currently suffocating inside a solid block.

fn calculate_view_vector(&self, pitch_degrees: f32, yaw_degrees: f32) -> DVec3

Computes a unit look-direction vector from the given pitch and yaw in degrees.

fn look_angle(&self) -> DVec3

Returns this entity’s current unit look-direction vector.

fn hand_holding_item_angle(&self, item: ItemRef) -> DVec3

Returns the vanilla offset for the hand holding item.

fn velocity(&self) -> DVec3

Gets the entity’s velocity in blocks per tick.

fn set_velocity(&self, velocity: DVec3)

Sets the entity’s velocity.

fn needs_velocity_sync(&self) -> bool

Returns whether this entity’s velocity has changed enough to need syncing to clients.

fn mark_velocity_sync(&self)

Marks this entity’s velocity as needing to be synced to clients.

fn clear_velocity_sync(&self)

Clears the vanilla velocity sync marker after send processing.

fn hurt_marked(&self) -> bool

Returns true when vanilla hurt-marked velocity sync is pending.

fn mark_hurt(&self)

Marks this entity as hurt for vanilla self-inclusive motion sync.

fn clear_hurt_mark(&self)

Clears the vanilla hurt-marked motion sync flag.

fn fall_distance(&self) -> f64

Returns accumulated vanilla fall distance.

fn is_in_powder_snow(&self) -> bool

Returns whether this entity is currently inside powder snow.

fn was_in_powder_snow(&self) -> bool

Returns whether this entity was inside powder snow during the previous base tick.

fn set_fall_distance(&self, fall_distance: f64)

Sets accumulated vanilla fall distance.

fn reset_fall_distance(&self)

Resets accumulated vanilla fall distance.

fn check_fall_distance_accumulation(&self)

Caps the accumulated fall distance at 1 once the entity is no longer falling faster than 0.5 blocks per tick.

fn fire_freeze_state(&self) -> EntityFireFreezeState

Returns the current vanilla fire/freeze state.

fn remaining_fire_ticks(&self) -> i32

Returns the ticks remaining before this entity stops burning.

fn set_remaining_fire_ticks(&self, remaining_fire_ticks: i32)

Sets the ticks remaining before this entity stops burning, clamped to this entity’s fire-ticks cap if any.

fn ticks_frozen(&self) -> i32

Returns ticks this entity has spent freezing in powder snow.

fn set_ticks_frozen(&self, ticks_frozen: i32)

Sets ticks this entity has spent freezing in powder snow, syncing the change to clients.

fn fire_immune(&self) -> bool

Returns whether this entity is immune to fire effects and fire damage.

fn fire_immune_ticks(&self) -> i32

Returns vanilla fire immunity cooldown ticks after not being ignited.

fn should_play_lava_hurt_sound(&self) -> bool

Returns whether vanilla should play this entity’s lava hurt sound.

fn lava_ignite(&self)

Ignites this entity in lava.

fn lava_hurt(&self)

Applies vanilla lava-contact damage after lava ignition effects.

fn remaining_fire_ticks_cap(&self) -> Option<i32>

Maximum ticks this entity’s remaining-fire timer can hold; None means unlimited.

fn fire_ignite_extra_ticks(&self) -> i32

Returns extra ticks added by fire-block ignition before 8-second ignition.

fn is_on_fire(&self) -> bool

Returns whether the entity is on fire on the server.

fn has_visual_fire(&self) -> bool

Returns whether this entity currently renders as visually on fire.

fn is_freezing(&self) -> bool

Returns whether the entity has any frozen ticks.

fn default_can_freeze(&self) -> bool

Returns vanilla Entity.canFreeze() without living-equipment overrides.

fn can_freeze(&self) -> bool

Returns whether this entity may accumulate frozen ticks.

fn ticks_required_to_freeze(&self) -> i32

Returns the ticks of powder-snow exposure required before this entity starts taking freeze damage.

fn is_fully_frozen(&self) -> bool

Returns whether this entity has reached full-freeze duration.

fn percent_frozen(&self) -> f32

Returns how frozen this entity is, from 0.0 to 1.0, based on ticks frozen versus ticks required.

fn clear_freeze(&self)

Clears accumulated freezing.

fn clear_fire(&self)

Clears fire without resetting the vanilla fire immunity cooldown.

fn extinguish_fire(&self)

Plays the extinguish sound when currently on fire, then clears fire.

fn ignite_for_ticks(&self, number_of_ticks: i32)

Ignites this entity for a vanilla tick duration.

fn sync_base_fire_freeze_entity_data(&self)

Projects base fire/freeze state into generated synced entity data.

fn sync_base_entity_data(&self)

Projects all base-owned synchronized fields into generated entity data.

fn is_in_water(&self) -> bool

Returns true if this entity is currently touching water.

fn is_in_rain(&self) -> bool

Returns true if rain falls at this entity’s feet or at the top of its bounding box.

fn is_in_water_or_rain(&self) -> bool

Returns true if this entity is touching water or standing in rain.

fn is_in_lava(&self) -> bool

Returns true if this entity is currently touching lava.

fn is_eye_in_water(&self) -> bool

Returns true if this entity’s eyes are currently inside water.

fn is_eye_in_lava(&self) -> bool

Returns true if this entity’s eyes are currently inside lava.

fn is_under_water(&self) -> bool

Returns vanilla underwater state.

fn fluid_contact(&self) -> EntityFluidContact

Returns cached fluid contact from the last entity fluid refresh.

fn refresh_fluid_contact(&self) -> EntityFluidContact

Refreshes cached fluid contact from this entity’s current bounding box.

fn update_fluid_interaction(&self) -> bool

Runs vanilla Entity.updateFluidInteraction: refreshes cached contact, emits the water-entry splash on transition, resets fall distance in water, and applies fluid currents.

fn scan_and_store_fluid_contact( &self, advance_eye_water_history: bool, ) -> EntityFluidContact

Scans current fluid contact and stores it on the entity base.

fn apply_fluid_current_impulses( &self, world: &Arc<World>, contact: EntityFluidContact, )

Applies vanilla water/lava current impulses from a fluid interaction update.

fn apply_fluid_current_impulse(&self, impulse: DVec3)

Applies a non-zero fluid current impulse and marks velocity sync.

fn is_fall_damage_immune(&self) -> bool

Returns true if this entity type ignores vanilla fall damage.

fn propagate_fall_to_passengers( &self, fall_distance: f64, damage_modifier: f32, source: &DamageSource, )

Propagates vanilla fall-damage handling to passengers.

fn cause_fall_damage( self: Arc<Self>, fall_distance: f64, damage_modifier: f32, source: &DamageSource, ) -> bool

Applies vanilla fall damage.

fn on_ground(&self) -> bool

Returns true if the entity is on the ground.

fn horizontal_collision(&self) -> bool

Returns true if the last movement was clipped horizontally.

fn vertical_collision(&self) -> bool

Returns true if the last movement was clipped vertically.

fn vertical_collision_below(&self) -> bool

Returns true if the last vertical collision was below the entity.

fn no_physics(&self) -> bool

Returns true when movement bypasses collision physics.

fn is_affected_by_blocks(&self) -> bool

Returns true when vanilla block-contact effects may run for this entity.

fn set_no_physics(&self, no_physics: bool)

Sets whether this entity bypasses collision physics.

fn update_no_physics_from_current_collision(&self)

Updates item-style noPhysics from the entity’s current collision state.

fn move_towards_closest_space(&self, x: f64, y: f64, z: f64)

Nudges velocity toward the closest non-full collision block.

fn default_make_stuck_in_block( &self, _state: BlockStateId, speed_multiplier: DVec3, )

Default vanilla stuck-in-block movement for the next movement pass.

fn make_stuck_in_block(&self, state: BlockStateId, speed_multiplier: DVec3)

Applies vanilla stuck-in-block movement for the next movement pass.

fn apply_effects_from_blocks(&self)

Applies current block-contact effects to this entity.

fn apply_effects_from_blocks_between(&self, from: DVec3, to: DVec3)

Applies block-contact effects for one explicit movement segment.

fn apply_effects_from_blocks_for_last_movements(&self)

Replays the last finalized block-contact movement list.

fn land_after_teleport(&self)

What vanilla’s /teleport does once an entity has moved: unless it is gliding, it ends up on the ground without vertical motion.

fn set_on_ground(&self, on_ground: bool)

Sets whether the entity is on the ground.

fn set_on_ground_with_movement( &self, on_ground: bool, horizontal_collision: bool, movement: DVec3, )

Sets ground and horizontal collision flags from accepted movement.

fn default_apply_accepted_client_movement( self: Arc<Self>, world: &Arc<World>, accepted: AcceptedClientMovement, ) -> Result<AcceptedClientMovementOutcome, EntityMoveError>

Default final state application for accepted client-authored movement.

fn apply_accepted_client_movement( self: Arc<Self>, world: &Arc<World>, accepted: AcceptedClientMovement, ) -> Result<AcceptedClientMovementOutcome, EntityMoveError>

Applies final state accepted from a client-authored movement packet.

fn apply_accepted_client_vehicle_movement( self: Arc<Self>, world: &Arc<World>, accepted: AcceptedClientMovement, ) -> Result<AcceptedClientMovementOutcome, EntityMoveError>

Applies final state accepted from a controlled-vehicle movement packet.

fn try_set_position(&self, pos: DVec3) -> Result<(), EntityMoveError>

Attempts to set the entity’s position through world lifecycle validation.

fn try_set_position_base(&self, pos: DVec3) -> Result<(), EntityMoveError>

The base method to set the entity’s position through world lifecycle validation.

fn teleport_to(&self, pos: DVec3) -> Result<(), EntityMoveError>

Moves this entity to pos, keeping its current rotation.

fn set_old_position_to_current(&self)

Sets the vanilla movement-trace old position to the current position.

fn set_old_position(&self, old_position: DVec3)

Sets the vanilla movement-trace old position explicitly.

fn remove_latest_movement_recording(&self)

Removes the latest movement segment recorded this tick.

fn on_pos(&self, offset: f32) -> Option<BlockPos>

Returns the block position this entity is standing on.

fn block_pos_below_that_affects_movement(&self) -> Option<BlockPos>

Returns the block position used for movement-affecting block properties.

fn on_pos_legacy(&self) -> Option<BlockPos>

Returns vanilla getOnPosLegacy(), used by fall/step block hooks.

fn default_block_speed_factor(&self) -> f32

Returns the vanilla block speed factor applied after movement.

fn block_speed_factor(&self) -> f32

Returns the block speed factor applied after movement.

fn block_jump_factor(&self) -> f32

Returns the jump-height multiplier from the block at this entity’s position, falling back to the block below when the current one doesn’t modify jumps.

fn pose(&self) -> EntityPose

Returns this entity’s physical pose.

fn refresh_dimensions(&self)

Refreshes dimensions for the current physical pose.

fn fudge_position_after_size_change( &self, previous_dimensions: EntityDimensions, ) -> bool

Moves the entity to the closest free position for its new dimensions within the previous dimensions’ footprint, returning whether a valid position was found. Vanilla runs this after growing in a confined space; Steel’s ThrownEgg hatchlings also use it to fit a newborn chick at the egg’s impact point.

fn set_pose(&self, pose: EntityPose)

Sets the physical pose and synchronized pose metadata.

fn is_crouching(&self) -> bool

Returns whether vanilla currently considers this entity crouching.

fn is_swimming(&self) -> bool

Returns whether vanilla currently considers this entity swimming.

fn is_on_rails(&self) -> bool

Returns whether this entity is on rails.

fn is_state_climbable(&self, state: BlockStateId) -> bool

Returns whether a block state is climbable for base movement effects.

fn may_interact(&self, _world: &World, _pos: BlockPos) -> bool

Returns whether this entity may modify the world at a position.

fn air_supply(&self) -> i32

Returns this entity’s current air supply in ticks, synced to clients.

fn set_air_supply(&self, air_supply: i32)

Sets this entity’s air supply in ticks, syncing the change to clients.

fn max_air_supply(&self) -> i32

Returns this entity’s maximum vanilla air supply.

fn portal_cooldown(&self) -> i32

Returns the vanilla portal cooldown in ticks.

fn set_portal_cooldown(&self, portal_cooldown: i32)

Sets the vanilla portal cooldown in ticks.

fn is_on_portal_cooldown(&self) -> bool

Returns whether the entity is on vanilla portal cooldown.

fn reset_portal_cooldown(&self)

Resets vanilla portal cooldown to this entity’s dimension-changing delay.

fn set_as_inside_portal(&self, portal: PortalKind, entry_position: BlockPos)

Marks this entity as inside a vanilla portal during the current tick.

fn custom_name(&self) -> Option<TextComponent>

Returns this entity’s optional vanilla custom name.

fn set_custom_name(&self, custom_name: Option<TextComponent>)

Sets this entity’s optional vanilla custom name.

fn is_custom_name_visible(&self) -> bool

Returns whether vanilla renders this entity’s custom name.

fn set_custom_name_visible(&self, visible: bool)

Sets whether vanilla renders this entity’s custom name.

fn has_glowing_tag(&self) -> bool

Returns whether this entity has the server-owned vanilla glowing tag.

fn set_glowing_tag(&self, glowing: bool)

Sets this entity’s server-owned vanilla glowing tag.

fn tags(&self) -> Vec<String>

Returns a snapshot of this entity’s vanilla scoreboard tags.

fn add_tag(&self, tag: String) -> bool

Adds a vanilla scoreboard tag.

fn remove_tag(&self, tag: &str) -> bool

Removes a vanilla scoreboard tag.

fn custom_data(&self) -> NbtCompound

Returns a snapshot of this entity’s vanilla custom data.

fn set_custom_data(&self, custom_data: NbtCompound)

Replaces this entity’s vanilla custom data.

fn sound_source(&self) -> SoundSource

Returns this entity’s vanilla sound source category.

fn swim_sound(&self) -> SoundEventRef

Returns this entity’s vanilla swim sound.

fn is_silent(&self) -> bool

Returns whether sounds from this entity are suppressed.

fn set_silent(&self, silent: bool)

Sets whether sounds from this entity are suppressed.

fn broadcast_entity_event(&self, event: EntityStatus)

Broadcasts a vanilla entity event/status packet near this entity.

fn play_sound(&self, sound: SoundEventRef, volume: f32, pitch: f32)

Plays an entity sound at the entity’s exact position.

fn swim_splash_sound(&self) -> SoundEventRef

Returns the sound played when this entity enters water at low speed.

fn swim_high_speed_splash_sound(&self) -> SoundEventRef

Returns the sound played when this entity enters water at high speed.

fn do_water_splash_effect(&self)

Plays the vanilla water-entry splash sound and emits SPLASH.

fn default_do_water_splash_effect(&self)

The default implementation of Entity.doWaterSplashEffect when not overridden.

fn play_entity_on_fire_extinguished_sound(&self)

Plays vanilla’s extinguished-on-fire entity sound.

fn play_step_sound(&self, _pos: BlockPos, block_state: BlockStateId)

Plays the base vanilla step sound for a block.

fn play_block_step_sound(&self, block_state: BlockStateId)

Plays a vanilla block step sound at this entity’s current position.

fn play_muffled_step_sound(&self, block_state: BlockStateId)

Plays vanilla’s muffled secondary step sound.

fn play_combination_step_sounds( &self, primary_step_sound: BlockStateId, secondary_step_sound: BlockStateId, )

Plays vanilla’s combination primary and secondary step sounds.

fn walking_step_sound(&self, pos: BlockPos, block_state: BlockStateId)

Plays vanilla walking step sounds, including amethyst chimes.

fn play_amethyst_step_sound(&self)

Plays vanilla amethyst step chime when its cooldown permits it.

fn water_swim_sound(&self)

Plays vanilla swim sound from movement emission.

fn play_swim_sound(&self, volume: f32)

Plays this entity’s swim sound at the given volume.

fn on_flap(&self)

Runs entity-specific flap side effects.

fn process_flapping_movement(&self)

Processes vanilla flap movement side effects.

fn next_step(&self) -> f32

Returns the next step threshold after movement side effects are produced.

fn apply_movement_emission_and_play_sound( &self, emission: EntityMovementEmission, clipped_movement: DVec3, effect_pos: BlockPos, effect_state: BlockStateId, )

Applies vanilla movement sounds and game events after a completed move.

fn apply_movement_side_effects_after_move( &self, world: &World, actual_movement: DVec3, )

Applies movement side effects after vanilla collision and landing updates.

fn vibration_and_sound_effects_from_block( &self, pos: BlockPos, block_state: BlockStateId, should_sound: bool, should_vibrate: bool, clipped_movement: DVec3, ) -> bool

Emits step side effects from a candidate movement-effect block.

fn backs_off_from_edge(&self) -> bool

Whether movement should apply player-style sneak edge prevention.

fn get_default_gravity(&self) -> f64

Gets the default gravity for this entity type.

fn is_no_gravity(&self) -> bool

Returns true if gravity is disabled for this entity.

fn set_no_gravity(&self, no_gravity: bool)

Sets whether this entity ignores gravity, syncing the change to clients.

fn is_invulnerable(&self) -> bool

Returns whether this entity is invulnerable to non-bypassing damage.

fn set_invulnerable(&self, invulnerable: bool)

Sets whether this entity is invulnerable to non-bypassing damage.

fn get_gravity(&self) -> f64

Gets the current gravity value.

fn get_air_drag(&self) -> f64

get the air drag value of the entity

fn apply_gravity(&self)

Applies gravity to the entity’s velocity.

fn move_relative(&self, speed: f32, input: DVec3)

Adds input scaled by speed, rotated to face this entity’s current yaw, to its velocity.

fn move_without_physics(&self, delta: DVec3) -> Option<MoveResult>

Moves the entity without collision physics.

fn default_move_entity( self: Arc<Self>, mover_type: MoverType, delta: DVec3, ) -> Option<MoveResult>

Moves the entity with collision detection.

fn move_entity( self: Arc<Self>, mover_type: MoverType, delta: DVec3, ) -> Option<MoveResult>

Moves the entity with collision detection.

fn apply_fall_damage_after_move( self: Arc<Self>, result: &MoveResult, world: &Arc<World>, ) -> bool

Applies vanilla fall-distance bookkeeping after accepted movement.

fn reset_fall_distance_on_resetting_clip( &self, world: &Arc<World>, movement: DVec3, )

Resets fall distance when vanilla’s fall-damage-resetting clip hits.

fn do_check_fall_damage( self: Arc<Self>, movement: DVec3, on_ground: bool, world: &Arc<World>, ) -> bool

Applies fall damage from the block fallen on, then returns whether the entity was removed (e.g. killed) as a result.

fn refresh_supporting_block_for_fall_damage( &self, movement: DVec3, on_ground: bool, )

Refreshes vanilla supporting-block state before fall-damage side effects.

fn send_landing_particles( &self, world: &World, on_state: BlockStateId, pos: BlockPos, )

Sends the vanilla landing burst for living entities with enough fall power.

fn ground_contact_after_movement( &self, on_ground: bool, movement: Option<DVec3>, ) -> EntityGroundContact

Computes vanilla support state for an on-ground update.

fn check_supporting_block( &self, on_ground: bool, movement: Option<DVec3>, world: &Arc<World>, ) -> EntityGroundContact

Determines the supporting block state and position underneath the entity while grounded.

fn spawn_at_location( &self, item: ItemStack, y_offset: f64, ) -> Option<Arc<ItemEntity>>

Spawns an item at this entity’s location.

fn spawn_at_location_with_offset( &self, item: ItemStack, offset: DVec3, ) -> Option<Arc<ItemEntity>>

Spawns an item at this entity’s location plus a vanilla attachment offset.

fn apply_implicit_item_components(&self, _item_stack: &ItemStack)

Applies entity-specific implicit components carried by an item stack.

fn apply_spawn_data(&self, nbt: BorrowedNbtCompoundView<'_, '_>)

Spawn-item data is merged into the entity’s current save state before it is loaded. Keeping that merge at the entity boundary preserves defaults and entity-specific state when the component only overrides one field.

fn is_invulnerable_to_base(&self, source: &DamageSource) -> bool

Returns whether this entity is immune to damage from source: already removed, or invulnerable and the source doesn’t bypass invulnerability.

fn distance_to_sqr(&self, pos: DVec3) -> f64

Calculates the squared Euclidean distance from this entity’s position to the given position.

fn snap_to(&self, position: DVec3, yaw: f32, pitch: f32)

Sets position and rotation.

fn killed_entity( &self, _world: &World, _entity: &dyn LivingEntity, _source: &DamageSource, ) -> bool

Runs when this entity causes another entity to die. The entity provided is the entity who was killed.

fn award_kill_score(&self, _victim: &dyn Entity, _killing_blow: &DamageSource)

Runs when this entity kills another entity.

impl LivingEntity for BatEntity

fn living_base(&self) -> &LivingEntityBase

Returns a reference to the shared LivingEntityBase that holds living runtime state such as attributes, cached movement speed, damage cooldown, and death animation counters.

fn get_health(&self) -> f32

Gets the current health of the entity.

fn set_health(&self, health: f32)

Sets the health of the entity, clamped between 0 and max health.

fn sound_volume(&self) -> f32

Returns the volume used for this entity’s sounds.

fn voice_pitch(&self) -> f32

Returns the pitch used for this entity’s sounds; babies get a randomized higher pitch.

fn hurt_sound(&self, _source: &DamageSource) -> Option<SoundEventRef>

Returns the sound played when this entity is hurt.

fn death_sound(&self) -> Option<SoundEventRef>

Returns the sound played when this entity dies.

fn push_entities(&self)

Pushes nearby colliding entities away from this one.

fn server_ai_step(&self, entity: &SharedEntity)

Server AI hook called from vanilla LivingEntity.aiStep().

fn ai_step(&self, entity: &SharedEntity) -> Option<MoveResult>

Runs one AI-driven movement and effect tick for the entity.

fn living_rotation_state(&self) -> LivingRotationState

Returns vanilla living body/head rotation state.

fn y_body_rot(&self) -> f32

Returns the entity’s body yaw, used for turning smoothing separate from head yaw.

fn set_y_body_rot(&self, y_body_rot: f32)

Sets the entity’s body yaw.

fn y_head_rot(&self) -> f32

Returns the entity’s head yaw.

fn set_y_head_rot(&self, y_head_rot: f32)

Sets the entity’s head yaw.

fn advance_living_rotation_for_base_tick(&self)

Copies current living body/head rotations to vanilla old-rotation state.

fn base_tick_living_entity(&self)

Runs the shared per-tick living-entity behavior: rotation/animation snapshots, base entity tick, environmental damage, the hurt timer, and combat memory expiry. Memory must expire before mob effects tick, so a lethal effect tick sees the same kill credit as vanilla.

fn living_swing_state(&self) -> LivingSwingState

Returns vanilla arm-swing animation state.

fn modified_swing_duration(&self, animation: SwingAnimation) -> i32

Returns the animation duration adjusted by Haste or Mining Fatigue.

fn attack_animation(&self, hand: InteractionHand) -> SwingAnimation

Returns the held item’s attack animation.

fn interact_animation(&self, hand: InteractionHand) -> SwingAnimation

Returns the held item’s interaction animation.

fn held_swing_animation( &self, hand: InteractionHand, component: DataComponentType<SwingAnimation>, ) -> SwingAnimation

Reads a swing animation component off the item held in hand, falling back to the vanilla default when the item does not carry one.

fn swing( &self, hand: InteractionHand, animation: SwingAnimation, update_self: bool, ) -> bool

Sends the animation to tracking players and returns whether a swing started

fn swing_for_attack(&self, hand: InteractionHand)

Swings with the held item’s attack animation.

fn attributes(&self) -> &SyncMutex<AttributeMap>

Returns a reference to this entity’s attribute map.

fn get_luck(&self) -> f32

Vanilla LivingEntity.getLuck - non-players contribute no luck to loot.

fn pack_syncable_attributes(&self) -> Vec<AttributeSnapshot>

Packs syncable attributes for initial spawn pairing.

fn drain_dirty_syncable_attributes(&self) -> Vec<AttributeSnapshot>

Drains syncable dirty attributes for per-tick tracking updates.

fn drain_dirty_mob_effects(&self) -> Vec<MobEffectSyncChange>

Drains dirty mob-effect packet changes for vanilla recipients.

fn pack_all_equipment(&self) -> Vec<EquipmentSlotItem>

Packs non-empty equipment slots for initial spawn pairing.

fn drain_dirty_equipment(&self) -> Vec<EquipmentSlotItem>

Drains equipment slots that changed since the last tracker sync.

fn save_equipment(&self, nbt: &mut NbtCompound)

Saves equipment slots to NBT.

fn load_equipment(&self, nbt: BorrowedNbtCompoundView<'_, '_>)

Loads equipment slots from NBT.

fn save_command_nbt(&self, nbt: &mut NbtCompound)

Appends vanilla-shaped living state used by command NBT predicates.

fn get_max_health(&self) -> f32

Gets the maximum health from the attribute system.

fn no_action_time(&self) -> i32

Returns ticks this entity has gone without taking a noteworthy action.

fn set_no_action_time(&self, no_action_time: i32)

Sets ticks this entity has gone without taking a noteworthy action.

fn increment_no_action_time(&self)

Increments the no-action-time counter by one tick.

fn heal(&self, amount: f32)

Heals the entity by the specified amount.

fn is_dead_or_dying(&self) -> bool

Returns true if the entity is dead or dying (health <= 0).

fn is_baby(&self) -> bool

Returns whether this entity is currently a baby.

fn sheep_loot_state(&self) -> Option<(DyeColor, bool)>

Returns the vanilla sheep loot predicate state (minecraft:components.sheep/color together with minecraft:type_specific/sheep.sheared), when this entity is a sheep.

fn chicken_loot_variant(&self) -> Option<&Identifier>

Returns this entity’s minecraft:components.chicken/variant key for the entity loot context, when it is a chicken.

fn default_voice_pitch(&self) -> f32

Returns the base voice pitch before entity-specific adjustments.

fn make_sound(&self, sound: Option<SoundEventRef>)

Plays sound at this entity’s current volume and pitch, if any.

fn play_hurt_sound(&self, source: &DamageSource)

Plays this entity’s hurt sound and resets its ambient-sound timer if it’s a mob.

fn play_death_sound(&self)

Plays vanilla’s death sound for this living entity.

fn get_age_scale(&self) -> f32

Returns the render scale from age: 0.5 for babies, 1.0 for adults.

fn get_scale(&self) -> f32

Returns this entity’s overall render scale, from the scale attribute.

fn is_alive(&self) -> bool

Returns true if the entity is alive (health > 0).

fn get_armor_cover_percentage(&self) -> f32

Returns the fraction of armor slots that currently have equipment, used for armor-tint rendering.

fn get_visibility_percent(&self, targeting_entity: Option<&dyn Entity>) -> f64

Returns how visible this entity is, from 0.0 to 1.0: reduced while sneaking, invisible, or disguised with a matching mob head.

fn disguise_head_matches_targeting_entity( &self, targeting_entity: Option<&dyn Entity>, ) -> bool

Returns whether the equipped head item reduces visibility to targeting_entity.

fn can_be_seen_by_anyone(&self) -> bool

Returns whether this entity is currently visible to anything: alive and not a spectator.

fn can_be_seen_as_enemy(&self) -> bool

Returns whether this entity can be targeted as an enemy: visible and not invulnerable.

fn can_attack(&self, target: &dyn LivingEntity) -> bool

Returns whether this entity may attack target: never a player on peaceful difficulty, and only visible, non-invulnerable targets otherwise.

fn last_damage_source(&self) -> Option<RecentDamageSource>

Returns the last damage source, unless it’s older than the timeout window, with RecentDamageSource retention semantics.

fn record_last_damage_source(&self, source: &DamageSource)

Records a successful hit using the victim’s own level clock.

fn set_last_hurt_by_player(&self, player_uuid: Uuid, time_to_remember: i32)

Records the player that last hurt this entity.

fn invulnerable_time(&self) -> i32

Returns the remaining hurt-cooldown ticks (vanilla Entity.invulnerableTime).

fn set_invulnerable_time(&self, invulnerable_time: i32)

Sets the remaining hurt-cooldown ticks.

fn set_last_hurt_by_player_memory_time(&self, time_to_remember: i32)

Sets the remaining memory time without touching the remembered player.

fn last_hurt_by_player_memory_time(&self) -> i32

Returns ticks remaining that this entity will remember the player who last hurt it.

fn last_hurt_by_player_uuid(&self) -> Option<Uuid>

Returns vanilla LivingEntity.lastHurtByPlayer, if still remembered.

fn last_hurt_by_mob(&self) -> Option<SharedEntity>

Returns the mob that last hurt this entity, if still resolvable.

fn last_hurt_by_mob_timestamp(&self) -> i32

Returns the tick timestamp this entity was last hurt by a mob.

fn set_last_hurt_by_mob(&self, target: Option<&SharedEntity>)

Records the mob that last hurt this entity.

fn last_hurt_mob(&self) -> Option<SharedEntity>

Returns the mob this entity last hurt, if still resolvable.

fn last_hurt_mob_timestamp(&self) -> i32

Returns the tick timestamp this entity last hurt a mob.

fn set_last_hurt_mob(&self, target: Option<&SharedEntity>)

Records the mob this entity last hurt.

fn resolve_mob_responsible_for_damage(&self, source: &DamageSource)

Records the causing entity as this entity’s last-hurt-by mob, skipping damage types that shouldn’t provoke anger (e.g. no_anger, or wind charges when this mob is immune to their anger).

fn resolve_player_responsible_for_damage(&self, source: &DamageSource)

Records the causing entity as this entity’s last-hurt-by player, if the causing entity is a player.

fn has_line_of_sight(&self, target: &dyn Entity) -> bool

Returns whether this entity has an unobstructed line of sight to target’s eyes.

fn has_line_of_sight_with( &self, target: &dyn Entity, block_shape: ClipBlockShape, fluid: ClipFluid, target_eye_y: f64, ) -> bool

Returns vanilla line-of-sight with explicit clip options.

fn default_is_invulnerable_to(&self, source: &DamageSource) -> bool

Returns vanilla base living-entity invulnerability.

fn is_invulnerable_to(&self, _world: &World, source: &DamageSource) -> bool

Returns whether this living entity ignores a damage source.

fn hurt_server(&self, world: &World, source: &DamageSource, amount: f32) -> bool

Main vanilla living-entity damage entry point.

fn default_hurt_server( &self, world: &World, source: &DamageSource, amount: f32, ) -> bool

Runs the base LivingEntity.hurtServer body.

fn before_actually_hurt(&self, _source: &DamageSource, _amount: f32)

Hook before applying damage after vanilla reductions.

fn hurt_armor(&self, _source: &DamageSource, _damage: f32)

Damages equipment that participates in vanilla armor absorption.

fn do_hurt_equipment( &self, source: &DamageSource, damage: f32, slots: &[EquipmentSlot], )

Damages equipped items in the given slots that are eligible to absorb this damage source.

fn get_damage_after_armor_absorb( &self, source: &DamageSource, damage: f32, ) -> f32

Reduces damage by the entity’s armor value and toughness, unless the source bypasses armor.

fn get_damage_after_magic_absorb( &self, source: &DamageSource, damage: f32, ) -> f32

Reduces damage based on the resistance effect, unless the source bypasses it or effects entirely.

fn actually_hurt(&self, world: &World, source: &DamageSource, amount: f32)

Applies damage after vanilla reductions.

fn apply_damage_knockback(&self, source: &DamageSource)

Applies vanilla hurt knockback for a damage source.

fn damage_knockback_direction(&self, source: &DamageSource) -> (f64, f64)

Returns the horizontal direction used by vanilla damage knockback.

fn knockback(&self, power: f64, xd: f64, zd: f64)

Applies knockback velocity in the direction (xd, zd), scaled by power and reduced by knockback resistance.

fn knockback_resistance(&self) -> f64

Returns vanilla knockback resistance.

fn indicate_damage(&self, _xd: f64, _zd: f64)

Applies a client-visible damage knockback indication in the given direction.

fn hurt_broadcast_chunk(&self) -> ChunkPos

Returns the chunk used for vanilla nearby hurt broadcasts.

fn broadcast_damage_event(&self, world: &World, source: &DamageSource)

Broadcasts vanilla damage-event metadata near this entity.

fn check_totem_death_protection(&self, source: &DamageSource) -> bool

Uses a held death-protection item to survive lethal damage. Returns whether one was used.

fn die(&self, source: &DamageSource)

Processes vanilla living death side effects.

fn handle_killing_blow(&self)

Runs vanilla LivingEntity.handleKillingBlow.

fn should_drop_loot(&self, world: &World) -> bool

Returns vanilla LivingEntity.shouldDropLoot. Returns whether this entity should drop loot on death: not a baby, and the mob-drops game rule allows it.

fn should_drop_experience(&self) -> bool

Returns whether this entity should drop experience on death: not a baby.

fn is_always_experience_dropper(&self) -> bool

Returns whether this entity always drops experience regardless of the player-kill requirement; false by default.

fn skip_drop_experience(&self)

Marks this entity to skip dropping experience on death.

fn was_experience_consumed(&self) -> bool

Returns whether this entity has been marked to skip dropping experience.

fn base_experience_reward(&self) -> i32

Returns the base experience reward for killing this entity, using the animal-specific reward when applicable.

fn experience_reward( &self, _world: &World, _killer_entity: Option<&dyn Entity>, ) -> i32

Returns the experience reward for this entity’s death; currently equal to the base reward (see TODO).

fn drop_all_death_loot(&self, source: &DamageSource)

Runs the currently implemented subset of vanilla LivingEntity.dropAllDeathLoot.

fn drop_experience( &self, world: &Arc<World>, killer_entity: Option<&dyn Entity>, )

Awards experience for this entity’s death when eligible, spawning an experience orb.

fn death_loot_table(&self) -> Option<LootTableRef>

Returns this entity’s death loot table: a mob’s custom override if set, otherwise the default table for its entity type.

fn death_loot_table_seed(&self) -> i64

Returns the loot-table seed for this entity’s death loot, if it’s a mob.

fn drop_from_loot_table(&self, source: &DamageSource, killed_by_player: bool)

Rolls and spawns this entity’s death-loot drops from its loot table, seeded deterministically when a loot-table seed is set.

fn drop_custom_death_loot( &self, _source: &DamageSource, _killed_by_player: bool, )

Hook for non-mob custom death loot.

fn tick_death(&self)

Ticks the vanilla living death animation and removes the entity at completion.

fn get_absorption_amount(&self) -> f32

Gets the absorption amount (extra health from effects like absorption).

fn set_absorption_amount(&self, amount: f32)

Sets the absorption amount.

fn fall_damage_sound(&self, damage: i32) -> SoundEventRef

Returns the small or big fall sound based on damage.

fn play_block_fall_sound(&self)

Plays the sound of the block this entity is standing in/on after a fall.

fn cause_living_fall_damage( &self, fall_distance: f64, damage_modifier: f32, source: &DamageSource, ) -> bool

Applies fall damage to a living entity, factoring in effects that reduce or negate it.

fn get_armor_value(&self) -> i32

Gets the entity’s armor value from the attribute system.

fn get_attribute_gravity(&self) -> f64

Gets the gravity value from the attribute system.

fn get_effective_gravity(&self) -> f64

Returns this entity’s gravity, reduced while falling under Slow Falling.

fn is_affected_by_potions(&self) -> bool

Checks if the entity can be affected by potions.

fn is_inverted_heal_and_harm(&self) -> bool

Returns whether healing and harm effects are inverted for this entity (e.g. undead mobs).

fn default_can_be_affected(&self, effect: &MobEffectInstance) -> bool

Returns vanilla base LivingEntity.canBeAffected eligibility.

fn can_be_affected(&self, effect: &MobEffectInstance) -> bool

Returns whether this entity accepts a mob-effect instance.

fn has_mob_effect(&self, effect: MobEffectRef) -> bool

Returns whether this entity currently has effect active.

fn mob_effect(&self, effect: MobEffectRef) -> Option<ActiveMobEffect>

Returns this entity’s active instance of effect, if any.

fn active_mob_effects(&self) -> Vec<ActiveMobEffect>

Returns all active vanilla mob effects.

fn set_mob_effect(&self, effect: MobEffectRef, amplifier: i32)

Sets active vanilla mob-effect state.

fn add_mob_effect(&self, effect: MobEffectInstance) -> bool

Adds or updates active vanilla mob-effect state.

fn add_mob_effect_with_source( &self, effect: MobEffectInstance, source: Option<&dyn Entity>, ) -> bool

Adds or updates active vanilla mob-effect state, attributing it to source.

fn set_mob_effect_active(&self, effect: MobEffectRef, active: bool)

Sets the presence of a vanilla mob effect.

fn remove_mob_effect(&self, effect: MobEffectRef) -> bool

Removes active vanilla mob-effect state.

fn tick_mob_effects(&self)

Ticks vanilla server-side mob-effect behavior and durations.

fn has_water_breathing(&self) -> bool

Returns whether vanilla effects keep this entity from drowning.

fn should_effects_refill_air_supply(&self) -> bool

Returns whether active vanilla effects refill this entity’s air supply.

fn can_breathe_underwater(&self) -> bool

Returns whether this entity’s type can breathe underwater.

fn can_drown_in_water(&self) -> bool

Returns whether this entity can lose air and take drowning damage.

fn is_eye_in_bubble_column(&self) -> bool

Returns whether the entity’s eye block is a bubble column.

fn decrease_air_supply(&self, current_supply: i32) -> i32

Decreases air supply while drowning, occasionally skipped when the oxygen bonus effect applies.

fn increase_air_supply(&self, current_supply: i32) -> i32

Refills air supply while out of water, capped at the entity’s maximum.

fn should_take_drowning_damage(&self) -> bool

Returns whether air supply has dropped low enough to start dealing drowning damage.

fn tick_living_air_supply(&self)

Ticks vanilla living air-supply and drowning behavior from baseTick.

fn is_in_wall(&self) -> bool

Returns whether the entity is suffocating in a wall, ignoring the check while sleeping.

fn tick_in_wall_damage(&self)

Applies vanilla living in-wall damage from baseTick.

fn tick_living_environmental_damage(&self)

Applies vanilla living environmental damage in LivingEntity.baseTick order.

fn is_affected_by_fluids(&self) -> bool

Returns whether this entity is affected by fluid physics; true by default.

fn can_stand_on_fluid(&self, _fluid_state: FluidState) -> bool

Returns whether this entity can stand on the given fluid’s surface; false by default.

fn is_using_item(&self) -> bool

Checks if the entity is currently using an item.

fn is_blocking(&self) -> bool

Checks if the entity is blocking with a shield or similar item.

fn is_fall_flying(&self) -> bool

Checks if the entity is fall flying (using elytra).

fn set_fall_flying(&self, fall_flying: bool)

Sets whether this entity is fall flying.

fn fall_flying_ticks(&self) -> i32

Returns ticks this entity has been fall-flying.

fn with_equipment_slot( &self, slot: EquipmentSlot, visitor: &mut dyn FnMut(&ItemStack), )

Visits the item in a vanilla living-entity equipment slot.

fn is_holding(&self, predicate: &mut dyn FnMut(&ItemStack) -> bool) -> bool

Returns whether the item in this entity’s main hand matches predicate.

fn tick_equipment(&self)

Ticks every equipped item.

fn with_equipment_slot_mut( &self, slot: EquipmentSlot, visitor: &mut dyn FnMut(&mut ItemStack), )

Mutates the item in a vanilla living-entity equipment slot.

fn has_item_in_slot(&self, slot: EquipmentSlot) -> bool

Returns whether this entity currently has an item in slot.

fn can_use_slot(&self, _slot: EquipmentSlot) -> bool

Returns whether vanilla allows this entity to use slot.

fn can_dispenser_equip_into_slot(&self, _slot: EquipmentSlot) -> bool

Returns the effective vanilla dispenser slot gate for living entities and mobs.

fn can_equip_with_dispenser(&self, item_stack: &ItemStack) -> bool

Returns whether a dispenser may auto-equip this item onto this entity: alive, not a spectator, and the item is dispensable equipment for an open, usable slot this entity’s type accepts.

fn is_equippable_in_slot( &self, item_stack: &ItemStack, slot: EquipmentSlot, ) -> bool

Returns whether item_stack may be worn in slot, defaulting to holdable-in-main-hand items with no equippable component.

fn equip_sound( &self, slot: EquipmentSlot, stack: &ItemStack, ) -> Option<SoundEventRef>

Returns the equip sound Steel can currently resolve for this entity.

fn on_equip_item( &self, slot: EquipmentSlot, previous: &ItemStack, stack: &ItemStack, )

Applies the sound portion of vanilla’s equipment-change hook.

fn interact_living_entity_with_equippable( &self, player: &Player, hand: InteractionHand, ) -> InteractionResult

Runs vanilla’s equippable ItemStack.interactLivingEntity branch.

fn refresh_equipment_attribute_modifiers(&self, slot: EquipmentSlot)

Refreshes transient item attribute modifiers for one equipment slot.

fn detect_equipment_updates(&self)

Detects and applies Vanilla living-equipment changes once per tick.

fn pack_living_equipment(&self) -> Vec<EquipmentSlotItem>

Packs non-empty living equipment slots for initial spawn pairing.

fn drain_dirty_living_equipment(&self) -> Vec<EquipmentSlotItem>

Drains dirty living equipment slots for tracker sync.

fn has_infinite_materials(&self) -> bool

Returns whether equipment durability should be skipped for this entity.

fn handle_extra_items_created_on_use(&self, _extra: ItemStack)

Mirrors vanilla LivingEntity.handleExtraItemsCreatedOnUse, which is a no-op for non-player mobs.

fn on_equipped_item_broken(&self, _item: ItemRef, slot: EquipmentSlot)

Called after an equipped item breaks.

fn default_living_can_freeze(&self) -> bool

Returns vanilla LivingEntity.canFreeze() after concrete entity exemptions.

fn is_on_non_air_block_for_frost(&self) -> bool

Returns whether the block this entity is standing on is non-air, required for the powder-snow speed penalty to apply.

fn remove_frost(&self)

Removes the powder snow speed penalty modifier.

fn try_add_frost(&self)

Applies the powder snow speed penalty modifier if the entity is frozen and can freeze.

fn tick_freezing(&self)

Ticks freeze-related state each AI step: cools ticks_frozen when not in powder snow (or unable to freeze), then refreshes the powder-snow speed penalty.

fn tick_living_entity(&self, entity: &SharedEntity)

Runs vanilla LivingEntity.tick.

fn tick_living_state(&self)

Ticks living-entity counters after movement.

fn can_glide_using(&self, item_stack: &ItemStack, slot: EquipmentSlot) -> bool

Returns whether the given item in the given slot allows elytra-style gliding.

fn can_glide_using_equipment_slot(&self, slot: EquipmentSlot) -> bool

Returns whether the item in slot can be used for vanilla gliding.

fn damage_random_glider(&self)

Damages a random equipped item slot that’s currently enabling this entity to glide, breaking it if durability runs out.

fn default_can_glide(&self) -> bool

Returns whether this entity meets the base conditions to glide: not grounded, not a passenger, not levitating, and wearing something that allows gliding.

fn can_glide(&self) -> bool

Returns whether the entity currently meets the conditions to glide with an elytra.

fn start_fall_flying(&self)

Puts the entity into the fall-flying (elytra gliding) state.

fn try_to_start_fall_flying(&self) -> bool

Attempts to start fall flying if the entity isn’t already gliding, can glide, and isn’t in water.

fn last_climbable_pos(&self) -> Option<BlockPos>

Returns the last climbable block position this living entity touched.

fn set_last_climbable_pos(&self, pos: BlockPos)

Records the last climbable block position this living entity touched.

fn default_living_on_climbable(&self) -> bool

Returns whether this entity is currently touching a climbable block; always false for spectators.

fn should_discard_friction(&self) -> bool

Returns whether vanilla living travel should skip friction damping.

fn set_discard_friction(&self, discard_friction: bool)

Sets whether vanilla living travel should skip friction damping.

fn is_jumping(&self) -> bool

Returns whether this living entity is currently applying jump input.

fn set_jumping(&self, jumping: bool)

Sets whether this living entity is currently applying jump input.

fn travel_input(&self) -> LivingTravelInput

Returns vanilla living travel input.

fn set_travel_input(&self, input: LivingTravelInput)

Sets vanilla living travel input.

fn apply_input(&self)

Applies horizontal damping to the entity’s stored travel input for this tick.

fn no_jump_delay(&self) -> i32

Returns vanilla jump cooldown ticks.

fn set_no_jump_delay(&self, ticks: i32)

Sets vanilla jump cooldown ticks.

fn tick_no_jump_delay(&self)

Decrements vanilla jump cooldown once per living AI step.

fn hurt_time(&self) -> i32

returns the remaining hurt animation ticks

fn default_is_immobile(&self) -> bool

Returns vanilla LivingEntity.isImmobile(). Returns whether this entity is immobile because it’s dead or dying.

fn is_immobile(&self) -> bool

Returns whether this entity is currently immobile.

fn apply_living_velocity_thresholds(&self)

Zeroes out velocity components too small to matter, using a stricter horizontal threshold for players than other entities.

fn get_jump_boost_power(&self) -> f32

Returns the jump-height bonus from the Jump Boost effect, scaling with amplifier.

fn get_jump_power_with_multiplier(&self, multiplier: f32) -> f32

Returns jump velocity from the jump-strength attribute, scaled by multiplier, the standing block’s jump factor, and Jump Boost.

fn get_jump_power(&self) -> f32

Returns this entity’s jump power at the default multiplier.

fn default_jump_from_ground(&self)

Applies this entity’s jump velocity, unless jump power is negligible.

fn jump_from_ground(&self)

Applies the entity’s jump velocity.

fn go_down_in_water(&self)

Applies downward velocity while submerged and not jumping out of a liquid.

fn jump_in_liquid(&self, _fluid_tag: &Identifier)

Applies upward velocity to jump out of the given liquid.

fn handle_living_jump(&self)

Handles jump input each AI step: jumps from the ground when clear of jump delay, or jumps within water/lava when only partially submerged.

fn tick_ridden(&self, _controller: &Player, _ridden_input: DVec3)

Ticks side effects of a rider controlling this entity, such as steering-based input.

fn ridden_input(&self, _controller: &Player, self_input: DVec3) -> DVec3

Transforms the rider’s raw input into this entity’s movement input while ridden.

fn ridden_speed(&self, _controller: &Player) -> f32

Returns the movement speed to use while being ridden.

fn travel_ridden( &self, entity: &SharedEntity, controller: &Player, self_input: DVec3, ) -> Option<MoveResult>

Handles movement while this entity is being ridden and steered by a controlling player.

fn default_ai_step(&self, entity: &SharedEntity) -> Option<MoveResult>

Default vanilla-shaped LivingEntity.aiStep() movement foundation for overrides.

fn push_entities_in_order(&self, entities: &[SharedEntity])

Pushes against entities in the given order. The caller applies cramming damage first.

fn apply_entity_cramming_damage( &self, world: &World, pushable_entities: &[SharedEntity], )

Applies vanilla max entity cramming damage from LivingEntity.pushEntities().

fn is_suppressing_sliding_down_ladder(&self) -> bool

Returns whether this entity is suppressing sliding down a ladder (sneaking on one).

fn levitation_travel_y_delta(&self, movement_y: f64) -> Option<f64>

Returns a levitation velocity adjustment for travelInAir.

fn should_travel_in_fluid(&self, fluid_state: FluidState) -> bool

Returns whether movement should use fluid physics: currently in water or lava, affected by fluids, and unable to stand on this fluid.

fn get_water_slow_down(&self) -> f32

Returns the water-movement slowdown multiplier.

fn water_movement_efficiency(&self) -> f32

Returns the water movement efficiency attribute used by fluid travel.

fn has_dolphins_grace(&self) -> bool

Returns whether dolphin’s grace should apply to water travel.

fn get_flying_speed(&self) -> f32

Returns airborne movement speed: scaled from this entity’s speed when ridden by a player, otherwise a small constant.

fn get_friction_influenced_speed(&self, block_friction: f32) -> f32

Returns movement speed adjusted by ground friction; airborne entities use flying speed instead.

fn air_travel_vertical_friction(&self, _horizontal_friction: f32) -> f32

Returns the vertical friction used by travelInAir.

fn handle_on_climbable(&self, movement: DVec3) -> DVec3

Clamps movement while on a climbable block: caps horizontal and downward speed, and resets fall distance; sneaking players holding on don’t slide down non-scaffolding ladders.

fn apply_living_travel_gravity(&self)

Applies gravity using vanilla living-entity effective gravity.

fn handle_relative_friction_and_calculate_movement( &self, entity: &SharedEntity, input: DVec3, block_friction: f32, ) -> Option<(DVec3, MoveResult)>

Applies friction-adjusted relative movement and returns the resulting velocity and move result.

fn travel_in_air( &self, entity: &SharedEntity, input: DVec3, ) -> Option<MoveResult>

Handles movement, gravity, and air friction while the entity is airborne.

fn get_fluid_falling_adjusted_movement( &self, base_gravity: f64, is_falling: bool, movement: DVec3, ) -> DVec3

Adjusts vertical movement while falling through a fluid to smooth the fall speed.

fn jump_out_of_fluid(&self, old_y: f64)

Gives the entity an upward boost when it collides horizontally while rising out of a fluid.

fn float_in_water_while_ridden(&self)

Applies buoyancy to keep a ridden entity afloat when it’s tagged to float while ridden.

fn travel_in_water( &self, entity: &SharedEntity, input: DVec3, base_gravity: f64, is_falling: bool, old_y: f64, ) -> Option<MoveResult>

Handles movement, drag, and buoyancy effects while the entity is swimming in water.

fn travel_in_lava( &self, entity: &SharedEntity, input: DVec3, base_gravity: f64, is_falling: bool, old_y: f64, ) -> Option<MoveResult>

Handles movement and drag effects while the entity is moving through lava.

fn travel_in_fluid( &self, entity: &SharedEntity, input: DVec3, ) -> Option<MoveResult>

Dispatches fluid movement handling to the water or lava variant based on the current fluid.

fn update_fall_flying(&self)

Mirrors the validation part of vanilla LivingEntity.updateFallFlying().

fn update_fall_flying_movement(&self, movement: DVec3) -> DVec3

Computes the next movement vector for elytra gliding based on look direction and lift.

fn stop_fall_flying(&self)

Toggles fall flying off, ending the elytra gliding state.

fn handle_fall_flying_collisions( &self, previous_horizontal_speed: f64, new_horizontal_speed: f64, )

Applies fly-into-wall damage when a horizontal collision occurs while gliding.

fn travel_fall_flying( &self, entity: &SharedEntity, input: DVec3, ) -> Option<MoveResult>

Handles movement, lift, and collision damage while the entity is gliding with an elytra.

fn default_travel( &self, entity: &SharedEntity, input: DVec3, ) -> Option<MoveResult>

Dispatches movement to fluid, fall-flying, or air travel handling based on current state.

fn travel(&self, entity: &SharedEntity, input: DVec3) -> Option<MoveResult>

Handles the entity’s self-driven movement for the current tick based on its input.

fn sleeping_pos(&self) -> Option<BlockPos>

Returns the bed position that makes this living entity sleeping.

fn set_sleeping_pos(&self, bed_position: BlockPos)

Sets the vanilla living-entity sleeping position.

fn clear_sleeping_pos(&self)

Clears the vanilla living-entity sleeping position.

fn is_sleeping(&self) -> bool

Checks if the entity is sleeping.

fn living_synced_data(&self) -> Option<&dyn LivingEntitySyncedData>

Returns synchronized data specific to this living entity type, if any; None by default.

fn start_sleeping(&self, bed_position: BlockPos) -> Result<(), EntityMoveError>

Starts sleeping at the given bed position.

fn default_stop_sleeping(&self)

Shared body for overrides that need vanilla super.stopSleeping().

fn stop_sleeping(&self)

Stops the entity from sleeping.

fn is_sprinting(&self) -> bool

Checks if the entity is sprinting.

fn set_sprinting(&self, sprinting: bool)

Sets whether the entity is sprinting.

fn get_speed(&self) -> f32

Gets the entity’s cached movement speed.

fn set_speed(&self, speed: f32)

Sets the entity’s cached movement speed.

fn apply_post_impulse_grace_time(&self, ticks: i32)

Applies vanilla post-impulse movement validation grace.

fn set_ignore_fall_damage_from_current_impulse( &self, ignore_fall_damage: bool, new_impulse_impact_pos: DVec3, )

Sets whether fall damage from the current knockback/impulse impact should be ignored.

fn is_ignoring_fall_damage_from_current_impulse(&self) -> bool

Returns whether fall damage should currently be ignored due to a recent knockback/impulse impact.

fn current_impulse_impact_pos(&self) -> Option<DVec3>

Returns the position of the most recent knockback/impulse impact, if still active.

fn try_reset_current_impulse_context(&self)

Attempts to reset the current impulse context.

fn reset_current_impulse_context(&self)

Resets the current impulse context.

fn is_in_post_impulse_grace_time(&self) -> bool

Returns whether movement validation is inside post-impulse grace.

fn tick_post_impulse_grace_time(&self)

Decrements post-impulse grace once per living-entity tick.

fn refresh_dirty_attributes(&self)

Drains dirty attributes and applies server-side effects.

fn random_teleport( &self, world: &Arc<World>, x: f64, y: f64, z: f64, broadcast: bool, ) -> bool

Returns true and commits the move on success, or false and leaves the entity untouched on failure.

impl Mob for BatEntity

fn mob_base(&self) -> &MobBase

fn mob_can_be_leashed(&self) -> bool

Returns whether this mob can be leashed, before its leash state is considered.

fn custom_server_ai_step(&self)

fn ambient_sound(&self) -> Option<SoundEventRef>

fn mob_flags(&self) -> i8

fn set_mob_flags(&self, flags: i8)

fn check_spawn_rules( &self, _world: &Arc<World>, _reason: EntitySpawnReason, ) -> bool

Returns whether the entity-specific spawn predicate accepts this spawn.

fn set_baby(&self, baby: bool)

Sets the vanilla baby state. Vanilla Mob.setBaby is a no-op; ageable mobs derive it from their start age, and other mobs override as needed.

fn is_saddled(&self) -> bool

Returns whether this mob has a saddle equipped.

fn has_line_of_sight_cached(&self, target: &dyn Entity) -> bool

Checks line of sight using this mob sensing cache

fn ate(&self)

Runs vanilla Mob.ate, invoked after an eating goal resolves a block.

fn tick_goal_selectors(&self, _entity: &SharedEntity)

fn xp_reward(&self) -> i32

fn set_xp_reward(&self, xp_reward: i32)

fn target(&self) -> Option<SharedEntity>

Returns this mob’s current attack target, if it’s still a valid one.

fn set_target(&self, target: Option<&SharedEntity>) -> bool

Sets vanilla Mob.target.

fn is_valid_target(&self, target: &dyn LivingEntity) -> bool

fn can_attack(&self, target: &dyn LivingEntity) -> bool

Returns whether this mob may attack the target; excludes ghasts, which mobs never target directly.

fn base_experience_reward_mob(&self) -> i32

fn ambient_sound_interval(&self) -> i32

fn play_ambient_sound(&self)

fn reset_ambient_sound_time(&self)

fn base_tick_mob(&self)

Runs the shared living-entity base tick, then mob-specific per-tick behavior.

fn mob_base_tick(&self)

Runs the mob-owned portion of vanilla Mob.baseTick.

fn finalize_spawn( &self, world: &Arc<World>, spawn_reason: EntitySpawnReason, group_data: Option<SpawnGroupData>, ) -> Option<SpawnGroupData>

fn finalize_spawn_mob_base( &self, _world: &Arc<World>, _spawn_reason: EntitySpawnReason, group_data: Option<SpawnGroupData>, ) -> Option<SpawnGroupData>

fn convert_to( &self, entity_type: EntityTypeRef, params: ConversionParams, after_conversion: Option<&AfterConversion<'_>>, ) -> Option<SharedEntity>

where Self: Sized,

Creates a replacement or split mob and transfers state according to params. The callback finalizes mob-specific state. Returns None without changing the source if it is removed or world, difficulty, factory, mob-type, or insertion checks fail.

fn check_mob_spawn_rules( entity_type: EntityTypeRef, level: &dyn LevelReader, spawn_reason: EntitySpawnReason, pos: BlockPos, ) -> bool

where Self: Sized,

Requires the block below to accept the spawn via BlockBehavior::is_valid_spawn, unless a spawner bypasses the surface check.

fn check_spawn_obstruction(&self, world: &Arc<World>) -> bool

fn interact_mob( &self, player: &Player, hand: InteractionHand, location: DVec3, ) -> InteractionResult

Dispatches held-item, entity, and mob-specific interactions in order.

fn check_and_handle_important_interactions( &self, player: &Player, hand: InteractionHand, ) -> InteractionResult

Handles interactions that take priority over normal behavior: renaming with a name tag and spawning with a spawn egg.

fn mob_interact( &self, _player: &Player, _hand: InteractionHand, ) -> InteractionResult

Mob-specific interaction hook for concrete mobs to override; does nothing by default.

fn can_shear_equipment(&self, _player: &Player) -> bool

Returns whether this mob’s equipment can be sheared; false while something is riding it.

fn use_player_item(&self, player: &Player, hand: InteractionHand)

Consumes one of the player’s held item after this mob uses it in an interaction.

fn remove_when_far_away(&self, dist_sqr: f64) -> bool

fn requires_custom_persistence(&self) -> bool

fn is_persistence_required(&self) -> bool

fn set_persistence_required(&self)

fn can_pick_up_loot(&self) -> bool

Returns whether this mob is allowed to pick up dropped items.

fn set_can_pick_up_loot(&self, can_pick_up_loot: bool)

fn equipment_drop_chance(&self, slot: EquipmentSlot) -> f32

fn set_equipment_drop_chance(&self, slot: EquipmentSlot, chance: f32)

fn is_equipment_drop_preserved(&self, slot: EquipmentSlot) -> bool

fn set_guaranteed_drop(&self, slot: EquipmentSlot)

fn get_pickup_reach(&self) -> DVec3

Vanilla Mob.getPickupReach: the per-axis distance the item-pickup search box is inflated by. Overridable so mobs with a longer reach can widen it.

fn wants_to_pick_up(&self, item_stack: &ItemStack) -> bool

Vanilla Mob.wantsToPickUp: whether this mob wants to collect the item it just walked over. Defaults to whatever the mob is willing to hold.

fn can_hold_item(&self, _item_stack: &ItemStack) -> bool

Vanilla Mob.canHoldItem: whether this mob is willing to hold the item. The base mob holds anything; specific mobs narrow this down.

fn pick_up_item(&self, world: &Arc<World>, item_entity: &ItemEntity)

Vanilla Mob.pickUpItem: take a dropped item into this mob’s equipment.

fn equip_item_if_possible(&self, item_stack: ItemStack) -> ItemStack

Vanilla Mob.equipItemIfPossible: route item_stack to the slot its equippable component asks for (main hand otherwise), swap up when the target slot already holds worse gear, and drop the replaced piece by its drop chance. Returns the stack that was equipped, or empty when nothing was taken.

fn get_equipment_slot_for_item(&self, item_stack: &ItemStack) -> EquipmentSlot

Vanilla LivingEntity.getEquipmentSlotForItem: the slot an item wants to occupy, falling back to the main hand when it is not equippable or the mob cannot use that slot.

fn equipment_in_slot(&self, slot: EquipmentSlot) -> ItemStack

Returns a copy of whatever this mob currently holds in slot.

fn can_replace_current_item( &self, new_item_stack: &ItemStack, current_item_stack: &ItemStack, slot: EquipmentSlot, ) -> bool

Vanilla Mob.canReplaceCurrentItem: whether the freshly picked-up item should displace what is already in slot.

fn compare_armor( &self, new_item_stack: &ItemStack, current_item_stack: &ItemStack, slot: EquipmentSlot, ) -> bool

Vanilla Mob.compareArmor: prefer the piece granting more armor, then more toughness, then the equal-item tiebreak, unless the worn piece is protected against removal.

fn get_preferred_weapon_type(&self) -> Option<Identifier>

Vanilla Mob.getPreferredWeaponType: the item tag a mob favors for its main hand regardless of raw damage (a skeleton keeps its bow over a stronger sword). The base mob has no preference; specific mobs override it.

fn compare_weapons( &self, new_item_stack: &ItemStack, current_item_stack: &ItemStack, slot: EquipmentSlot, ) -> bool

Vanilla Mob.compareWeapons: keep a piece of the mob’s preferred weapon type over one that is not, otherwise prefer more attack damage, then the equal-item tiebreak.

fn approximate_attribute_with( &self, item_stack: &ItemStack, attribute: AttributeRef, slot: EquipmentSlot, ) -> f64

Vanilla Mob.getApproximateAttributeWith: the value of attribute this mob would have in slot while wearing item_stack, taking the mob’s base value (zero when it lacks the attribute) and folding in the item’s attribute modifiers.

fn can_replace_equal_item( &self, new_item_stack: &ItemStack, current_item_stack: &ItemStack, ) -> bool

Vanilla Mob.canReplaceEqualItem: the tiebreak when two pieces grade out equally, favoring more enchantments, then less damage, then a custom name.

fn tick_looting(&self)

Vanilla Mob.aiStep looting loop: while this mob may pick up loot and the mobGriefing game rule allows it, collect nearby dropped items in reach.

fn drop_custom_death_loot_mob( &self, _source: &DamageSource, killed_by_player: bool, )

fn save_mob(&self, nbt: &mut NbtCompound)

fn load_mob(&self, nbt: BorrowedNbtCompoundView<'_, '_>)

fn set_death_loot_table(&self, loot_table: Option<Identifier>)

fn set_death_loot_table_seed(&self, seed: i64)

fn custom_death_loot_table(&self) -> Option<LootTableRef>

fn has_custom_death_loot_table(&self) -> bool

fn death_loot_table_seed(&self) -> i64

fn clear_custom_death_loot_table(&self)

fn is_within_home(&self) -> bool

fn is_within_home_pos(&self, pos: BlockPos) -> bool

fn is_within_home_vec(&self, pos: DVec3) -> bool

fn set_home_to(&self, position: BlockPos, radius: i32)

fn home_position(&self) -> BlockPos

fn home_radius(&self) -> i32

fn clear_home(&self)

fn has_home(&self) -> bool

fn check_mob_despawn(&self)

fn nearest_player_distance_sqr(&self) -> Option<f64>

fn controlling_passenger_mob(&self) -> Option<SharedEntity>

fn get_pathfinding_malus(&self, path_type: PathType) -> f32

fn max_fall_distance(&self) -> i32

Blocks a mob can fall before taking fall damage; concrete mobs may raise this.

fn set_pathfinding_malus(&self, path_type: PathType, malus: f32)

fn is_no_ai(&self) -> bool

fn set_no_ai(&self, no_ai: bool)

fn is_left_handed(&self) -> bool

fn set_left_handed(&self, left_handed: bool)

fn is_aggressive(&self) -> bool

fn max_head_x_rot(&self) -> f32

Maximum degrees the head may pitch up or down independently of the body.

fn max_head_y_rot(&self) -> f32

Maximum degrees the head may yaw left or right independently of the body.

fn do_hurt_target( &self, entity: &SharedEntity, world: &World, target: &SharedEntity, ) -> bool

Performs this mob’s melee attack against target: computes weapon damage and knockback, applies enchantment effects, and returns whether the target was hurt.

fn mob_attack_damage_source( &self, weapon_item: &ItemStack, attacker: &SharedEntity, ) -> DamageSource

Builds the damage source for this mob’s melee attack: the weapon’s custom damage type if set, else its behavior’s item damage source, else the default mob-attack type.

fn get_attack_knockback( &self, target: &dyn Entity, weapon_item: &ItemStack, damage_source: &DamageSource, ) -> f64

Computes attack knockback strength from the attack-knockback attribute and the weapon’s knockback enchantments.

fn cause_extra_knockback( &self, target: &dyn Entity, knockback_amount: f64, _old_movement: DVec3, )

Knocks the target back in this mob’s facing direction and dampens this mob’s own horizontal velocity.

fn play_attack_sound(&self)

Plays this mob’s attack sound; does nothing by default.

fn is_within_melee_attack_range(&self, target: &dyn LivingEntity) -> bool

Returns whether target is within this mob’s melee attack range.

fn attack_bounding_box(&self, horizontal_expansion: f64) -> WorldAabb

Returns the bounding box used for melee range checks, expanded horizontally and extended to cover a ridden vehicle.

fn set_aggressive(&self, aggressive: bool)

fn set_mob_flag(&self, flag: i8, enabled: bool)

fn controlled_mob_vehicle(&self) -> Option<SharedEntity>

fn set_wanted_position(&self, position: DVec3, speed_modifier: f64)

fn jump_control_jump(&self)

fn set_mob_speed(&self, speed: f32)

Mirrors vanilla Mob.setSpeed: update cached speed and forward AI input.

fn mob_server_ai_step(&self, entity: &SharedEntity)

fn is_sun_burn_tick(&self) -> bool

Rolls the daylight-burning chance when MONSTERS_BURN is enabled. Water, rain, and powder snow prevent burning.

fn sun_protection_slot(&self) -> EquipmentSlot

fn tick_daylight_burning(&self)

Damages sun-protective gear on a successful burn roll, or ignites the mob if the slot is empty.

fn mob_ai_step(&self, entity: &SharedEntity) -> Option<MoveResult>

Runs movement, daylight burning, and item pickup.

fn tick_path_navigation(&self)

fn tick_move_control(&self)

fn tick_move_to_control(&self, wanted_position: DVec3, speed_modifier: f64)

fn tick_strafe_control(&self, forward: f32, right: f32)

fn is_strafe_walkable(&self, dx: f32, dz: f32) -> bool

fn tick_jumping_control(&self, speed_modifier: f64)

fn tick_look_control(&self)

fn clamp_head_rotation_to_body_when_pathing(&self)

fn tick_jump_control(&self)

fn update_control_flags(&self)

fn tick_body_rotation_control(&self)