71 lines
1.5 KiB
Java
71 lines
1.5 KiB
Java
package org.bukkit.attribute;
|
|
|
|
import java.util.Collection;
|
|
import org.jetbrains.annotations.NotNull;
|
|
|
|
/**
|
|
* Represents a mutable instance of an attribute and its associated modifiers
|
|
* and values.
|
|
*/
|
|
public interface AttributeInstance {
|
|
|
|
/**
|
|
* The attribute pertaining to this instance.
|
|
*
|
|
* @return the attribute
|
|
*/
|
|
@NotNull
|
|
Attribute getAttribute();
|
|
|
|
/**
|
|
* Base value of this instance before modifiers are applied.
|
|
*
|
|
* @return base value
|
|
*/
|
|
double getBaseValue();
|
|
|
|
/**
|
|
* Set the base value of this instance.
|
|
*
|
|
* @param value new base value
|
|
*/
|
|
void setBaseValue(double value);
|
|
|
|
/**
|
|
* Get all modifiers present on this instance.
|
|
*
|
|
* @return a copied collection of all modifiers
|
|
*/
|
|
@NotNull
|
|
Collection<AttributeModifier> getModifiers();
|
|
|
|
/**
|
|
* Add a modifier to this instance.
|
|
*
|
|
* @param modifier to add
|
|
*/
|
|
void addModifier(@NotNull AttributeModifier modifier);
|
|
|
|
/**
|
|
* Remove a modifier from this instance.
|
|
*
|
|
* @param modifier to remove
|
|
*/
|
|
void removeModifier(@NotNull AttributeModifier modifier);
|
|
|
|
/**
|
|
* Get the value of this instance after all associated modifiers have been
|
|
* applied.
|
|
*
|
|
* @return the total attribute value
|
|
*/
|
|
double getValue();
|
|
|
|
/**
|
|
* Gets the default value of the Attribute attached to this instance.
|
|
*
|
|
* @return server default value
|
|
*/
|
|
double getDefaultValue();
|
|
}
|