llamaGrapple
A simple yet customizable grapple hook!
A simple yet customizable grapple hook!
Note: This page written for R: llamaGrapple v1.6 for CraftBukkit/Spigot 1.10.02-R0.1
Features
- Easily manage custom configurations for privileged, donating, or ranked players.
- Set the tool or item used as the grapple hook.
- Set the sound the grapple makes.
- Set the distance the grapple will pull from. (max 100 blocks)
- Set the cool-down between grapple uses.
- Set the vertical-gain (elevation) of the grapple.
- Enable/Disable grapple hook durability.
- Enable/Disable grapple use for blocks below the player.
- Use Minecraft Time or System Time for servers that turn time off or use the "/gamerule doDaylightCycle false" gamerule.
Command / Usage / Permission
Command: | Description/Usage: | Permission: | |
/llamagrapple | Display command help. | llamagrapple.grapple | |
/lgrapple | Gives access to use the grapple hook. | llamagrapple.grapple | |
/lgrapple Gifts the grapple hook. Right click to use it. | llamagrapple.craft | ||
/lgrapple on|off Disables notifications of durability and cool-down. | llamagrapple.grapple | ||
/lgrapple status (playername) Display the status of a players config settings. -Leave (playername) empty to display the default group. | llamagrapple.config | ||
/lgrapple distance # (playername) Set the distance the grapple will reach. -Leave (playername) empty to set the default distance. This will also create the players settings if none exist. | llamagrapple.config | ||
/lgrapple cooldown # (playername) Set the cool-down between grapple uses. -Leave (playername) empty to set the default cool-down. This will also create the players settings if none exist. | llamagrapple.config | ||
/lgrapple gain # (playername) Set the vertical gain when grappling. -Leave (playername) empty to set the default gain. This will also create the players settings if none exist. | llamagrapple.config | ||
/lgrapple remove (playername) Remove a players grapple settings. | llamagrapple.config | ||
/lgrapple reload Reload the configuration file. | llamagrapple.config | ||
/lgrapple durable Toggle durability reduction on grapple hooks. | llamagrapple.config | ||
/lgrapple time Toggle between using Minecraft Time or System Time. | llamagrapple.config | ||
/lgrapple below Toggle grapple use for blocks below the players. | llamagrapple.config |
Examples
/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 off Disables notifications of durability and cool-down for the player sending the command. |
/lgrapple remove oooorgle Removes oooorgle's custom grapple settings. |
/lgrapple status practiclycrp Displays settings for player practiclycrp. |
/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
- Copy the .jar to your plugins folder and restart your server.
- Add permissions to your groups and players.
- Log in and type '/lgrapple' to start grappling.
Optionally:
- Disable notification of new updates for this plugin by changing NotifyOpsWhenPluginUpdates to false 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, grapple item, and default notification settings 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.
Previous Version Pages
R: llamaGrapple v1.5 for CB 1.7.9-R0.2 Jul 21, 2014
R: llamaGrapple v1.4 for CB 1.7.9-R0.1 May 28, 2014
R: llamaGrapple v1.33 for CB 1.7.9-R0.1 May 16, 2014
Known Caveats
- Be the first to report one.
Considerations/To-Do
Suggestions for improvements and additions to the next build are welcome in the comments.
Source Code
<3 CopyHeart <3
Donate
llamaGrapple is currently maintained by one individual in his free time. The amount of time he spends improving on this project is down to personal motivation, he doesn't get paid to keep this updated. If you find this plugin is a valued part of your server, please consider making a donation.
Other Plugins by this Author
llama - A collection of useful commands for both players and staff.
llamaArt - Turn your images into Pixel Art!
White-List Trust - Open your white-listed server when trusted players are online!
Well, it's nice to have the option, but it would be great if it could be turned off.
I'm having a few issues with the cooldown setting. For some reason, when I configure the cooldown to, say, 1 second, the notifications say that it will be reeling for 2 seconds, yet it never becomes usable again.
@MikeGold
We did give that a lot of consideration and decided to leave the ability to manually create by anvil.
Would it be possible to implement option to disable crafting of grapple hook all together? As I mentioned before, I want it to be only obtainable from the boxes that are dropped by mobs, so if anyone would be able to simply craft it, it wouldn't be good. Thanks in advance.
Awesome ;]
@MikeGold
Added the permission "llamagrapple.craft" which is required to access the command (/lgrapple) to spawn the grapple.
The existing permission "llamagrapple.grapple" is required to use the grapple and no longer gives access to spawn the grapple.
Added a function to make whatever tool is used as the grapple to degrade 1 per use. Fishing rod is 64, diamond pick is 1500 or so. etc.
and other changes... Hopeful to get 1.4 submitted in the next few days.
-Cheers
Basically if you would set it up that if fishing rod is named 'grappling hook' it will work as a grappling hook and there will be two permissions - one to use command to summon it and other to just use it, I would be more than happy, and I believe that it shouldn't be too much of work for you ;]. Then it should lose some durability with every throw, and it would be just perfect! :).
@FlOppythp
I use it with NoCheatPlus and have not had any complaints or been annoyed by any alerts. I have not used it with AnitCheat. If you notice issues with AntiCheat it would good to know but it seems more that AntiCheat is the issue, and not other plugins.
@MikeGold
I will consider adding those options. Thanks!
Hello. This plugin is awesome, yet at the current stage it's missing one important function. I want my normal users to be able to use it, yet I don't want them to be able to spawn it with command. I'm giving users items through treasure chests dropped by monsters or through crafting and spawning grapple with command would be too powerful. Also it would be nice if the grapple hook would break after certain amount of uses (just like fishing rod).
@Electro440
Yes Electro440 I am working on this exact thing. I've not as much time as before, but certainly want to improve it more. Version 1.33 should support setting each individual player settings, and all they will need to have it work is the default permission group llamagrapple.grapple. For those players who have access to the grapple but you have not made custom settings for, the defaults will apply. Hopefully sooner than later :)
Hey, are you still working on this plugin at all? I'm thinking about using it again in another server. It would be really awesome to have '2.' On the to-do list. Thanks! :D
@Thuzle
I will look into adding some adjustment settings into the config for to the velocity, gravity and trajectory. Thanks!
Is it possible to have it not bounce you through the air so high? Maybe make customization for Speed and Trajectory? That way we can make a rope arrow using your mod. Change material to Bow, increase distance, decrease speed of teleport and make the trajectory flat.
Another useful bit would to always end up on top of a block you aim at if it has two air blocks above it. This would simulate climbing an edge after grappling it instead of having to aim at the ceiling which there might not be any.
@Electro440
I will see if I can figure out how to do that. Thanks.
Hello, I have another suggestion. Maybe consider allowing plugin users to create groups, similar to the multiple homes limit in essentials. Thanks
@FxEvolution
I would guess that you are running JRE6? I am compiling with JRE7 and they are not backwards compatible. Thank you for bringing this to my attention. Well, I will put it on my list and try to recompile a version for JRE6, unless I run into problems with missing methods etc. Not sure how long of an eta though so please have patience. Or, if you are able to upgrade to JRE7 that is another possible solution as well.
JRE version docs points out that version 51 is JRE 7.
I wonder who else is getting this. It seems most servers use JRE7 at this moment in time.
Hello, I cannot install this plugin and I am getting this error. Unsupported major.minor version 51.0 Thanks in advance!
@ltjim007
:) Thank you for the video! I really appreciate it. I will put the distance increase on the to do list and see what I can make of it.
Im loving this plugin =D Similar to the grapple in Just Cause 2 which Is awesome
Ive also made a showcase video on this plugin: http://www.youtube.com/watch?v=qKJMxbylfvg
Possible improvement: - Having the ability to grapple further than 100 blocks eg 2000