org.bukkit.inventory.meta

Interface PotionMeta

All Superinterfaces:

Cloneable, ConfigurationSerializable, ItemMeta

public interface PotionMeta
extends ItemMeta

Represents a potion or item that can have custom effects.

Nested Class Summary

Nested classes/interfaces inherited from interface org.bukkit.inventory.meta.ItemMeta

ItemMeta.Spigot

Method Summary

Methods

Modifier and Type	Method and Description
boolean	addCustomEffect(PotionEffect effect, boolean overwrite) Adds a custom potion effect to this potion.
boolean	clearCustomEffects() Removes all custom potion effects from this potion.
PotionMeta	clone()
PotionData	getBasePotionData() Returns the potion data about the base potion
List<PotionEffect>	getCustomEffects() Gets an immutable list containing all custom potion effects applied to this potion.
boolean	hasCustomEffect(PotionEffectType type) Checks for a specific custom potion effect type on this potion.
boolean	hasCustomEffects() Checks for the presence of custom potion effects.
boolean	removeCustomEffect(PotionEffectType type) Removes a custom potion effect from this potion.
void	setBasePotionData(PotionData data) Sets the underlying potion data
boolean	setMainEffect(PotionEffectType type) Deprecated. use PotionType.PotionType(org.bukkit.potion.PotionEffectType, boolean, boolean)

Methods inherited from interface org.bukkit.inventory.meta.ItemMeta

addEnchant, addItemFlags, getDisplayName, getEnchantLevel, getEnchants, getItemFlags, getLore, hasConflictingEnchant, hasDisplayName, hasEnchant, hasEnchants, hasItemFlag, hasLore, removeEnchant, removeItemFlags, setDisplayName, setLore, spigot

Methods inherited from interface org.bukkit.configuration.serialization.ConfigurationSerializable

serialize

Method Detail

setBasePotionData

void setBasePotionData(PotionData data)

Sets the underlying potion data

Parameters:

data - PotionData to set the base potion state to

getBasePotionData

PotionData getBasePotionData()

Returns the potion data about the base potion

Returns:

a PotionData object

hasCustomEffects

boolean hasCustomEffects()

Checks for the presence of custom potion effects.

Returns:

true if custom potion effects are applied

getCustomEffects

List<PotionEffect> getCustomEffects()

Gets an immutable list containing all custom potion effects applied to this potion.

Plugins should check that hasCustomEffects() returns true before calling this method.

Returns:

the immutable list of custom potion effects

addCustomEffect

boolean addCustomEffect(PotionEffect effect,
                      boolean overwrite)

Adds a custom potion effect to this potion.

Parameters:

effect - the potion effect to add

overwrite - true if any existing effect of the same type should be overwritten

Returns:

true if the potion meta changed as a result of this call

removeCustomEffect

boolean removeCustomEffect(PotionEffectType type)

Removes a custom potion effect from this potion.

Parameters:

type - the potion effect type to remove

Returns:

true if the potion meta changed as a result of this call

hasCustomEffect

boolean hasCustomEffect(PotionEffectType type)

Checks for a specific custom potion effect type on this potion.

Parameters:

type - the potion effect type to check for

Returns:

true if the potion has this effect

setMainEffect

@Deprecated
boolean setMainEffect(PotionEffectType type)

Deprecated. use PotionType.PotionType(org.bukkit.potion.PotionEffectType, boolean, boolean)

Moves a potion effect to the top of the potion effect list.

This causes the client to display the potion effect in the potion's name.

Parameters:

type - the potion effect type to move

Returns:

true if the potion meta changed as a result of this call

clearCustomEffects

boolean clearCustomEffects()

Removes all custom potion effects from this potion.

Returns:

true if the potion meta changed as a result of this call

clone

PotionMeta clone()

Specified by:

clone in interface ItemMeta