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(Class, EntityDataSerializer) to register a piece of data for your entity class. Use

invalid reference

#define

during

invalid reference

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
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

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

Method Summary

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

Methods inherited from class 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

private 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

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

Method Details

defineId

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

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> accessor)

get

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

Get the value of the given key for this entity.

set

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

Set the value of the given key for this entity.

set

public <T> void set(EntityDataAccessor<T> accessor,
 T value,
 boolean forceDirty)

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<?>> items)

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> dataItem,
 SynchedEntityData.DataValue<?> item)