org.bukkit.inventory.meta
Interface PotionMeta

All Superinterfaces:

Cloneable, ConfigurationSerializable, ItemMeta

public interface PotionMeta
extends ItemMeta

Represents a potion (Material.POTION) that can have custom effects.

Method Summary

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()
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.
boolean	setMainEffect(PotionEffectType type) Moves a potion effect to the top of the potion effect list.

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

addEnchant, getDisplayName, getEnchantLevel, getEnchants, getLore, hasDisplayName, hasEnchant, hasEnchants, hasLore, removeEnchant, setDisplayName, setLore

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

serialize

Method Detail

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

boolean setMainEffect(PotionEffectType type)

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