org.bukkit.inventory.meta
Interface FireworkMeta

All Superinterfaces:

Cloneable, ConfigurationSerializable, ItemMeta

public interface FireworkMeta
extends ItemMeta

Represents a Material.FIREWORK and its effects.

Method Summary

void	addEffect(FireworkEffect effect) Add another effect to this firework.
void	addEffects(FireworkEffect... effects) Add several effects to this firework.
void	addEffects(Iterable<FireworkEffect> effects) Add several firework effects to this firework.
void	clearEffects() Remove all effects from this firework.
FireworkMeta	clone()
List<FireworkEffect>	getEffects() Get the effects in this firework.
int	getEffectsSize() Get the number of effects in this firework.
int	getPower() Gets the approximate height the firework will fly.
boolean	hasEffects() Get whether this firework has any effects.
void	removeEffect(int index) Remove an effect from this firework.
void	setPower(int power) Sets the approximate power of the firework.

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

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

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

serialize

Method Detail

addEffect

void addEffect(FireworkEffect effect)
               throws IllegalArgumentException

Add another effect to this firework.

Parameters:

effect - The firework effect to add

Throws:

IllegalArgumentException - If effect is null

addEffects

void addEffects(FireworkEffect... effects)
                throws IllegalArgumentException

Add several effects to this firework.

Parameters:

effects - The firework effects to add

Throws:

IllegalArgumentException - If effects is null

IllegalArgumentException - If any effect is null (may be thrown after changes have occurred)

addEffects

void addEffects(Iterable<FireworkEffect> effects)
                throws IllegalArgumentException

Add several firework effects to this firework.

Parameters:

effects - An iterable object whose iterator yields the desired firework effects

Throws:

IllegalArgumentException - If effects is null

IllegalArgumentException - If any effect is null (may be thrown after changes have occurred)

getEffects

List<FireworkEffect> getEffects()

Get the effects in this firework.

Returns:

An immutable list of the firework effects

getEffectsSize

int getEffectsSize()

Get the number of effects in this firework.

Returns:

The number of effects

removeEffect

void removeEffect(int index)
                  throws IndexOutOfBoundsException

Remove an effect from this firework.

Parameters:

index - The index of the effect to remove

Throws:

IndexOutOfBoundsException - If index < 0 or index > getEffectsSize()

clearEffects

void clearEffects()

Remove all effects from this firework.

hasEffects

boolean hasEffects()

Get whether this firework has any effects.

Returns:

true if it has effects, false if there are no effects

getPower

int getPower()

Gets the approximate height the firework will fly.

Returns:

approximate flight height of the firework.

setPower

void setPower(int power)
              throws IllegalArgumentException

Sets the approximate power of the firework. Each level of power is half a second of flight time.

Parameters:

power - the power of the firework, from 0-128

Throws:

IllegalArgumentException - if height<0 or height>128

clone

FireworkMeta clone()

Specified by:

clone in interface ItemMeta