Struct PlacementSource 

pub struct PlacementSource<'a> {
    player: Option<&'a Player>,
    hand: InteractionHand,
    item: PlacementItemSource<'a>,
    orientation: PlacementOrientation,
    is_secondary_use_active: bool,
}

Player and item data retained across one block placement operation.

Player-backed access deliberately re-resolves the selected hand under short inventory locks. The stack may therefore change between accesses; retaining one inventory guard across behavior dispatch could deadlock callbacks which open a menu. Direct access retains the exact borrowed stack for the whole operation.

Fields

player: Option<&'a Player>

hand: InteractionHand

item: PlacementItemSource<'a>

orientation: PlacementOrientation

is_secondary_use_active: bool

Implementations

impl<'a> PlacementSource<'a>

pub fn player_hand(player: &'a Player, inv: &InventoryAccess) -> Self

Creates a placement source backed by a player’s live hand.

pub const fn direct( player: Option<&'a Player>, hand: InteractionHand, stack: &'a mut ItemStack, orientation: PlacementOrientation, is_secondary_use_active: bool, ) -> Self

Creates a source backed by a directly borrowed stack.

pub const fn player(&self) -> Option<&Player>

Returns the player associated with this source, if any.

pub const fn hand(&self) -> InteractionHand

Returns the interaction hand associated with this source.

pub fn with_item<R>(&self, f: impl FnOnce(&ItemStack) -> R) -> R

Runs f with read access to this source’s current stack.

pub fn with_item_mut<R>(&mut self, f: impl FnOnce(&mut ItemStack) -> R) -> R

Runs f with mutable access to this source’s current stack.