Struct Item 

pub struct Item {
    pub key: Identifier,
    pub components: DataComponentMap,
    pub craft_remainder: Option<Identifier>,
    pub id: OnceLock<usize>,
}

A Minecraft item type.

Fields

key: Identifier

components: DataComponentMap

craft_remainder: Option<Identifier>

The item key returned when this item is used in crafting (e.g., “bucket” from milk_bucket). Stored as an Identifier to avoid circular reference issues during initialization.

id: OnceLock<usize>

Cached registry ID, set during registration for O(1) lookup on hot paths.

Implementations

impl Item

pub fn new( key: Identifier, item_name: TextComponent, craft_remainder: Option<Identifier>, ) -> Self

Creates an item with Vanilla’s mandatory name and default model components.

pub fn from_block(block: BlockRef, item_name: TextComponent) -> Self

pub fn from_block_custom_name( _block: BlockRef, name: &'static str, item_name: TextComponent, ) -> Self

pub fn builder_set<T: Component + DowncastType>( self, component: DataComponentType<T>, value: Option<T>, ) -> Self

Builder method to set a component on this item. Used during static initialization.

pub fn get_crafting_remainder(&self) -> ItemStack

Returns the item stack that remains after this item is used in crafting. For example, milk_bucket returns an empty bucket.

pub fn has_tag(&'static self, tag: &Identifier) -> bool

Returns true if this item is tagged with the given tag.

Trait Implementations

impl Debug for Item

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

Formats the value using the given formatter.

impl Eq for Item

impl From<&'static Item> for ItemStack

fn from(item: ItemRef) -> Self

Converts to this type from the input type.

impl PartialEq for Item

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

Equality operator ==.

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

Inequality operator !=.

impl RegistryEntry for Item

fn key(&self) -> &Identifier

fn try_id(&self) -> Option<usize>

fn id(&self) -> usize

Panics

impl RegistryHolderSetEntry for Item

const REGISTRY_NAME: &'static str = "item"

Human-readable registry name used in codec errors.

fn holder_set_by_id(id: usize) -> Option<&'static Self>

Looks up an entry by its protocol registry ID.

fn holder_set_by_key(key: &Identifier) -> Option<&'static Self>

Looks up an entry by its registry key.

fn holder_set_tag_exists(tag: &Identifier) -> bool

Returns whether the registry contains this tag.

fn holder_set_tag_contains(entry: &'static Self, tag: &Identifier) -> bool

Returns whether an entry belongs to this tag.