CustomNPC-Plus-API/java/noppes/npcs/api/handler/data/ICustomAttribute.java

package noppes.npcs.api.handler.data;

/**
 * Represents an instance of a custom attribute.
 * <p>
 * A custom attribute instance encapsulates an {@link IAttributeDefinition}
 * along with its current calculated value (which may be affected by modifiers).
 * </p>
 */
public interface ICustomAttribute {

    /**
     * Returns the attribute definition associated with this custom attribute.
     *
     * @return the {@link IAttributeDefinition} instance defining this attribute
     */
    IAttributeDefinition getAttribute();

    /**
     * Returns the current value of this attribute.
     *
     * @return the float value representing the attribute's current state
     */
    float getValue();
}