Struct ItemStackTemplate 

pub struct ItemStackTemplate {
    item: ItemRef,
    count: i32,
    components: DataComponentPatch,
    components_hash: Option<i32>,
}

A persistable, non-empty item identity, count, and component patch.

Fields

item: ItemRef

count: i32

components: DataComponentPatch

components_hash: Option<i32>

Implementations

impl ItemStackTemplate

pub const MIN_COUNT: i32 = 1

pub const MAX_COUNT: i32 = 99

pub fn new(item: ItemRef) -> Self

Creates the common count-one template with no component changes.

pub fn with_count(item: ItemRef, count: i32) -> Self

Creates a template with a validated persistent count and no component changes.

pub fn try_with_count_and_patch( item: ItemRef, count: i32, components: DataComponentPatch, ) -> Result<Self>

Creates a template after validating its complete persistent codec shape.

pub(crate) fn from_extracted( item: ItemRef, count: i32, components: DataComponentPatch, components_hash: i32, ) -> Self

Constructs a template from build-time validated Vanilla extractor data.

This avoids persistent codec validation during registry bootstrap because registry-aware component codecs cannot consult REGISTRY until it has been completely built and published.

pub fn from_stack(stack: &ItemStack) -> Result<Self>

Copies a non-empty stack into its immutable template representation.

pub(crate) fn validate_persistent_encoding(&self) -> Result<()>

pub const fn item(&self) -> ItemRef

pub const fn count(&self) -> i32

pub const fn components(&self) -> &DataComponentPatch

pub fn create(&self) -> ItemStack

pub fn apply( &self, count: i32, additional_components: &DataComponentPatch, ) -> ItemStack

Creates this template over an existing component patch, matching Vanilla’s ItemStackTemplate.apply precedence rules.

pub fn to_hover_event(&self) -> Result<HoverEvent>

Creates the Vanilla hover event for this item template.

pub(crate) fn to_nbt_tag_ref(&self) -> NbtTag

pub(crate) fn from_nbt_identifier(value: &str) -> Option<Self>

pub(crate) fn from_nbt_compound(compound: NbtCompound<'_, '_>) -> Option<Self>

fn from_stream( item: ItemRef, count: i32, components: DataComponentPatch, ) -> Result<Self>

pub fn get_effective_value_raw( &self, key: &Identifier, ) -> Option<&ComponentData>

Gets the effective raw component value from the patch or item prototype.

pub fn get<T: Component + DowncastType>( &self, component: DataComponentType<T>, ) -> Option<&T>

Gets an effective typed component value from the patch or item prototype.

pub(crate) fn max_stack_size(&self) -> i32

Trait Implementations

impl Clone for ItemStackTemplate

fn clone(&self) -> ItemStackTemplate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ItemStackTemplate

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromNbtTag for ItemStackTemplate

fn from_nbt_tag(tag: NbtTag<'_, '_>) -> Option<Self>

fn from_optional_nbt_tag( tag: Option<NbtTag<'_, '_>>, ) -> Result<Option<Self>, DeserializeError>

impl HashComponent for ItemStackTemplate

fn hash_component(&self, hasher: &mut ComponentHasher)

Hashes this value into the given hasher.

fn compute_hash(&self) -> i32

Computes the hash of this value.

impl PartialEq for ItemStackTemplate

fn eq(&self, other: &ItemStackTemplate) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl ReadFrom for ItemStackTemplate

fn read(data: &mut Cursor<&[u8]>) -> Result<Self>

Reads data from a cursor.

impl StructuralPartialEq for ItemStackTemplate

impl ToNbtTag for ItemStackTemplate

fn to_nbt_tag(self) -> NbtTag

fn to_optional_nbt_tag(self) -> Option<NbtTag>

impl WriteTo for ItemStackTemplate

fn write(&self, writer: &mut impl Write) -> Result<()>

Writes data to a writer.