Package org.bukkit

Class FireworkEffect.Builder

java.lang.Object

org.bukkit.FireworkEffect.Builder

Enclosing class:

FireworkEffect

public static final class FireworkEffect.Builder
extends Object

This is a builder for FireworkEffects.

See Also:

FireworkEffect.builder()

Method Summary

Modifier and Type	Method	Description
FireworkEffect	build()	Create a FireworkEffect from the current contents of this builder.
FireworkEffect.Builder	flicker(boolean flicker)	Set whether the firework effect should flicker.
FireworkEffect.Builder	trail(boolean trail)	Set whether the firework effect should have a trail.
FireworkEffect.Builder	with(FireworkEffect.Type type)	Specify the type of the firework effect.
FireworkEffect.Builder	withColor(Iterable<?> colors)	Add several primary colors to the firework effect.
FireworkEffect.Builder	withColor(Color color)	Add a primary color to the firework effect.
FireworkEffect.Builder	withColor(Color... colors)	Add several primary colors to the firework effect.
FireworkEffect.Builder	withFade(Iterable<?> colors)	Add several fade colors to the firework effect.
FireworkEffect.Builder	withFade(Color color)	Add a fade color to the firework effect.
FireworkEffect.Builder	withFade(Color... colors)	Add several fade colors to the firework effect.
FireworkEffect.Builder	withFlicker()	Add a flicker to the firework effect.
FireworkEffect.Builder	withTrail()	Add a trail to the firework effect.

Methods inherited from class java.lang.Object

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

Method Detail

with

@NotNull
public FireworkEffect.Builder with(@NotNull
                                   FireworkEffect.Type type)
                            throws IllegalArgumentException

Specify the type of the firework effect.

Parameters:

type - The effect type

Returns:

This object, for chaining

Throws:

IllegalArgumentException - If type is null

withFlicker

@NotNull
public FireworkEffect.Builder withFlicker()

Add a flicker to the firework effect.

Returns:

This object, for chaining

flicker

@NotNull
public FireworkEffect.Builder flicker(boolean flicker)

Set whether the firework effect should flicker.

Parameters:

flicker - true if it should flicker, false if not

Returns:

This object, for chaining

withTrail

@NotNull
public FireworkEffect.Builder withTrail()

Add a trail to the firework effect.

Returns:

This object, for chaining

trail

@NotNull
public FireworkEffect.Builder trail(boolean trail)

Set whether the firework effect should have a trail.

Parameters:

trail - true if it should have a trail, false for no trail

Returns:

This object, for chaining

withColor

@NotNull
public FireworkEffect.Builder withColor(@NotNull
                                        Color color)
                                 throws IllegalArgumentException

Add a primary color to the firework effect.

Parameters:

color - The color to add

Returns:

This object, for chaining

Throws:

IllegalArgumentException - If color is null

withColor

@NotNull
public FireworkEffect.Builder withColor(@NotNull
                                        Color... colors)
                                 throws IllegalArgumentException

Add several primary colors to the firework effect.

Parameters:

colors - The colors to add

Returns:

This object, for chaining

Throws:

IllegalArgumentException - If colors is null

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

withColor

@NotNull
public FireworkEffect.Builder withColor(@NotNull
                                        Iterable<?> colors)
                                 throws IllegalArgumentException

Add several primary colors to the firework effect.

Parameters:

colors - An iterable object whose iterator yields the desired colors

Returns:

This object, for chaining

Throws:

IllegalArgumentException - If colors is null

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

withFade

@NotNull
public FireworkEffect.Builder withFade(@NotNull
                                       Color color)
                                throws IllegalArgumentException

Add a fade color to the firework effect.

Parameters:

color - The color to add

Returns:

This object, for chaining

Throws:

IllegalArgumentException - If colors is null

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

withFade

@NotNull
public FireworkEffect.Builder withFade(@NotNull
                                       Color... colors)
                                throws IllegalArgumentException

Add several fade colors to the firework effect.

Parameters:

colors - The colors to add

Returns:

This object, for chaining

Throws:

IllegalArgumentException - If colors is null

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

withFade

@NotNull
public FireworkEffect.Builder withFade(@NotNull
                                       Iterable<?> colors)
                                throws IllegalArgumentException

Add several fade colors to the firework effect.

Parameters:

colors - An iterable object whose iterator yields the desired colors

Returns:

This object, for chaining

Throws:

IllegalArgumentException - If colors is null

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

build

@NotNull
public FireworkEffect build()

Create a FireworkEffect from the current contents of this builder.

To successfully build, you must have specified at least one color.

Returns:

The representative firework effect