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!
