Struct EntityTracker 

pub struct EntityTracker {
    entities: HashMap<i32, TrackedEntity>,
}

World-level entity tracker.

Fields

entities: HashMap<i32, TrackedEntity>

Maps entity ID to its tracking data.

Implementations

impl EntityTracker

pub fn new() -> Self

Creates a new empty entity tracker.

pub fn add( &self, entity: &SharedEntity, get_players_in_chunk: impl Fn(ChunkPos) -> Vec<i32>, get_player: impl Fn(i32) -> Option<Arc<Player>>, )

Starts tracking an entity.

Sends spawn packets to players already watching the entity chunk and inside the vanilla tracking range.

The get_players_in_chunk callback should return player IDs in a given chunk (typically from PlayerAreaMap::get_tracking_players). The get_player callback should resolve a player ID to a Player reference.

Panics

Panics if the entity is removed or is already tracked.

pub fn remove( &self, entity_id: i32, get_player: impl Fn(i32) -> Option<Arc<Player>>, )

Stops tracking an entity and sends despawn to all tracking players.

pub fn update_player( &self, player: &Player, view: &PlayerChunkView, is_chunk_sent: impl Fn(ChunkPos) -> bool, )

Refreshes the tracked-entity set for one player.

Mirrors vanilla TrackedEntity.updatePlayer: each tracked entity checks whether the player tracks the entity chunk, passes the entity-specific broadcast predicate, and is inside the effective horizontal range.

pub fn send_changes<Movement, SelfMovement, EntityData, Attributes, MobEffects, Equipment, Passengers, EntityLink>( &self, get_players_in_chunk: impl Fn(ChunkPos) -> Vec<i32>, get_player: impl Fn(i32) -> Option<Arc<Player>>, senders: EntityChangeSenders<Movement, SelfMovement, EntityData, Attributes, MobEffects, Equipment, Passengers, EntityLink>, )

where Movement: FnMut(i32, EntityMovementSyncPacket), SelfMovement: FnMut(i32, EntityMovementSyncPacket), EntityData: FnMut(i32, Vec<DataValue>), Attributes: FnMut(i32, Vec<AttributeSnapshot>), MobEffects: FnMut(i32, MobEffectSyncPacket), Equipment: FnMut(i32, CSetEquipment), Passengers: FnMut(i32, CSetPassengers), EntityLink: FnMut(i32, CSetEntityLink),

Sends tracker-owned movement changes for all tracked entities.

Mirrors vanilla ChunkMap.tick driving ServerEntity.sendChanges.

pub fn on_player_leave(&self, player: &Player)

Removes a player from every entity pairing and despawns those entities from their client.

Mirrors vanilla ChunkMap.removeEntity calling TrackedEntity.removePlayer for each tracked entity before the player leaves the world.

pub fn on_entity_section_change( &self, entity_id: i32, old_chunk: ChunkPos, new_chunk: ChunkPos, get_players_in_chunk: impl Fn(ChunkPos) -> Vec<i32>, get_player: impl Fn(i32) -> Option<Arc<Player>>, )

Updates an entity’s current chunk and visible players after a section move.

Vanilla refreshes tracked players when an entity’s section position changes. The old and new chunks may be the same for purely vertical section moves.

fn refresh_entity_players( &self, entity_id: i32, get_players_in_chunk: &impl Fn(ChunkPos) -> Vec<i32>, get_player: &impl Fn(i32) -> Option<Arc<Player>>, )

pub fn count(&self) -> usize

Gets the number of tracked entities.

pub fn tracking_player_ids(&self, entity_id: i32) -> Vec<i32>

Returns players currently tracking an entity.

fn remove_dead_entity(&self, entity_id: i32)

fn visible_players_for_entity( entity_id: i32, entity: &dyn Entity, entity_chunk: ChunkPos, tracking_range: EntityTrackingRange, get_players_in_chunk: &impl Fn(ChunkPos) -> Vec<i32>, get_player: &impl Fn(i32) -> Option<Arc<Player>>, ) -> FxHashSet<i32>

fn send_spawn_packets(&self, entity: &SharedEntity, player: &Player)

fn spawn_pairing( &self, entity: &SharedEntity, player_id: i32, ) -> EntitySpawnPairing

fn passenger_pairing_packets_for_player( &self, entity: &dyn Entity, player_id: i32, ) -> Vec<CSetPassengers>

fn vehicle_passenger_packet_for_player( &self, entity: &dyn Entity, player_id: i32, ) -> Option<CSetPassengers>

fn direct_tracked_passenger_ids(&self, entity: &dyn Entity) -> Vec<i32>

fn direct_passenger_ids_seen_by_player( &self, entity: &dyn Entity, player_id: i32, ) -> Vec<i32>

fn is_entity_tracked(&self, entity_id: i32) -> bool

fn entity_seen_by_player(&self, entity_id: i32, player_id: i32) -> bool

Trait Implementations

impl Default for EntityTracker

fn default() -> Self

Returns the “default value” for a type.