Module net.minestom.server

Package net.minestom.server.entity.attribute

Class AttributeInstance

java.lang.Object

net.minestom.server.entity.attribute.AttributeInstance

public final class AttributeInstance
extends Object

Represents an instance of an attribute and its modifiers. This class is thread-safe (you do not need to acquire the entity to modify its attributes).

Field Summary

Fields

Modifier and Type	Field	Description
static final NetworkBuffer.Type<AttributeInstance>	NETWORK_TYPE

Constructor Summary

Constructors

Constructor	Description
AttributeInstance(Attribute attribute, double baseValue, Collection<AttributeModifier> modifiers, @Nullable Consumer<AttributeInstance> listener)
AttributeInstance(Attribute attribute, @Nullable Consumer<AttributeInstance> listener)

Method Summary

Modifier and Type	Method	Description
AttributeModifier	addModifier(AttributeModifier modifier)	Add a modifier to this instance.
double	applyModifiers(double baseValue)	Gets the value of this instance, calculated assuming the given baseValue.
Attribute	attribute()	Gets the attribute associated to this instance.
void	clearModifiers()	Clears all modifiers on this instance, excepting those whose ID is defined in LivingEntity.PROTECTED_MODIFIERS.
Attribute	getAttribute()	Deprecated.
double	getBaseValue()	The base value of this instance without modifiers
Collection<AttributeModifier>	getModifiers()	Deprecated.
double	getValue()	Gets the value of this instance calculated with modifiers applied.
@UnmodifiableView Collection<AttributeModifier>	modifiers()	Get the modifiers applied to this instance.
AttributeModifier	removeModifier(net.kyori.adventure.key.Key id)	Remove a modifier from this instance.
AttributeModifier	removeModifier(AttributeModifier modifier)	Remove a modifier from this instance.
void	setBaseValue(double baseValue)	Sets the base value of this instance.

Methods inherited from class java.lang.Object

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

Field Details

NETWORK_TYPE

public static final NetworkBuffer.Type<AttributeInstance> NETWORK_TYPE

Constructor Details

AttributeInstance

public AttributeInstance(Attribute attribute,
 @Nullable
 @Nullable Consumer<AttributeInstance> listener)

AttributeInstance

public AttributeInstance(Attribute attribute,
 double baseValue,
 Collection<AttributeModifier> modifiers,
 @Nullable
 @Nullable Consumer<AttributeInstance> listener)

Method Details

attribute

public Attribute attribute()

Gets the attribute associated to this instance.

Returns:

the associated attribute

getBaseValue

public double getBaseValue()

The base value of this instance without modifiers

Returns:

the instance base value

See Also:

• setBaseValue(double)

setBaseValue

public void setBaseValue(double baseValue)

Sets the base value of this instance.

Parameters:

baseValue - the new base value

See Also:

• getBaseValue()

modifiers

public @UnmodifiableView Collection<AttributeModifier> modifiers()

Get the modifiers applied to this instance.

Returns:

an immutable collection of the modifiers applied to this attribute.

addModifier

public AttributeModifier addModifier(AttributeModifier modifier)

Add a modifier to this instance.

Parameters:

modifier - the modifier to add

Returns:

the old modifier, or null if none

removeModifier

public AttributeModifier removeModifier(AttributeModifier modifier)

Remove a modifier from this instance.

Parameters:

modifier - the modifier to remove

Returns:

the modifier that was removed, or null if none

clearModifiers

public void clearModifiers()

Clears all modifiers on this instance, excepting those whose ID is defined in LivingEntity.PROTECTED_MODIFIERS.

removeModifier

public AttributeModifier removeModifier(net.kyori.adventure.key.Key id)

Remove a modifier from this instance.

Parameters:

id - The namespace id of the modifier to remove

Returns:

the modifier that was removed, or null if none

getValue

public double getValue()

Gets the value of this instance calculated with modifiers applied.

Returns:

the attribute value

applyModifiers

public double applyModifiers(double baseValue)

Gets the value of this instance, calculated assuming the given baseValue.

Parameters:

baseValue - the value to be used as the base for this operation, rather than this instance's normal base value

Returns:

the attribute value

getModifiers

@Deprecated
public Collection<AttributeModifier> getModifiers()

Deprecated.

getAttribute

@Deprecated
public Attribute getAttribute()

Deprecated.