Bukkit

A simple yet customizable grapple hook!

Features

• Set the tool or item used as the grapple hook.
• Set the sound the grapple makes when firing.
• Set the distance the grapple will pull from. (max 100 blocks)
• Set the cool-down between grapple uses.
• Set the vertical-gain (elevation) of each grapple.
• Set different configurations per individual player, or by using the default, moderator, administrator, and ops groups.
• Get the grapple hook using a simple command or the survival way, with crafting recipes and an anvil.
  

---

---

---

Commands / Permissions

Command:	Description/Usage:	Permission:
/lgrapple	Gives the grapple hook. Right click to use it.	llamagrapple.grapple
	/lgrapple status Display the status of the configuration. /lgrapple status playername Display the status of a specific player.	llamagrapple.config
	/lgrapple distance # (mod:admin:op:playername) Set the distance the grapple will reach. -Leave (mod:admin:op:playername) empty to set the default distance.	llamagrapple.config
	/lgrapple cooldown # (mod:admin:op:playername) Set the cool-down between grapple uses. -Leave (mod:admin:op:playername) empty to set the default cool-down.	llamagrapple.config
	/lgrapple gain # (mod:admin:op:playername) Set the vertical gain when grappling. -Leave (mod:admin:op:playername) empty to set the default gain.	llamagrapple.config
	/lgrapple remove playername Remove a players grapple settings.	llamagrapple.config
	Gives access to Default grapple configuration.	llamagrapple.grapple
	Gives access to Moderators grapple configuration.	llamagrapple.moderator
	Gives access to Administrators grapple configuration.	llamagrapple.admin
	Gives access to Ops grapple configuration.	llamagrapple.op
	Gives access to change these configurations in-game. Ops have access by default.	llamagrapple.config

Examples

/lgrapple cooldown 5 admin Sets the cool-down for the Administrators grapple to 5 seconds.

/lgrapple gain 3 oooorgle Sets the vertical gain for player oooorgle to 3. (Creates user if not exist)

/lgrapple distance 20 Sets the distance for the Default grapple to 20 blocks.

/lgrapple distance 20 oooorgle Sets the grapple distance for player oooorgle to 20 blocks. (Creates user if not exist)

/lgrapple remove oooorgle Removes oooorgle's custom grapple settings.

/lgrapple Gifts you the grapple hook.

Crafting the grapple hook in survival is as easy as making the tool, then naming it 'grapple hook' in an anvil. If you have set an item that doesn't need crafting, like log or diamond, simply name the item the same way in the anvil.

Configuration

1. Copy the .jar to your plugins folder and restart your server.
2. Add permissions to your groups and players.
3. Log in and type '/lgrapple' to start grappling.
   
   Optionally:
   

• Enable Automatic Updates for this plugin by changing Auto-Update to true in the plugins/llamaGrapple/config.yml.
• Configure the gain, distance, and cool-down for each permission with in-game commands or by editing the config.yml.
• Configure the sound and grapple item for each permission by editing the config.yml.
  
  

Statistics

This plugin utilizes Hidendra's plugin metrics system, learn more.

Support

For support and bug reporting please use the BukkitDev ticket system.

Known Caveats

• player configured grapple tool pulls default tool instead.
• If you use Multicraft to install plugins you may get "Failed to install plugin: Malformed plugin info llamagrapple:" error.
  Manually installing the plugin works just fine. Suggestions are appreciated on how to fix this.
• Servers using JRE6 may not be able to use this version until they upgrade to JRE7+
  
  

Considerations/To-Do

• Split the grapple permission for spawning the tool and using the tool.
• Make grapple tool degrade, as well as inform users of how many uses remain, and when it is ready to use again.
• Fix config calls for custom player settings which are not pulling in the default grapple tool.
  
  Suggestions for improvements and additions to the next build are welcome in the comments.

Source Code

Not yet but, <3 CopyHeart <3

Other Plugins by this Author

llama - A collection of useful commands for both players and staff.
llamaArt - Turn your images into Pixel Art!