Struct EntityReference 

pub struct EntityReference {
    uuid: Uuid,
    cached: Arc<SyncMutex<Option<WeakEntity>>>,
}

A UUID reference that re-resolves removed entities within the same domain.

Its cache is weak to avoid entity ownership cycles.

Fields

uuid: Uuid

cached: Arc<SyncMutex<Option<WeakEntity>>>

Implementations

impl EntityReference

pub fn from_uuid(uuid: Uuid) -> Self

Creates an unresolved reference from a persisted UUID.

pub fn from_entity(entity: &SharedEntity) -> Self

Creates a reference with a weak cache of a live entity.

pub fn read(nbt: &BorrowedNbtCompoundView<'_, '_>, key: &str) -> Option<Self>

Reads a UUID reference; absent or malformed values have no reference.

pub fn store(&self, nbt: &mut NbtCompound, key: &str)

Stores the UUID as an NBT int array.

pub const fn uuid(&self) -> Uuid

Returns the persistent referenced UUID.

pub fn cache_entity(&self, entity: &SharedEntity)

Caches an entity only when its UUID matches this reference.

pub fn get_entity(&self, world: &World) -> Option<SharedEntity>

Resolves a live cache, then the UUID in any loaded world in this domain.

Trait Implementations

impl Clone for EntityReference

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.