Struct DataComponentPatch 

pub struct DataComponentPatch {
    pub(super) entries: FxHashMap<Identifier, ComponentPatchEntry>,
}

A patch representing modifications to a DataComponentMap.

Stores differences from a prototype:

• Components that are added or overridden (Set)
• Components that are explicitly removed (Removed)

Fields

entries: FxHashMap<Identifier, ComponentPatchEntry>

Implementations

impl DataComponentPatch

pub fn new() -> Self

pub fn is_empty(&self) -> bool

pub fn len(&self) -> usize

pub fn set<T: Component + DowncastType>( &mut self, component: DataComponentType<T>, value: T, )

Sets a component value in the patch.

pub(crate) fn set_component_data( &mut self, key: Identifier, data: ComponentData, )

pub fn set_raw(&mut self, key: Identifier, data: ComponentData) -> bool

Sets raw component data (for plugin use).

Returns true if the data was set successfully, or false if the key is unregistered or the data type does not match it.

This prevents plugins from setting invalid types on vanilla components.

pub fn remove<T>(&mut self, component: DataComponentType<T>)

Marks a component as removed.

pub fn remove_raw(&mut self, key: Identifier) -> bool

Marks a dynamically resolved component as removed.

pub fn clear<T>(&mut self, component: DataComponentType<T>)

Clears any patch entry for a component.

pub fn get_entry(&self, key: &Identifier) -> Option<&ComponentPatchEntry>

Gets the patch entry for a key.

pub fn is_removed(&self, key: &Identifier) -> bool

Checks if a component is marked as removed.

pub fn count_set(&self) -> usize

Counts set entries.

pub fn count_removed(&self) -> usize

Counts removed entries.

pub fn iter(&self) -> impl Iterator<Item = (&Identifier, &ComponentPatchEntry)>

Iterates over all entries.

pub fn apply(&mut self, added: &Self)

Applies another patch after this one, giving the added patch precedence.

pub(crate) fn sanitize_against(&mut self, prototype: &DataComponentMap)

impl DataComponentPatch

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

Reads a patch where each component value is prefixed with a VarInt byte length.

Vanilla uses this for untrusted client packets (e.g., creative mode slot) via DataComponentPatch.DELIMITED_STREAM_CODEC.

impl DataComponentPatch

pub(crate) fn compute_single_extracted_hash<T: HashComponent>( key: &Identifier, value: &T, ) -> i32

Computes the persistent map hash for one build-time validated component without consulting the not-yet-published global registry.

pub fn compute_persistent_hash(&self) -> Result<i32>

Computes Vanilla’s HashOps value for the persistent patch codec.

pub fn iter_removed(&self) -> impl Iterator<Item = &Identifier>

Iterates over removed component keys.

fn encode_nbt(&self, validate: bool) -> (OwnedNbtTag, Vec<Error>)

pub fn try_to_nbt_tag_ref(&self) -> Result<OwnedNbtTag>

Strictly encodes this component patch through its persistent codecs.

This is the equivalent of Vanilla encoding an untrusted stack through ItemStack.CODEC before accepting it into server state.

pub fn to_nbt_tag_ref(&self) -> OwnedNbtTag

Converts this component patch to NBT without consuming it.

Save-time encoding mirrors Vanilla’s TagValueOutput: invalid fields are reported and omitted from the partial result rather than aborting the owner save.

Trait Implementations

impl Clone for DataComponentPatch

fn clone(&self) -> DataComponentPatch

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DataComponentPatch

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

Formats the value using the given formatter.

impl Default for DataComponentPatch

fn default() -> DataComponentPatch

Returns the “default value” for a type.

impl EmbeddedNbtCodec for &DataComponentPatch

type Error = Error

fn encode_embedded_nbt(self) -> Result<OwnedNbtTag>

impl FromNbtTag for DataComponentPatch

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

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

impl PartialEq for DataComponentPatch

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

Equality operator ==.

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

Inequality operator !=.

impl ReadFrom for DataComponentPatch

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

Reads data from a cursor.

impl StructuralPartialEq for DataComponentPatch

impl ToNbtTag for DataComponentPatch

fn to_nbt_tag(self) -> OwnedNbtTag

fn to_optional_nbt_tag(self) -> Option<NbtTag>

impl WriteTo for DataComponentPatch

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

Writes data to a writer.