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 aFireworkEffect
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.
-
Method Details
-
with
@NotNull public FireworkEffect.Builder with(@NotNull FireworkEffect.Type type) throws IllegalArgumentExceptionSpecify the type of the firework effect.- Parameters:
type
- The effect type- Returns:
- This object, for chaining
- Throws:
IllegalArgumentException
- If type is null
-
withFlicker
Add a flicker to the firework effect.- Returns:
- This object, for chaining
-
flicker
Set whether the firework effect should flicker.- Parameters:
flicker
- true if it should flicker, false if not- Returns:
- This object, for chaining
-
withTrail
Add a trail to the firework effect.- Returns:
- This object, for chaining
-
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 IllegalArgumentExceptionAdd 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 IllegalArgumentExceptionAdd several primary colors to the firework effect.- Parameters:
colors
- The colors to add- Returns:
- This object, for chaining
- Throws:
IllegalArgumentException
- If colors is nullIllegalArgumentException
- If any color is null (may be thrown after changes have occurred)
-
withColor
@NotNull public FireworkEffect.Builder withColor(@NotNull Iterable<?> colors) throws IllegalArgumentExceptionAdd 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 nullIllegalArgumentException
- If any color is null (may be thrown after changes have occurred)
-
withFade
@NotNull public FireworkEffect.Builder withFade(@NotNull Color color) throws IllegalArgumentExceptionAdd a fade color to the firework effect.- Parameters:
color
- The color to add- Returns:
- This object, for chaining
- Throws:
IllegalArgumentException
- If colors is nullIllegalArgumentException
- If any color is null (may be thrown after changes have occurred)
-
withFade
@NotNull public FireworkEffect.Builder withFade(@NotNull Color... colors) throws IllegalArgumentExceptionAdd several fade colors to the firework effect.- Parameters:
colors
- The colors to add- Returns:
- This object, for chaining
- Throws:
IllegalArgumentException
- If colors is nullIllegalArgumentException
- If any color is null (may be thrown after changes have occurred)
-
withFade
@NotNull public FireworkEffect.Builder withFade(@NotNull Iterable<?> colors) throws IllegalArgumentExceptionAdd 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 nullIllegalArgumentException
- If any color is null (may be thrown after changes have occurred)
-
build
Create aFireworkEffect
from the current contents of this builder.To successfully build, you must have specified at least one color.
- Returns:
- The representative firework effect
-