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!
Version 1.6 for CB/Spigot 1.10 has been submitted. Support for both arms (great addition to PVP while using an Elytra and bow!)
@xlunabloodthornx
Hopefully this clears this up for you as well.
@xlunabloodthornx
Sorry such a late reply. Since CB going down I have not done any Minecraft programming and haven't checked in a while. I don't seem to get notifications of comments here anymore either..
I would first want to check that the players or group they belong to have the llamagrapple.grapple and the llamagrapple.craft permission. If they do perhaps you could submit a ticket which gives me more to work with in troubleshooting. I am really glad you like it and am sorry you are experiencing a problem with it.
This is by far the most fun thing i have ever used made my day. most fun plug ever!
however i did find a problem with it thats quite bad when my normal players log on they get spammed they arnt allowed to use this.
sapose to be a dona perk and i never gave any perms to the default players so why is this spamming them?
@SpiderLincoln
Yes it is submitted and waiting approval. Hopefully sooner than later.
Can you add the Duribilty option or add the beta plugin soon?
Thanks, Lincoln
@unholyjulien
Thanks for bringing that to my attention unholyjulien! My testing environment is very small and limited so I have a hard time thoroughly fleshing out all the bugs without releasing into the world for others to help me do so.
I have retracted, fixed and re-uploaded version 1.5 so it includes this fix. I hope it doesn't take them a few weeks to approve it. Thanks for your patience while we wait for it. and be sure to let me know of any problems or ideas you may have to improve this plugin.
Take care.
I having an issue where players do not have permission or are a lower rank to have lgrapple but each time they right click with any item doesn't matter they get a message on there screen that says "You do not have permission to use llama grapple. also i used commands to see status on that player and it tells me <player> has no customer settings. try /lgrapple status or just <player> has no customer settings. I have pictures from player and I have a screen shot from my screen. But do not know how to put it in the text.
@Ferretwork
Hi Ferretwork!
Yes there is an option for this. Simply edit the config.yml and change GrappleHasDurability: true to false.Sorry! for some reason I thought this option was in the version you are using. It is in the next update, which I think still needs a bit of testing so I will upload it as a beta.Hey guys, great plugin! I was wondering if you could add an option to disable durability? I'd like for my players to not have to worry about durability.
@DahDuff Yes well perhaps contact the author of your mini-game plugin. That is where the fix you are asking for is needing to be made.
@oooorgle
Umm, okey thank you for trying to help me out I'll see what I can do to use this plugin as it is..however them having to execute a command while playing is out of the question for me.
@Astro8794
Introduced in 1.6 there is a command to disable the day-night cycle. With this set to false the cool-down never grows old and the grapple doesn't reset. This command will toggle time on a map. (Added a TODO to consider accommodating this game-rule.)
/gamerule doDaylightCycle [true/false]
@DahDuff " Does that mean that I can choose a tripwire hook"
Yes, but the tripwire would need to be named "grapple hook" too. so the same dilemma exists with any item we would set it to. The problem with making a tripwire (with no name) the grapple is that all tripwires then become grapples and not tripwires. The name is the unique identifier.
How about this idea? When they find the tripwire (it being the configure grapple tool) they could perhaps use the command /lgrapple to turn it into the grapple hook? Assuming of course that they do not have access to be gifted the grapple by the plugin.
So far I am not thinking up any other acceptable accommodation for this. I would be surprised if the author of the mini-game plugin would not be open to making his plugin more diverse by adding in named items, enchantments and lore.
About durability: The durability is that of the item. So whatever a tripwires durability is, is what it would use for the durability.
@oooorgle
I'm using a minigame plugin that let's you put several items in random chests with a percentage for each item and so on. However, like you would expect it allows you to put only normal vanilla items in the config. That makes it practically impossible to use the grappling hook because they would have to rename it each time they get their hands on it using an anvil. What I want is to be able to give them a regular item that is specified in your plugin's config in a way that is usable. However, I think that I'm a little bit confused here, in the plugin's features it says that you are able to change the item id or tool id for the grappling hook. Does that mean that I can choose a tripwire hook and use it as a grappling hook or it just affects the durability of the fishing rod?
@_DaBeagle_
I will look into adding that in some fashion. It certainly is possible.
@oooorgle
So I was just swinging around the city from Attack on Titan using my grapple hook, and it hit me: it would be really cool if you could pull yourself toward giants (or entities in general). Would that be possible?
@_DaBeagle_
I definitely will give more thought to that portion of the grapple function. It has been mostly built with focus on the upward velocity. Thanks.
First I want to say I love this plugin, best grapple hook plugin by far. And also I have a suggestion: When you grapple downward, it still launches you upward. Realistically wouldn't a grappling hook pull you down if you shot it downward? Other than that, this plugin is perfect. I love the customization!
@DahDuff
If I understand you correctly, if you find a fishing-rod you would like to be able to make use of it as the grapple hook? The grapple hook is simply the normal item but that you have named, same way you create a name-tag for your pet.. That is the only difference. The item needs to be set as the grapple hook for your player or the default group in the config.yml. Then simply place it in an anvil and name it "Grapple Hook" to make it work.
When you mention Global Items, I'm unsure of what exactly you mean. Any holdable item can be set as the grapple hook. For items like food or blocks, their durability is 1 so its not really practical to use an item like that unless that is your intention. llamaGrapple doesn't set an items durability but only uses the existing durability of the item.
If you meant to ask how you can spawn the grapple without needing to find or craft the item, simply grant the llamagrapple.craft permission and do /lgrapple in game.
Did I even come close to answering what you were asking?
@oooorgle
Could you maybe add an option for global items? I mean that if you ever get your hands on that item without further crafting recipes to be able to use it. ex.normal fishing rod, normal tripwire hook, normal shears or whatever and the default status of it...uses..cooldown and stuff :) that option could by turned off via the config to allow for the plugin's use so far. I really like the way the player gets pulled keep up the good work!:)