Package org.bukkit.inventory.meta

Interface FireworkMeta

All Superinterfaces:
Cloneable, ConfigurationSerializable, ItemMeta, PersistentDataHolder
public interface FireworkMeta extends ItemMeta
Represents a Material.FIREWORK_ROCKET and its effects.

  • Method Details

    • addEffect

      void addEffect(@NotNull 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(@NotNull 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(@NotNull 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

      @NotNull 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-127
      Throws:
      IllegalArgumentException - if height<0 or height>127

    • clone

      @NotNull FireworkMeta clone()
      Specified by:
      clone in interface ItemMeta