Bukkit

FireworkArrows

Ever wanted your arrows to do something cool?
Like exploding maybe?
How about fireworks where your arrow lands?
Then this is the plugin you need!

Features

Makes your arrows explode like fireworks!
The explosion doesn't do any damage to anything, but looks really cool!

Usage

This plugin is fairly easy in use, all you have to do is toggle the plugin with '/fwa toggle', charge your bow and watch your arrow explode where it lands.
By default this will consume your arrow and you won't be able to pick it up again because well... It exploded...
But if you do want your arrow back, you can change this in the config and it will turn your arrows into some badass titanium ones that are unbreakable.
By default the plugin randomly picks a color for the fireworks out of all the colors available, but you can modify this in the config.
If you want to disable the plugin in game, you can do this with '/fwa toggleall'.
If you don't want to give players the permission to toggle FireworkArrows themselves, but you want to enable it for them, you can to this with '/fwa toggle <player>'.

Showcases

Showcase by OliverFrenchie

Showcase by itsPrime123

Commands

/fireworkarrows - Display the help page.
/fwa - Alias for /fireworkarrows.
/fwa toggle <player> - Enable and disable FireworkArrows for your or another players arrows.
/fwa toggleall - Enable and disable FireworkArrows for everyone on the server.

Permissions

fireworkarrows.* - Allows to use every command and mechanic of the plugin.
fireworkarrows.fwa - Allows the player to access the help page.
fireworkarrows.toggle - Allows the player to toggle FireworkArrows for themselves.
fireworkarrows.toggle.others - Allows the player to toggle FireworkArrows for themselves and other players.
fireworkarrows.toggleall - Allows the player to toggle the whole plugin (for everyone on the server).
fireworkarrows.auto - Auto-enables FireworkArrows for this player when they log in.

Config

toggled: The toggle state will be stored here; you don't have to change this.
delete-arrows-on-hit: Do arrows have get deleted after the explosion? It's advised to set this to true.

firework-ability:

• skeleton: Should skeletons arrows explode into fireworks?
  
• dispenser: Should dispensers arrows explode into fireworks?
  
  • Note: Due to the way Bukkit handles things, this will also enable FireworkArrows for other plugins who create arrows.
    

use-all-shapes: Should the plugin pick a random shape out of all firework-shapes, or only the ones you specify in shapes?
shapes: Here you can make a list of all firework-shapes you want, this only gets activated if use-all-shapes is set to false.

• Possible shapes: BALL, BALL_LARGE, BURST, CREEPER, STAR
  
• If you only see SMALL_BALL, then this list is formatted incorrectly.
  

use-all-colors: Should the plugin pick a random color out of all firework-colors, or only the ones you specify in colors?
colors: Here you can make a list of all firework-colors you want, this only gets activated if use-all-colors is set to false.

• Possible colors: AQUA, BLACK, BLUE, FUCHSIA, GRAY, GREEN, NAVY, OLIVE, ORANGE, PURPLE, RED, SILVER,TEAL, WHITE, YELLOW
  
• If you only see red fireworks ingame and there are supposed to be more colors, then this list is formatted incorrectly.
  

auto-update: Should the plugin auto-update?

Todo

• Star fireworks (Added in v0.2)
  
• Permission that auto-enables FireworkArrows (Added in v0.2)
  
• Reload command (As of v0.4 the normal /reload command will do the trick)
• Permission-based color groups

Bugs

Tell me if you found one!

Credits

Credits to codename_B, for his FireworkEffectPlayer v1.0 Util.
Special thanks to CaptainBern for helping me out and designing the logo.
Based on the plugin request of Tacoman_.

Note: The info on this page only applies for v0.4, for info on previous versions, click here.

This is my first plugin that I release, please be gentle.
I hope you enjoy playing with my plugin! :)