Package net.minecraft.network.syncher

Class SynchedEntityData

java.lang.Object

net.minecraft.network.syncher.SynchedEntityData

public class SynchedEntityData
extends Object

Keeps data in sync from server to client for an entity. A maximum of 254 parameters per entity class can be registered. The system then ensures that these values are updated on the client whenever they change on the server. Use defineId(java.lang.Class<? extends net.minecraft.network.syncher.SyncedDataHolder>, net.minecraft.network.syncher.EntityDataSerializer<T>) to register a piece of data for your entity class. Use SynchedEntityData.Builder.define(net.minecraft.network.syncher.EntityDataAccessor<T>, T) during Entity#defineSynchedData to set the default value for a given parameter.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SynchedEntityData.Builder
static class	SynchedEntityData.DataItem<T>
static final record	SynchedEntityData.DataValue<T>

Field Summary

Fields

Modifier and Type	Field	Description
private final SyncedDataHolder	entity
(package private) static final ClassTreeIdRegistry	ID_REGISTRY
private boolean	isDirty
private final SynchedEntityData.DataItem<?>[]	itemsById
private static final org.slf4j.Logger	LOGGER
private static final int	MAX_ID_VALUE
private static final StackWalker	STACK_WALKER

Constructor Summary

Constructors

Constructor	Description
SynchedEntityData(SyncedDataHolder entity, SynchedEntityData.DataItem<?>[] itemsById)

Method Summary

Modifier and Type	Method	Description
private <T> void	assignValue(SynchedEntityData.DataItem<T> target, SynchedEntityData.DataValue<?> entry)
void	assignValues(List<SynchedEntityData.DataValue<?>> entries)	Updates the data using the given entries.
static <T> EntityDataAccessor<T>	defineId(Class<? extends SyncedDataHolder> clazz, EntityDataSerializer<T> serializer)	Register a piece of data to be kept in sync for an entity class.
<T> T	get(EntityDataAccessor<T> key)	Get the value of the given key for this entity.
private <T> SynchedEntityData.DataItem<T>	getItem(EntityDataAccessor<T> key)
@Nullable List<SynchedEntityData.DataValue<?>>	getNonDefaultValues()
boolean	isDirty()
@Nullable List<SynchedEntityData.DataValue<?>>	packDirty()
<T> void	set(EntityDataAccessor<T> key, T value)	Set the value of the given key for this entity.
<T> void	set(EntityDataAccessor<T> key, T value, boolean force)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

LOGGER

private static final org.slf4j.Logger LOGGER

MAX_ID_VALUE

private static final int MAX_ID_VALUE

See Also:

• Constant Field Values

ID_REGISTRY

static final ClassTreeIdRegistry ID_REGISTRY

entity

private final SyncedDataHolder entity

itemsById

private final SynchedEntityData.DataItem<?>[] itemsById

isDirty

private boolean isDirty

STACK_WALKER

private static final StackWalker STACK_WALKER

Constructor Details

SynchedEntityData

SynchedEntityData(SyncedDataHolder entity,
 SynchedEntityData.DataItem<?>[] itemsById)

Method Details

defineId

public static <T> EntityDataAccessor<T> defineId(Class<? extends SyncedDataHolder> clazz,
 EntityDataSerializer<T> serializer)

Register a piece of data to be kept in sync for an entity class. This method must be called during a static initializer of an entity class and the first parameter of this method must be that entity class.

getItem

private <T> SynchedEntityData.DataItem<T> getItem(EntityDataAccessor<T> key)

get

public <T> T get(EntityDataAccessor<T> key)

Get the value of the given key for this entity.

set

public <T> void set(EntityDataAccessor<T> key,
 T value)

Set the value of the given key for this entity.

set

public <T> void set(EntityDataAccessor<T> key,
 T value,
 boolean force)

isDirty

public boolean isDirty()

packDirty

public @Nullable List<SynchedEntityData.DataValue<?>> packDirty()

getNonDefaultValues

public @Nullable List<SynchedEntityData.DataValue<?>> getNonDefaultValues()

assignValues

public void assignValues(List<SynchedEntityData.DataValue<?>> entries)

Updates the data using the given entries. Used on the client when the update packet is received.

assignValue

private <T> void assignValue(SynchedEntityData.DataItem<T> target,
 SynchedEntityData.DataValue<?> entry)