Package org.bukkit.potion

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.
      use Iterable.iterator().
      Returns:
      an array of all known PotionEffectTypes.