Struct PlayerMap 

pub struct PlayerMap {
    by_uuid: HashMap<Uuid, Arc<Player>>,
    by_entity_id: HashMap<i32, Arc<Player>>,
    order: SyncMutex<Vec<Uuid>>,
}

Thread-safe player storage with dual indexing.

Maintains two synchronized maps for O(1) lookup by either UUID or entity ID. All operations keep both maps in sync automatically.

Fields

by_uuid: HashMap<Uuid, Arc<Player>>

Primary index by UUID (persistent identifier)

by_entity_id: HashMap<i32, Arc<Player>>

Secondary index by entity ID (session-local identifier)

order: SyncMutex<Vec<Uuid>>

Player UUIDs in insertion order for vanilla-visible iteration.

Implementations

impl PlayerMap

pub fn new() -> Self

Creates a new empty player map.

pub fn insert(&self, player: Arc<Player>) -> bool

Inserts a player into both maps.

Returns true if the player was inserted, false if a player with the same UUID already exists.

Panics

Panics if another player already has the same entity ID. Entity IDs are session-unique; accepting a duplicate would break entity lookup and packet routing invariants.

pub async fn remove(&self, uuid: &Uuid) -> Option<Arc<Player>>

Removes a player by UUID from both maps.

Returns the removed player if found.

pub async fn remove_player(&self, player: &Arc<Player>) -> Option<Arc<Player>>

Removes this exact player from both maps.

Returns the removed player if the UUID still maps to this same player handle. A stale duplicate-login cleanup must not remove the accepted player that owns the UUID.

pub fn remove_sync(&self, uuid: &Uuid) -> Option<Arc<Player>>

Removes a player by UUID from both maps synchronously.

Returns the removed player if found. Use this when async is not available (e.g., during world changes on the tick thread).

pub fn remove_player_sync(&self, player: &Arc<Player>) -> Option<Arc<Player>>

Removes this exact player from both maps synchronously.

pub fn get_by_uuid(&self, uuid: &Uuid) -> Option<Arc<Player>>

Gets a player by UUID.

pub fn get_by_entity_id(&self, entity_id: i32) -> Option<Arc<Player>>

Gets a player by entity ID.

pub fn iter_players<F>(&self, f: F)

where F: FnMut(&Uuid, &Arc<Player>) -> bool,

Iterates over all players.

The callback returns true to continue iteration, false to stop.

pub fn len(&self) -> usize

Returns the number of players.

pub fn is_empty(&self) -> bool

Returns true if there are no players.

Trait Implementations

impl Default for PlayerMap

fn default() -> Self

Returns the “default value” for a type.