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.

  • Constructor Details

    • PotionEffect

      public PotionEffect​(@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 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 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 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(PotionEffectType, int, int, boolean)

    • PotionEffect

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

  • Method Details

    • serialize

      @NotNull public 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.

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

    • apply

      public boolean apply​(@NotNull LivingEntity entity)
      Attempts to add the effect represented by this object to the given LivingEntity.
      Parameters:
      entity - The entity to add this effect to
      Returns:
      Whether the effect could be added
      See Also:
      LivingEntity.addPotionEffect(PotionEffect)

    • 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

    • getType

      @NotNull public 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 @Nullable @Contract("-> null") public 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