Scripting for Item Attributes, Controller, ItemStack, IPlayer

This commit is contained in:
Kam committed 2025-03-14 05:35:07 -04:00
1 parent c7a74a3e0e
commit dfa15687d0
6 files changed
+432 -35

No files matched your search

@@ -0,0 +1,49 @@
package noppes.npcs.api.handler.data;
import noppes.npcs.api.entity.IPlayer;
/**
* Represents a collection of a player's custom attributes.
* <p>
* Expose methods to retrieve all attribute instances as an array, look up individual attributes by key,
* and check for the presence of a specific attribute.
* </p>
*/
public interface IPlayerAttributes {
/**
* Recalulates Item Attributes on a Player
*/
void recalculate(IPlayer player);
/**
* Returns an array of all custom attribute instances associated with the player.
*
* @return an array of {@link ICustomAttribute} objects
*/
ICustomAttribute[] getAttributes();
/**
* Returns the value of the attribute identified by the given key.
*
* @param key the attribute key (e.g., "health", "movement_speed")
* @return the float value of the attribute, or 0 if the attribute is not found
*/
float getAttributeValue(String key);
/**
* Checks whether an attribute with the given key exists.
*
* @param key the attribute key to check
* @return true if the attribute exists, false otherwise
*/
boolean hasAttribute(String key);
/**
* Returns the custom attribute instance identified by the given key.
*
* @param key the attribute key (e.g., "health", "movement_speed")
* @return the corresponding {@link ICustomAttribute} instance, or null if not found
*/
ICustomAttribute getAttribute(String key);
}