Package org.bukkit.potion

Class PotionEffectType

java.lang.Object

org.bukkit.potion.PotionEffectType

All Implemented Interfaces:

Keyed, RegistryAware, Translatable

Direct Known Subclasses:

PotionEffectTypeWrapper

public abstract class PotionEffectType
extends Object
implements Keyed, Translatable, RegistryAware

Represents a type of potion and its effect on an entity.

Field Summary

Fields

Modifier and Type	Field	Description
static final PotionEffectType	ABSORPTION	Increases the maximum health of an entity with health that cannot be regenerated, but is refilled every 30 seconds.
static final PotionEffectType	BAD_OMEN	Triggers an ominous event when the player enters a village or trial chambers. oof.
static final PotionEffectType	BLINDNESS	Blinds an entity.
static final PotionEffectType	CONDUIT_POWER	Effects granted by a nearby conduit.
static final PotionEffectType	DARKNESS	Causes the player's vision to dim occasionally.
static final PotionEffectType	DOLPHINS_GRACE	Increses underwater movement speed. Squee'ek uh'k kk'kkkk squeek eee'eek.
static final PotionEffectType	FIRE_RESISTANCE	Stops fire damage.
static final PotionEffectType	GLOWING	Outlines the entity so that it can be seen from afar.
static final PotionEffectType	HASTE	Increases dig speed.
static final PotionEffectType	HEALTH_BOOST	Increases the maximum health of an entity.
static final PotionEffectType	HERO_OF_THE_VILLAGE	Reduces the cost of villager trades. \o/.
static final PotionEffectType	HUNGER	Increases hunger.
static final PotionEffectType	INFESTED	Chance of spawning silverfish when hurt.
static final PotionEffectType	INSTANT_DAMAGE	Hurts an entity.
static final PotionEffectType	INSTANT_HEALTH	Heals an entity.
static final PotionEffectType	INVISIBILITY	Grants invisibility.
static final PotionEffectType	JUMP_BOOST	Increases jump height.
static final PotionEffectType	LEVITATION	Causes the entity to float into the air.
static final PotionEffectType	LUCK	Loot table luck.
static final PotionEffectType	MINING_FATIGUE	Decreases dig speed.
static final PotionEffectType	NAUSEA	Warps vision on the client.
static final PotionEffectType	NIGHT_VISION	Allows an entity to see in the dark.
static final PotionEffectType	OOZING	Causes slimes to spawn upon death.
static final PotionEffectType	POISON	Deals damage to an entity over time.
static final PotionEffectType	RAID_OMEN	Triggers a raid when a player enters a village.
static final PotionEffectType	REGENERATION	Regenerates health.
static final PotionEffectType	RESISTANCE	Decreases damage dealt to an entity.
static final PotionEffectType	SATURATION	Increases the food level of an entity each tick.
static final PotionEffectType	SLOW_FALLING	Slows entity fall rate.
static final PotionEffectType	SLOWNESS	Decreases movement speed.
static final PotionEffectType	SPEED	Increases movement speed.
static final PotionEffectType	STRENGTH	Increases damage dealt.
static final PotionEffectType	TRIAL_OMEN	Causes trial spawners to become ominous.
static final PotionEffectType	UNLUCK	Loot table unluck.
static final PotionEffectType	WATER_BREATHING	Allows breathing underwater.
static final PotionEffectType	WEAKNESS	Decreases damage dealt by an entity.
static final PotionEffectType	WEAVING	Creates cobwebs upon death.
static final PotionEffectType	WIND_CHARGED	Emits a wind burst upon death.
static final PotionEffectType	WITHER	Deals damage to an entity over time and gives the health to the shooter.

Constructor Summary

Constructors

Constructor	Description
PotionEffectType()

Method Summary

Modifier and Type	Method	Description
abstract PotionEffect	createEffect(int duration, int amplifier)	Creates a PotionEffect from this PotionEffectType, applying duration modifiers and checks.
static PotionEffectType	getById(int id)	Deprecated. Magic value
static PotionEffectType	getByKey(NamespacedKey key)	Deprecated. only for backwards compatibility, use Registry.get(NamespacedKey) instead.
static PotionEffectType	getByName(String name)	Deprecated. only for backwards compatibility, use Registry.get(NamespacedKey) instead.
abstract PotionEffectTypeCategory	getCategory()	Returns the category of this effect type.
abstract Color	getColor()	Returns the color of this effect type.
abstract double	getDurationModifier()	Deprecated. unused, always 1.0
abstract int	getId()	Deprecated. Magic value
abstract NamespacedKey	getKey()	Deprecated. A key might not always be present, use RegistryAware.getKeyOrThrow() instead.
abstract String	getName()	Deprecated. only for backwards compatibility, use getKey() instead.
abstract boolean	isInstant()	Returns whether the effect of this type happens once, immediately.
static PotionEffectType[]	values()	Deprecated. use Iterable.iterator().

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.bukkit.registry.RegistryAware

getKeyOrNull, getKeyOrThrow, isRegistered

Methods inherited from interface org.bukkit.Translatable

getTranslationKey

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:

• PotionBrewer.createEffect(PotionEffectType, int, int)

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

getKey

@NotNull
@Deprecated(since="1.21.4")
public abstract NamespacedKey getKey()

Deprecated.

A key might not always be present, use RegistryAware.getKeyOrThrow() instead.

Return the namespaced identifier for this object.

Specified by:

getKey in interface Keyed

Returns:

this object's key

See Also:

• RegistryAware.getKeyOrThrow()
• RegistryAware.isRegistered()

getDurationModifier

@Deprecated(since="1.14")
public abstract double getDurationModifier()

Deprecated.

unused, always 1.0

Returns the duration modifier applied to effects of this type.

Returns:

duration modifier

getId

@Deprecated(since="1.6.2")
public abstract int getId()

Deprecated.

Magic value

Returns the unique ID of this type.

Returns:

Unique ID

getName

@NotNull
@Deprecated(since="1.20.3")
public abstract String getName()

Deprecated.

only for backwards compatibility, use getKey() instead.

Returns the name of this effect type.

Returns:

The name of this effect type

getByKey

@Contract("null -> null")
@Nullable
@Deprecated(since="1.20.3")
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(since="1.6.2")
@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(since="1.20.3")
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(since="1.20.3")
public static PotionEffectType[] values()

Deprecated.

use Iterable.iterator().

Returns:

an array of all known PotionEffectTypes.