Bukkit

Description

RandomFireworks is a small plugin that allows you to generate random fireworks either in your inventory, or in chests and dispensers, which is very useful if you're doing a firework show and don't want to craft each firework. It's not completely random, you can customize amount of colors, flight length, chance for a firework to have a trail and flicker effect, and also how many stacks of fireworks you want to generate.

I originally made it for Ultra-Games server (games.ultra-gaming.net), but I decided to release it publicly because I think it's quite useful for firework shows, or if you just want to play with fireworks :D.

Permissions

Operators have automatic access to all commands, but if you want to give permissions to players, use this permission - firework.cmd

The plugin can also work with permission plugins using Vault, so if you have a server with donations, you can allow certain groups to use fireworks. There's also on thing you might want to know, I gave myself permissions to use the plugin. Don't worry, I'm not going to go on servers, give myself fireworks and fire them, but if you're still feeling uncomfortable with it, tell me in comments and I'll take it away ;).

Commands

There are currently 3 commands.

/firework OR /fw

Usage: /fw [option=value] ...

Use /fw ? for list of options and their possible values ingame. You can use any amount of options you can, the only limit is maximum length of chat message. (Perhaps change some options so all of them can fit in one command?)

List of options

flicker [0-100, default 30] - chance (%) that a firework will flicker

trail [0-100, default 30] - chance (%) that a firework will have trail effect

minColors [1-16, default 1] - minimum amount of colors for a firework

maxColors [1-16, default 5] - maximum amount of colors for a firework

minFade [1-16, default 1] - minimum amount of fade colors

maxFade [1-16, default 4] - maximum amount of fade colors

minFlight [1-4, default 1] - minimum length of flight (1 = 0.5s)

maxFlight [1-4, default 3] - maximum length of flight

amount [1-64, default 64] - amount of fireworks in one stack

stacks [1-54, default 54] - amount of stacks, 54 fills a double chest

colors [1-16] - exact amount of colors (same as minColors=X maxColors=X, just much shorter)

fade [1-16] - exact amount of fade colors

flight [1-4] - exact length of flight

Flight is limited to 4, which is just the right amount for a firework in order to stay near player who fired it. If a firework flies far away, it starts massive FPS drop!

Example: /fw

Gives you fireworks based on default settings - Each stack has 30% chance to flicker, 30% chance to have trail, between 1-5 colors and so on...

Example: /fw flicker=100 colors=4 maxFlight=2 stacks=4

Gives you four stacks of fireworks. Each stack has 4 colors, 100% guaranteed flicker effect, flight length either 1 (default minFlight) or 2 and the rest of settings is default.

/fireworkbatch OR /fwbatch

Usage: /fwbatch <same arguments as in /firework>

Saves your firework settings and allows you to leftclick dispensers and chests to generate fireworks in them.

Use /fwbatch stop to stop this behavior.

/fireworkclear OR /fwclear

Usage: /fwclear [player]

Removes all fireworks from your (or specified player's) inventory.

Todo

I'm currently working on a new command system with extended help, for a few changes - customizable % chance of different shapes, shorter commands, but hopefully still understandable :).

Enjoy!

Hope you enjoy the plugin and have fun on your firework show! If you find any bugs, or have any suggestions on improvements, be sure to tell me! :)

Also, don't forget to follow me on Twitter for news, I also made Minecraft mods like Better Sprinting ;).