org.bukkit.inventory.meta

Interface PotionMeta

All Superinterfaces:

Cloneable, ConfigurationSerializable, ItemMeta, PotionDataHolder

public interface PotionMeta
extends ItemMeta, PotionDataHolder

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

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
Color	getColor() Gets the potion color that is set.
List<PotionEffect>	getCustomEffects() Gets an immutable list containing all custom potion effects applied to this potion.
boolean	hasColor() Checks for existence of a potion color.
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
void	setColor(Color color) Sets the potion color.
boolean	setMainEffect(PotionEffectType type) Deprecated. use PotionType(org.bukkit.potion.PotionEffectType, boolean, boolean)

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

addEnchant, addItemFlags, getDisplayName, getEnchantLevel, getEnchants, getItemFlags, getLocalizedName, getLore, hasConflictingEnchant, hasDisplayName, hasEnchant, hasEnchants, hasItemFlag, hasLocalizedName, hasLore, isUnbreakable, removeEnchant, removeItemFlags, setDisplayName, setLocalizedName, setLore, setUnbreakable, spigot

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

serialize

Methods inherited from interface org.bukkit.potion.PotionDataHolder

clearCustomEffects0, copyFrom

Method Detail

setBasePotionData

void setBasePotionData(PotionData data)

Sets the underlying potion data

Specified by:

setBasePotionData in interface PotionDataHolder

Parameters:

data - PotionData to set the base potion state to

getBasePotionData

PotionData getBasePotionData()

Returns the potion data about the base potion

Specified by:

getBasePotionData in interface PotionDataHolder

Returns:

a PotionData object

hasCustomEffects

boolean hasCustomEffects()

Checks for the presence of custom potion effects.

Specified by:

hasCustomEffects in interface PotionDataHolder

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.

Specified by:

getCustomEffects in interface PotionDataHolder

Returns:

the immutable list of custom potion effects

addCustomEffect

boolean addCustomEffect(PotionEffect effect,
                        boolean overwrite)

Adds a custom potion effect to this potion.

Specified by:

addCustomEffect in interface PotionDataHolder

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.

Specified by:

removeCustomEffect in interface PotionDataHolder

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.

Specified by:

hasCustomEffect in interface PotionDataHolder

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(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

hasColor

boolean hasColor()

Checks for existence of a potion color.

Specified by:

hasColor in interface PotionDataHolder

Returns:

true if this has a custom potion color

getColor

Color getColor()

Gets the potion color that is set. A custom potion color will alter the display of the potion in an inventory slot.

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

Specified by:

getColor in interface PotionDataHolder

Returns:

the potion color that is set

setColor

void setColor(Color color)

Sets the potion color. A custom potion color will alter the display of the potion in an inventory slot.

Specified by:

setColor in interface PotionDataHolder

Parameters:

color - the color to set

clone

PotionMeta clone()

Specified by:

clone in interface ItemMeta