org.bukkit.potion
Class Potion

java.lang.Object
  org.bukkit.potion.Potion

public class Potion
extends Object

Represents a minecraft potion

Nested Class Summary

static class

Potion.Tier Deprecated.

Constructor Summary

Potion(int name)
Create a potion with a specific name.

Potion(PotionType type)
Construct a new potion of the given type.

Potion(PotionType type, int level)
Create a new potion of the given type and level.

Potion(PotionType type, int level, boolean splash)
Deprecated. In favour of using Potion(PotionType) with splash().

Potion(PotionType type, int level, boolean splash, boolean extended)
Deprecated. In favour of using Potion(PotionType) with extend() and possibly splash().

Potion(PotionType type, Potion.Tier tier)
Deprecated. In favour of Potion(PotionType, int)

Potion(PotionType type, Potion.Tier tier, boolean splash)
Deprecated. In favour of Potion(PotionType, int, boolean)

Potion(PotionType type, Potion.Tier tier, boolean splash, boolean extended)
Deprecated. In favour of Potion(PotionType, int, boolean, boolean)

Method Summary

void	apply(ItemStack to) Applies the effects of this potion to the given ItemStack.
void	apply(LivingEntity to) Applies the effects that would be applied by this potion to the given LivingEntity.
boolean	equals(Object obj)
Potion	extend() Chain this to the constructor to extend the potion's duration.
static Potion	fromDamage(int damage)
static Potion	fromItemStack(ItemStack item)
static PotionBrewer	getBrewer() Returns an instance of PotionBrewer.
Collection<PotionEffect>	getEffects() Returns a collection of PotionEffects that this Potion would confer upon a LivingEntity.
int	getLevel() Returns the level of this potion.
int	getNameId()
Potion.Tier	getTier() Deprecated.
PotionType	getType() Returns the PotionType of this potion.
boolean	hasExtendedDuration() Returns whether this potion has an extended duration.
int	hashCode()
boolean	isSplash() Returns whether this potion is a splash potion.
void	setHasExtendedDuration(boolean isExtended) Set whether this potion has extended duration.
void	setLevel(int level) Sets the level of this potion.
static void	setPotionBrewer(PotionBrewer other) Sets the current instance of PotionBrewer.
void	setSplash(boolean isSplash) Sets whether this potion is a splash potion.
void	setTier(Potion.Tier tier) Deprecated. In favour of setLevel(int)
void	setType(PotionType type) Sets the PotionType of this potion.
Potion	splash() Chain this to the constructor to make the potion a splash potion.
short	toDamageValue() Converts this potion to a valid potion damage short, usable for potion item stacks.
ItemStack	toItemStack(int amount) Converts this potion to an ItemStack with the specified amount and a correct damage value.

Methods inherited from class java.lang.Object

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

Constructor Detail

Potion

public Potion(PotionType type)

Construct a new potion of the given type. Unless the type is PotionType.WATER, it will be level one, without extended duration. Don't use this constructor to create a no-effect potion other than water bottle.

Parameters:

type - The potion type

See Also:

Potion(int)

Potion

@Deprecated
public Potion(PotionType type,
                         Potion.Tier tier)

Deprecated. In favour of Potion(PotionType, int)

Potion

@Deprecated
public Potion(PotionType type,
                         Potion.Tier tier,
                         boolean splash)

Deprecated. In favour of Potion(PotionType, int, boolean)

Potion

@Deprecated
public Potion(PotionType type,
                         Potion.Tier tier,
                         boolean splash,
                         boolean extended)

Deprecated. In favour of Potion(PotionType, int, boolean, boolean)

Potion

public Potion(PotionType type,
              int level)

Create a new potion of the given type and level.

Parameters:

type - The type of potion.

level - The potion's level.

Potion

@Deprecated
public Potion(PotionType type,
                         int level,
                         boolean splash)

Deprecated. In favour of using Potion(PotionType) with splash().

Create a new potion of the given type and level.

Parameters:

type - The type of potion.

level - The potion's level.

splash - Whether it is a splash potion.

Potion

@Deprecated
public Potion(PotionType type,
                         int level,
                         boolean splash,
                         boolean extended)

Deprecated. In favour of using Potion(PotionType) with extend() and possibly splash().

Create a new potion of the given type and level.

Parameters:

type - The type of potion.

level - The potion's level.

splash - Whether it is a splash potion.

extended - Whether it has an extended duration.

Potion

public Potion(int name)

Create a potion with a specific name.

Parameters:

name - The name index (0-63)

Method Detail

splash

public Potion splash()

Chain this to the constructor to make the potion a splash potion.

Returns:

The potion.

extend

public Potion extend()

Chain this to the constructor to extend the potion's duration.

Returns:

The potion.

apply

public void apply(ItemStack to)

Applies the effects of this potion to the given ItemStack. The itemstack must be a potion.

Parameters:

to - The itemstack to apply to

apply

public void apply(LivingEntity to)

Applies the effects that would be applied by this potion to the given LivingEntity.

Parameters:

to - The entity to apply the effects to

See Also:

LivingEntity.addPotionEffects(Collection)

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

getEffects

public Collection<PotionEffect> getEffects()

Returns a collection of PotionEffects that this Potion would confer upon a LivingEntity.

Returns:

The effects that this potion applies

See Also:

PotionBrewer.getEffectsFromDamage(int), toDamageValue()

getLevel

public int getLevel()

Returns the level of this potion.

Returns:

The level of this potion

getTier

@Deprecated
public Potion.Tier getTier()

Deprecated.

Returns the Potion.Tier of this potion.

Returns:

The tier of this potion

getType

public PotionType getType()

Returns the PotionType of this potion.

Returns:

The type of this potion

hasExtendedDuration

public boolean hasExtendedDuration()

Returns whether this potion has an extended duration.

Returns:

Whether this potion has extended duration

hashCode

public int hashCode()

Overrides:

hashCode in class Object

isSplash

public boolean isSplash()

Returns whether this potion is a splash potion.

Returns:

Whether this is a splash potion

setHasExtendedDuration

public void setHasExtendedDuration(boolean isExtended)

Set whether this potion has extended duration. This will cause the potion to have roughly 8/3 more duration than a regular potion.

Parameters:

isExtended - Whether the potion should have extended duration

setSplash

public void setSplash(boolean isSplash)

Sets whether this potion is a splash potion. Splash potions can be thrown for a radius effect.

Parameters:

isSplash - Whether this is a splash potion

setTier

@Deprecated
public void setTier(Potion.Tier tier)

Deprecated. In favour of setLevel(int)

Sets the Potion.Tier of this potion.

Parameters:

tier - The new tier of this potion

setType

public void setType(PotionType type)

Sets the PotionType of this potion.

Parameters:

type - The new type of this potion

setLevel

public void setLevel(int level)

Sets the level of this potion.

Parameters:

level - The new level of this potion

toDamageValue

public short toDamageValue()

Converts this potion to a valid potion damage short, usable for potion item stacks.

Returns:

The damage value of this potion

toItemStack

public ItemStack toItemStack(int amount)

Converts this potion to an ItemStack with the specified amount and a correct damage value.

Parameters:

amount - The amount of the ItemStack

Returns:

The created ItemStack

fromDamage

public static Potion fromDamage(int damage)

fromItemStack

public static Potion fromItemStack(ItemStack item)

getBrewer

public static PotionBrewer getBrewer()

Returns an instance of PotionBrewer.

Returns:

An instance of PotionBrewer

setPotionBrewer

public static void setPotionBrewer(PotionBrewer other)

Sets the current instance of PotionBrewer. Generally not to be used from within a plugin.

Parameters:

other - The new PotionBrewer

getNameId

public int getNameId()