Package org.spongepowered.api.entity.living.player

Interface CooldownTracker

public interface CooldownTracker
Provides access to the item cooldowns of a Player.

  • Method Details

    • hasCooldown

      boolean hasCooldown(ItemType type)
      Checks if the specified ItemType is currently on cooldown for the player.
      Parameters:
      type - The item type to check is on cooldown
      Returns:
      Whether or not the specified item type is cooldown

    • cooldown

      Optional<Ticks> cooldown(ItemType type)
      Gets the cooldown of the specified ItemType in ticks for the player, or empty if the the item type is currently not on cooldown.
      Parameters:
      type - The item type to get the cooldown for
      Returns:
      The cooldown remaining for this item type in ticks, if not on cooldown

    • setCooldown

      boolean setCooldown(ItemType type, Ticks ticks)
      Sets the cooldown for the specified ItemType for the specified amount of ticks.
      Parameters:
      type - The item type to set the cooldown for
      ticks - The amount of ticks to set the item type on cooldown for
      Returns:
      False if setting the cooldown failed, possibly due to the event being cancelled

    • resetCooldown

      boolean resetCooldown(ItemType type)
      Resets the cooldown of the specified ItemType for the player.
      Parameters:
      type - The item type to reset the cooldown for
      Returns:
      False if setting the cooldown failed, possibly due to the event being cancelled

    • fractionRemaining

      OptionalDouble fractionRemaining(ItemType type)
      Gets the fraction of the specified ItemType's cooldown that is remaining for the player, or empty if the the item type is currently not on cooldown.

      If present, this value will be between 0.0 and 1.0.

      Parameters:
      type - The item type to get the cooldown fraction remaining
      Returns:
      The fraction of cooldown remaining for the specified item type