Struct ContainerRef 

pub struct ContainerRef {
    id: ContainerId,
    source: SharedContainer,
    owner: Option<Arc<BlockEntityBase>>,
}

A reference to a container that can be locked.

The optional owner is notified only after all container locks have been released at the corresponding Vanilla setChanged boundary.

Fields

id: ContainerId

source: SharedContainer

owner: Option<Arc<BlockEntityBase>>

Implementations

impl ContainerRef

pub fn from_block_entity(block_entity: SharedBlockEntity) -> Option<Self>

Creates a ContainerRef from a block entity, if it implements Container.

Returns None if the block entity has no container capability.

pub fn owned_by_block_entity( container: SharedContainer, owner: Arc<BlockEntityBase>, ) -> Self

Creates a container capability owned by the block entity whose unique base is returned from its crate::block_entity::BlockEntity::base.

The container implementation must obey Container’s storage-local locking contract. This owner performs block-entity and comparator notifications after all container locks are released.

pub const fn container_id(&self) -> ContainerId

Returns a unique identifier for this container based on its Arc pointer address.

pub fn still_valid(&self, player: &Player) -> bool

Checks container access without locking its item storage.

fn lock(&self) -> LockedContainer

Locks this container and returns a guard.

Trait Implementations

impl Clone for ContainerRef

fn clone(&self) -> ContainerRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> From<&Arc<Mutex<RawMutex, T>>> for ContainerRef

where T: Container + 'static,

fn from(container: &Shared<T>) -> Self

Converts to this type from the input type.

impl From<&Arc<Mutex<RawMutex, dyn Container>>> for ContainerRef

fn from(container: &SharedContainer) -> Self

Converts to this type from the input type.

impl From<&ContainerRef> for ContainerRef

fn from(r: &ContainerRef) -> Self

Converts to this type from the input type.

impl<T> From<Arc<Mutex<RawMutex, T>>> for ContainerRef

where T: Container + 'static,

fn from(container: Shared<T>) -> Self

Converts to this type from the input type.

impl From<Arc<Mutex<RawMutex, dyn Container>>> for ContainerRef

fn from(container: SharedContainer) -> Self

Converts to this type from the input type.