Struct Entity 

pub struct Entity<'a> { /* private fields */ }

A handle to one entity by UUID, bound to a Server.

Implementations

impl<'a> Entity<'a>

pub fn new(server: &'a dyn Server, uuid: impl Into<String>) -> Entity<'a>

Bind to the entity with this UUID on server.

pub fn uuid(&self) -> &str

pub fn teleport(&self, x: f64, y: f64, z: f64) -> bool

Teleport to (x, y, z) within the entity’s current world.

pub fn rotation(&self) -> Option<(f32, f32)>

Current position, or None if the entity isn’t loaded. Yaw and pitch in degrees, or None if the entity does not exist.

pub fn look_vector(&self) -> Option<(f64, f64, f64)>

Unit look vector derived from yaw/pitch (Minecraft convention).

pub fn position(&self) -> Option<(f64, f64, f64)>

pub fn health(&self) -> Option<f32>

Health (living entities only), or None.

pub fn set_health(&self, health: f32) -> bool

Set health (living entities only); returns whether it applied.

pub fn kill(&self) -> bool

Remove/kill the entity.

pub fn add_effect( &self, effect_id: &str, duration_ticks: i32, amplifier: u8, show_particles: bool, ) -> bool

Apply a status effect. effect_id is a registry id like "minecraft:speed". amplifier is 0-based (0 = level I).

pub fn remove_effect(&self, effect_id: &str) -> bool

Remove a single status effect.

pub fn clear_effects(&self) -> bool

Clear all active status effects.

pub fn velocity(&self) -> Option<(f64, f64, f64)>

Current velocity (vx, vy, vz), or None if not loaded.

pub fn set_velocity(&self, vx: f64, vy: f64, vz: f64) -> bool

Set velocity directly (replaces current velocity).

pub fn add_velocity(&self, vx: f64, vy: f64, vz: f64) -> bool

Add an impulse to the current velocity (e.g. launch upward: add_velocity(0, 1, 0)).

pub fn get_nbt(&self) -> Option<String>

SNBT string of the entity’s persistent NBT, or None if not found.

pub fn set_nbt(&self, snbt: &str) -> bool

Merge SNBT data into the entity’s persistent NBT. Returns false if not found.

pub fn attribute_get(&self, attribute_id: &str) -> Option<f64>

Base value of an attribute (e.g. "minecraft:generic.max_health"), or None.

pub fn attribute_set(&self, attribute_id: &str, value: f64) -> bool

Set the base value of an attribute. Returns false if not found.