Bukkit

Throw various grenades (12 types as of v2.2) that detonate after a configurable time.

Videos

I put together a new video to demonstrate the 3 new grenades that came with v2.0, and to try to capture some of the sounds of the grenades:

And here's the original video:

Source Code

At github: https://github.com/waffles87/fungrenades

New Features (v2.2)

See the v2.2 change log for more details.

• There has been a change to how you throw FunGrenades; it is now via right-click to be more similar to a snowball or ender pearl.
• FunGrenades are now craftable, and the recipes are configurable.
• Added the fg.reload command and permission.
• Fixed the "anvil renaming problem" (see Known Caveats). Kits should still work though, and if not you can turn off this fix in the config.
• Added a new grenade; acme (based on the ACME hole from cartoons).
  
  

Getting and Using Grenades

Get grenades with the /fg.give <player> <grenade> [amount] command
(grenade names spelled as below). This works well with command blocks.

Example: /fg.give waffles87 classic 5

Alternatively, FunGrenades can also be crafted as of v2.2; see the default configs for the default recipes.

Throw grenades exactly as you would throw a snowball; with a right-click. This is new as of v2.2, before that it was a left-click to throw, or any click that animated your arm, which caused a lot of accidental throws. See the v2.2 change log for a complete explanation of this change.

Other Misc. Facts:

• Grenades "flash" as though they are about to explode.
  
• They do not detonate on impact; the detonation time is configurable for each grenade.
  
• As of v2.2, the acme grenade is the first "detonate on impact" grenade.
  
  
  

Grenade Types

• classic (HE Grenade)
• smokebomb (blindness and player invisibility)
• gluebomb (webs)
• pineapple (arrows)
• napalm (fire)
• icicle (snow, ice, slowing effect, damage)
• teardrop (water)
• jackhammer (sequential downward-drilling explosions)
  
  New as of v2.0:
• pester
• zapper
• decay
  
  New as of v2.2:
• acme
  
  

The Future

Future Grenade Types

• Sticky Bomb
• Homing Grenade
• Pneumatic Push (force bomb)
• Null Zone
• AoE Heal
• Party Grenade
• Flare/Flash
• Suicide
  

Future Development

• fg.list command
• Master grenade
  
  

Permissions

Permissions for each grenade and the give command. Note that having a permission for a grenade allows you to receive it and throw it; it does NOT give you permission to /fg.give it to yourself. This is where command blocks come in handy; it shouldn't work as demonstrated in the video if the player doesn't have the permission. I haven't tested all these permissions so please report here if they don't work as expected.

permissions and their defaults:

• fg.classic: true
• fg.smokebomb: true
• fg.gluebomb: true
• fg.pineapple: true
• fg.icicle: true
• fg.teardrop: true
• fg.napalm: true
• fg.jackhammer: true
• fg.pester: true
• fg.zapper: true
• fg.decay: true
• fg.give: op
• fg.reload: op
  
  

Configs

The config file should be self-explanatory.

General configs

• throw_cooldown - a player-specific cooldown for throwing grenades
• renaming_allowed - sets whether you can use the anvil to rename items into grenades (see Known Caveats)
• allow_crafting - sets whether FunGrenades recipes will be enabled on the server
• right_click_safe_materials - a list of Materials that you can safely right-click while holding a FunGrenade, without throwing it.
  
  

Grenade-specific configs

• detonation_time for each grenades
• some have their effect duration configurable where applicable
• some have other useful features configurable where applicaple
• as of v2.2, crafting recipes are configurable; follow the format in the default config.
  
  

Installation

Put FunGrenades.jar into your plugins folder and run your server; it will generate the default configs and you should be good to go! If you are updating to a new version of FunGrenades, be sure to delete the config file before running your server so a new one is generated.

Known Caveats

Reports on any of these issues or anything else you find is what I'm looking for and would be greatly appreciated.

• There may be some server lag associated with some of these grenades, though I am trying to eliminate it.
• Renaming an item with an anvil to the name of a FunGrenade seems to turn it into one. Fixed as of v2.2
• While the block destruction option is configurable, it is not totally effective, and some FunGrenades explicitly change blocks; I don't recommend using this plugin on a world in which you deeply care about the environment!