Bukkit

FireworkArrows v0.1 - v0.3

NOTE: This page only applies to versions 0.1, 0.2 and 0.3!
For newer versions click here.

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>'.

Commands

/fireworkarrows - Display the help page.
/fwa - Alias for /fireworkarrows.
/fwa toggle - Enable and disable FireworkArrows for your arrows.
/fwa toggle <player> - Enable and disable FireworkArrows for 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 other players.
fireworkarrows.toggleall - Allows the player to toggle the whole plugin (for everyone on the server).
fireworkarrows.auto (v0.2+) - Auto-enables FireworkArrows for this player.

Config

RememberGlobalToggle: Does the plugin have to remember the global toggle state between startups?
GlobalToggled: Here the previous state gets stored; you shouldn't change this.
DeleteArrowsOnHit: Do arrows have get deleted after the explosion? I advise to set this to true.
UseSmallBallShape (v0.2+): Should the plugin use the smallball-shape for fireworks?
UseStarShape (v0.2+): Should the plugin use the star-shape for fireworks?
FireworkAbility (v0.3+):

• 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.
    

UseAllColors: 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 UseAllColors 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.
  

SilentMode (v0.2+): If you don't want the plugin to notify the console everytime someone toggles FireworkArrows, you can disable this here.
CheckForUpdates: Does the plugin have to check for updates on startup?

Todo

• Star fireworks (Added in v0.2)
  
• Permission that auto-enables FireworkArrows (Added in v0.2)
  
• Multiple colors in fireworks (Not going to add it because it looks messy)
• Reload command
• 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_.

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