Class PotionEffectType

java.lang.Object
org.bukkit.potion.PotionEffectType
All Implemented Interfaces:
Keyed, Translatable
Direct Known Subclasses:
PotionEffectTypeWrapper

public abstract class PotionEffectType extends Object implements Keyed, Translatable
Represents a type of potion and its effect on an entity.
  • Field Details

    • SPEED

      public static final PotionEffectType SPEED
      Increases movement speed.
    • SLOWNESS

      public static final PotionEffectType SLOWNESS
      Decreases movement speed.
    • HASTE

      public static final PotionEffectType HASTE
      Increases dig speed.
    • MINING_FATIGUE

      public static final PotionEffectType MINING_FATIGUE
      Decreases dig speed.
    • STRENGTH

      public static final PotionEffectType STRENGTH
      Increases damage dealt.
    • INSTANT_HEALTH

      public static final PotionEffectType INSTANT_HEALTH
      Heals an entity.
    • INSTANT_DAMAGE

      public static final PotionEffectType INSTANT_DAMAGE
      Hurts an entity.
    • JUMP_BOOST

      public static final PotionEffectType JUMP_BOOST
      Increases jump height.
    • NAUSEA

      public static final PotionEffectType NAUSEA
      Warps vision on the client.
    • REGENERATION

      public static final PotionEffectType REGENERATION
      Regenerates health.
    • RESISTANCE

      public static final PotionEffectType RESISTANCE
      Decreases damage dealt to an entity.
    • FIRE_RESISTANCE

      public static final PotionEffectType FIRE_RESISTANCE
      Stops fire damage.
    • WATER_BREATHING

      public static final PotionEffectType WATER_BREATHING
      Allows breathing underwater.
    • INVISIBILITY

      public static final PotionEffectType INVISIBILITY
      Grants invisibility.
    • BLINDNESS

      public static final PotionEffectType BLINDNESS
      Blinds an entity.
    • NIGHT_VISION

      public static final PotionEffectType NIGHT_VISION
      Allows an entity to see in the dark.
    • HUNGER

      public static final PotionEffectType HUNGER
      Increases hunger.
    • WEAKNESS

      public static final PotionEffectType WEAKNESS
      Decreases damage dealt by an entity.
    • POISON

      public static final PotionEffectType POISON
      Deals damage to an entity over time.
    • WITHER

      public static final PotionEffectType WITHER
      Deals damage to an entity over time and gives the health to the shooter.
    • HEALTH_BOOST

      public static final PotionEffectType HEALTH_BOOST
      Increases the maximum health of an entity.
    • ABSORPTION

      public static final PotionEffectType ABSORPTION
      Increases the maximum health of an entity with health that cannot be regenerated, but is refilled every 30 seconds.
    • SATURATION

      public static final PotionEffectType SATURATION
      Increases the food level of an entity each tick.
    • GLOWING

      public static final PotionEffectType GLOWING
      Outlines the entity so that it can be seen from afar.
    • LEVITATION

      public static final PotionEffectType LEVITATION
      Causes the entity to float into the air.
    • LUCK

      public static final PotionEffectType LUCK
      Loot table luck.
    • UNLUCK

      public static final PotionEffectType UNLUCK
      Loot table unluck.
    • SLOW_FALLING

      public static final PotionEffectType SLOW_FALLING
      Slows entity fall rate.
    • CONDUIT_POWER

      public static final PotionEffectType CONDUIT_POWER
      Effects granted by a nearby conduit. Includes enhanced underwater abilities.
    • DOLPHINS_GRACE

      public static final PotionEffectType DOLPHINS_GRACE
      Increses underwater movement speed.
      Squee'ek uh'k kk'kkkk squeek eee'eek.
    • BAD_OMEN

      public static final PotionEffectType BAD_OMEN
      Triggers an ominous event when the player enters a village or trial chambers.
      oof.
    • HERO_OF_THE_VILLAGE

      public static final PotionEffectType HERO_OF_THE_VILLAGE
      Reduces the cost of villager trades.
      \o/.
    • DARKNESS

      public static final PotionEffectType DARKNESS
      Causes the player's vision to dim occasionally.
    • TRIAL_OMEN

      public static final PotionEffectType TRIAL_OMEN
      Causes trial spawners to become ominous.
    • RAID_OMEN

      public static final PotionEffectType RAID_OMEN
      Triggers a raid when a player enters a village.
    • WIND_CHARGED

      public static final PotionEffectType WIND_CHARGED
      Emits a wind burst upon death.
    • WEAVING

      public static final PotionEffectType WEAVING
      Creates cobwebs upon death.
    • OOZING

      public static final PotionEffectType OOZING
      Causes slimes to spawn upon death.
    • INFESTED

      public static final PotionEffectType INFESTED
      Chance of spawning silverfish when hurt.
  • Constructor Details

    • PotionEffectType

      public PotionEffectType()
  • Method Details

    • createEffect

      @NotNull public abstract PotionEffect createEffect(int duration, int amplifier)
      Creates a PotionEffect from this PotionEffectType, applying duration modifiers and checks.
      Parameters:
      duration - time in ticks
      amplifier - the effect's amplifier
      Returns:
      a resulting potion effect
      See Also:
    • isInstant

      public abstract boolean isInstant()
      Returns whether the effect of this type happens once, immediately.
      Returns:
      whether this type is normally instant
    • getCategory

      @NotNull public abstract PotionEffectTypeCategory getCategory()
      Returns the category of this effect type.
      Returns:
      the category
    • getColor

      @NotNull public abstract Color getColor()
      Returns the color of this effect type.
      Returns:
      the color
    • getDurationModifier

      @Deprecated public abstract double getDurationModifier()
      Deprecated.
      unused, always 1.0
      Returns the duration modifier applied to effects of this type.
      Returns:
      duration modifier
    • getId

      @Deprecated public abstract int getId()
      Deprecated.
      Magic value
      Returns the unique ID of this type.
      Returns:
      Unique ID
    • getName

      @NotNull @Deprecated public abstract String getName()
      Deprecated.
      only for backwards compatibility, use Keyed.getKey() instead.
      Returns the name of this effect type.
      Returns:
      The name of this effect type
    • getByKey

      @Contract("null -> null") @Nullable @Deprecated public static PotionEffectType getByKey(@Nullable NamespacedKey key)
      Deprecated.
      only for backwards compatibility, use Registry.get(NamespacedKey) instead.
      Gets the PotionEffectType at the specified key
      Parameters:
      key - key to fetch
      Returns:
      Resulting PotionEffectType, or null if not found
    • getById

      @Deprecated @Nullable public static PotionEffectType getById(int id)
      Deprecated.
      Magic value
      Gets the effect type specified by the unique id.
      Parameters:
      id - Unique ID to fetch
      Returns:
      Resulting type, or null if not found.
    • getByName

      @Nullable @Deprecated public static PotionEffectType getByName(@NotNull String name)
      Deprecated.
      only for backwards compatibility, use Registry.get(NamespacedKey) instead.
      Gets the effect type specified by the given name.
      Parameters:
      name - Name of PotionEffectType to fetch
      Returns:
      Resulting PotionEffectType, or null if not found.
    • values

      @NotNull @Deprecated public static PotionEffectType[] values()
      Deprecated.
      Returns:
      an array of all known PotionEffectTypes.