Class EntityAttributeChangeEvent

java.lang.Object
org.bukkit.event.Event
com.github.darksoulq.abyssallib.server.event.custom.entity.EntityAttributeChangeEvent
All Implemented Interfaces:
org.bukkit.event.Cancellable
public class EntityAttributeChangeEvent extends org.bukkit.event.Event implements org.bukkit.event.Cancellable
An event called when an entity's base attribute value is changed. This event is Cancellable, allowing listeners to prevent the change or modify the new value before it is persisted to the database.

  • Nested Class Summary

    Nested classes/interfaces inherited from class org.bukkit.event.Event

    org.bukkit.event.Event.Result

  • Constructor Summary

    Constructors
    Constructor
    Description
    EntityAttributeChangeEvent(@NotNull org.bukkit.entity.Entity entity, @NotNull Attribute attribute, double oldValue, double newValue)
    Constructs a new EntityAttributeChangeEvent.

  • Method Summary

    Modifier and Type
    Method
    Description
    @NotNull Attribute
    getAttribute()
    Retrieves the specific attribute that is being modified.
    @NotNull org.bukkit.entity.Entity
    getEntity()
    Retrieves the entity involved in this attribute change.
    static org.bukkit.event.HandlerList
    getHandlerList()
    Provides a static method to retrieve the handler list, required by Bukkit.
    @NotNull org.bukkit.event.HandlerList
    getHandlers()
    Retrieves the list of handlers listening to this event instance.
    double
    getNewValue()
    Retrieves the proposed new value for the attribute.
    double
    getOldValue()
    Retrieves the value of the attribute prior to this change event.
    boolean
    isCancelled()
    Checks if the attribute change has been cancelled.
    void
    setCancelled(boolean v)
    Sets the cancellation state of the event.
    void
    setNewValue(double newValue)
    Overrides the proposed new value with a different one.

    Methods inherited from class org.bukkit.event.Event

    callEvent, getEventName, isAsynchronous

    Methods inherited from class Object

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

  • Constructor Details

    • EntityAttributeChangeEvent

      public EntityAttributeChangeEvent(@NotNull @NotNull org.bukkit.entity.Entity entity, @NotNull @NotNull Attribute attribute, double oldValue, double newValue)
      Constructs a new EntityAttributeChangeEvent.
      Parameters:
      entity - The Entity instance whose attribute is changing.
      attribute - The Attribute definition being updated.
      oldValue - The previous base value.
      newValue - The proposed new base value.

  • Method Details

    • getEntity

      @NotNull public @NotNull org.bukkit.entity.Entity getEntity()
      Retrieves the entity involved in this attribute change.
      Returns:
      The Entity instance.

    • getAttribute

      @NotNull public @NotNull Attribute getAttribute()
      Retrieves the specific attribute that is being modified.
      Returns:
      The Attribute definition.

    • getOldValue

      public double getOldValue()
      Retrieves the value of the attribute prior to this change event.
      Returns:
      The old base value.

    • getNewValue

      public double getNewValue()
      Retrieves the proposed new value for the attribute.
      Returns:
      The proposed new base value.

    • setNewValue

      public void setNewValue(double newValue)
      Overrides the proposed new value with a different one.
      Parameters:
      newValue - The new base value to apply to the entity.

    • isCancelled

      public boolean isCancelled()
      Checks if the attribute change has been cancelled.
      Specified by:
      isCancelled in interface org.bukkit.event.Cancellable
      Returns:
      True if the event is cancelled, preventing the value update.

    • setCancelled

      public void setCancelled(boolean v)
      Sets the cancellation state of the event.
      Specified by:
      setCancelled in interface org.bukkit.event.Cancellable
      Parameters:
      v - True to cancel the change, false to allow it to proceed.

    • getHandlers

      @NotNull public @NotNull org.bukkit.event.HandlerList getHandlers()
      Retrieves the list of handlers listening to this event instance.
      Specified by:
      getHandlers in class org.bukkit.event.Event
      Returns:
      The HandlerList for this event.

    • getHandlerList

      public static org.bukkit.event.HandlerList getHandlerList()
      Provides a static method to retrieve the handler list, required by Bukkit.
      Returns:
      The static HandlerList for this event type.