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


Copyright © 2013. All Rights Reserved.