Package org.bukkit.potion

Class PotionEffect

java.lang.Object
org.bukkit.potion.PotionEffect
All Implemented Interfaces:
ConfigurationSerializable
public class PotionEffect extends Object implements ConfigurationSerializable
Represents a potion effect, that can be added to a LivingEntity. A potion effect has a duration that it will last for, an amplifier that will enhance its effects, and a PotionEffectType, that represents its effect on an entity.

  • Field Details

    • INFINITE_DURATION

      public static final int INFINITE_DURATION
      A constant denoting infinite potion duration.
      See Also:

  • Constructor Details

    • PotionEffect

      public PotionEffect(@NotNull @NotNull PotionEffectType type, int duration, int amplifier, boolean ambient, boolean particles, boolean icon)
      Creates a potion effect.
      Parameters:
      type - effect type
      duration - measured in ticks, see getDuration()
      amplifier - the amplifier, see getAmplifier()
      ambient - the ambient status, see isAmbient()
      particles - the particle status, see hasParticles()
      icon - the icon status, see hasIcon()

    • PotionEffect

      public PotionEffect(@NotNull @NotNull PotionEffectType type, int duration, int amplifier, boolean ambient, boolean particles)
      Creates a potion effect with no defined color.
      Parameters:
      type - effect type
      duration - measured in ticks, see getDuration()
      amplifier - the amplifier, see getAmplifier()
      ambient - the ambient status, see isAmbient()
      particles - the particle status, see hasParticles()

    • PotionEffect

      public PotionEffect(@NotNull @NotNull PotionEffectType type, int duration, int amplifier, boolean ambient)
      Creates a potion effect. Assumes that particles are visible
      Parameters:
      type - effect type
      duration - measured in ticks, see getDuration()
      amplifier - the amplifier, see getAmplifier()
      ambient - the ambient status, see isAmbient()

    • PotionEffect

      public PotionEffect(@NotNull @NotNull PotionEffectType type, int duration, int amplifier)
      Creates a potion effect. Assumes ambient is true.
      Parameters:
      type - Effect type
      duration - measured in ticks
      amplifier - the amplifier for the effect
      See Also:

    • PotionEffect

      public PotionEffect(@NotNull @NotNull Map<String,Object> map)
      Constructor for deserialization.
      Parameters:
      map - the map to deserialize from

  • Method Details

    • withType

      @NotNull public @NotNull PotionEffect withType(@NotNull @NotNull PotionEffectType type)

    • withDuration

      @NotNull public @NotNull PotionEffect withDuration(int duration)

    • withAmplifier

      @NotNull public @NotNull PotionEffect withAmplifier(int amplifier)

    • withAmbient

      @NotNull public @NotNull PotionEffect withAmbient(boolean ambient)

    • withParticles

      @NotNull public @NotNull PotionEffect withParticles(boolean particles)

    • withIcon

      @NotNull public @NotNull PotionEffect withIcon(boolean icon)

    • getHiddenPotionEffect

      @Nullable public @Nullable PotionEffect getHiddenPotionEffect()
      Returns the PotionEffect that will become active after the current PotionEffect has run out.

      Note: This value is only applicable to type applied to living entities.

      Returns:
      The hidden PotionEffect.

    • serialize

      @NotNull public @NotNull Map<String,Object> serialize()
      Description copied from interface: ConfigurationSerializable
      Creates a Map representation of this class.

      This class must provide a method to restore this class, as defined in the ConfigurationSerializable interface javadocs. nb: It is not intended for this method to be called directly, this will be called by the ConfigurationSerialization class.

      Specified by:
      serialize in interface ConfigurationSerializable
      Returns:
      Map containing the current state of this class

    • apply

      public boolean apply(@NotNull @NotNull LivingEntity entity)
      Attempts to add the effect represented by this object to the given LivingEntity.

      Note: getHiddenPotionEffect() is ignored when adding the effect to the entity.

      Parameters:
      entity - The entity to add this effect to
      Returns:
      Whether the effect could be added
      See Also:

    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class Object

    • getAmplifier

      public int getAmplifier()
      Returns the amplifier of this effect. A higher amplifier means the potion effect happens more often over its duration and in some cases has more effect on its target.
      Returns:
      The effect amplifier

    • getDuration

      public int getDuration()
      Returns the duration (in ticks) that this effect will run for when applied to a LivingEntity.
      Returns:
      The duration of the effect, or -1 if this effect is infinite
      See Also:

    • isInfinite

      public boolean isInfinite()
      Returns whether or not this potion effect has an infinite duration. Potion effects with infinite durations will display an infinite symbol and never expire unless manually removed.
      Returns:
      whether this duration is infinite or not

    • isShorterThan

      public boolean isShorterThan(@NotNull @NotNull PotionEffect other)
      Returns whether or not this potion effect has a shorter duration than the provided potion effect.

      An infinite duration is considered longer than non-infinite durations. If both potion effects have infinite durations, then neither is shorter than the other and this method will return false.

      Parameters:
      other - the other effect
      Returns:
      true if this effect is shorter than the other, false if longer or equal

    • getType

      @NotNull public @NotNull PotionEffectType getType()
      Returns the PotionEffectType of this effect.
      Returns:
      The potion type of this effect

    • isAmbient

      public boolean isAmbient()
      Makes potion effect produce more, translucent, particles.
      Returns:
      if this effect is ambient

    • hasParticles

      public boolean hasParticles()
      Returns:
      whether this effect has particles or not

    • getColor

      @Deprecated(since="1.13") @Nullable @Contract("-> null") public @Nullable Color getColor()
      Deprecated.
      color is not part of potion effects
      Returns:
      color of this potion's particles. May be null if the potion has no particles or defined color.

    • hasIcon

      public boolean hasIcon()
      Returns:
      whether this effect has an icon or not

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • toString

      public String toString()
      Overrides:
      toString in class Object