Grappling Hook icon

Grappling Hook -----

Enhance world exploration with a grappling hook




Changes
  • Support for Minecraft version 1.19
  • Update /gh give command help output
  • /gh give command now gives a Grappling Hook with default values from config (rather than showing help output)
----------, Nov 9, 2022

Changes
  • Give command now accepts a Grappling Hook config file name
  • Various bug fixes
Create new configuration file at plugins/GrapplingHook/hooks/boss_hook.yaml with the following content:

Code (Text):

name: '&7&lThe Boss Hook'
lore:
- '&r&e<Unique Item>'
- ''
- '&r&7&o{USES_LEFT} use(s) left'
- ''
- '&r&7&oRight-click to throw'
uses: 50
distance: 0
auto_retract: true
auto_activate: true
blocks:
- GRASS
- OAK_LEAVES
pull_mob: false
rappel_mob: false
glowing: true
 
Give hook to a player:
Code (Text):
/gh give Notch boss_hook
----------, Dec 29, 2021

!! THIS UPDATE IS NOT BACKWARDS COMPATIBLE WITH <4.0 VERSIONS, PLEASE USE WITH CAUTION !!

This update was a long time coming. Now creating unique Grappling Hooks for perks/donors is now easier than ever. Sort of unstable, didn't get around to test it as much as I wanted to. Feedback welcome.

Changes
  • Give command updated to accept JSON.
    • /gh give Notch {"name": "&r&7&lThe Ultimate Hook", "lore": ["&5&oLegendary Collectible", "", "&7&oRight-click to throw"], "uses":5, "distance": 0}
  • Recipes have been reworked to allow for fully customizable hooks and per-recipe permissions (grapplinghook.craft global permission for all and grapplinghook.craft.<recipe-name>).
See plugin front page for updated config and usage.
----------, Dec 29, 2021

Changes
  • Add support for 1.17 and 1.18
    • Netherite items should now work in config
  • Update nbtiapi to 2.9.0-SNAPSHOT to support 1.18
  • Drop support for 1.12
----------, Dec 27, 2021

Changes
  • Update nbtiapi to 2.6.0 to improve compatibility on 1.16.x
----------, Nov 24, 2020

Changes:
  • Update internal dependencies to improve compatibility with 1.16.x
----------, Aug 25, 2020

Changes:
  • Bug fix: Grappling hook use/durability not being accounted for in off-hand.
----------, Aug 5, 2020

Changes:
- Fix NullPointerException error in console ​
----------, Jul 24, 2020

Changes:
  • Plugin updated to support 1.16.1
    • Please file bugs in the discussion forum of this plugin. Thank you.
----------, Jul 20, 2020

Changes
  • Allow rappelling with offhand.
----------, Jan 26, 2020

Changes
  • Fix bug causing item durability visual glitch
  • Fix bug where hook would lose durability on failed casts (failed rappel)
----------, Jan 21, 2020

Changes:
  • Add WorldGuard region flag `grappling-hook` to control the use of the Grappling Hook.
  • Add config message `cannotUse` that is printed when:
    • The player does not have permission to use the Grappling Hook
    • The WorldGuard grappling-hook flag is set to Deny
    • The Grappling Hook is on cooldown
    • The Grappling Hook throw event is cancelled
Config:

Code (Text):

messages:
  cannotUse: "&cYou cannot do that right now!"
 

[​IMG]
----------, Jan 5, 2020

Changes:
  • Fix bug where magma cube sound cannot be found on 1.12.2
----------, Jan 4, 2020

Changes
  • Add "glowing" config item to enable/disable the enchanted appearance of the Grappling Hook
Code (Text):

# Grappling Hook item enchanted look.
glowing: true
 
[​IMG]
----------, Dec 28, 2019

Changes:
  • 1.12 and 1.13 support
Note: The Grappling Hook will have limited functionality on 1.13.1 and older. Please do not report any features requests for these versions.
Note: If you are using 1.14/1.15 and something has broke, please report it in the discussion thread.
----------, Dec 27, 2019

Changes
  • 1.15 support :)
----------, Dec 24, 2019

Changes
  • Add attribute "max distance" to grappling hook to restrict how far away the grappling hook can be used.
[​IMG]

Config Changes


New variable 'DISTANCE' in lore.

Code (Text):

lore:
- '&r&7&oRight-click to throw'
- '&r&7&o{USES} use(s) left'
- '&r&7&o{DISTANCE} block distance'
- '&r&e<Collector''s Item>'
- 'Found at the bottom of a'
- 'cliff..'
 
Command Changes

Code (Text):
# Give player Critikull a Grappling Hook with 5 uses and a maximum of 10 blocks

/gh give <player> <uses> <distance>
/gh give Critikull 5 10
----------, Sep 21, 2019

Changes

  • Add config option "allow_pull" to allow/disable hooking and pulling entities. Disabled by default.
  • Add config options "pull_multiplier" to modify the pull strength.
Code (Text):
allow_pull: false
# 1.0 = Pull strength of fishing rod
pull_multiplier: 1.0
  • Prevent players from glitching through roof.
----------, Sep 21, 2019

Changes
  • Add permission to control crafting recipe
    • Note: can be used as a donor perk
  • Add permission to control usage of the grappling hook
    • Note: can be used to control usage in different WorldGuard regions
grapplinghook.use: Given to all players by default. Ability to use the grappling hook.
grapplinghook.craft: Given to all players by default. Ability to craft a grappling hook.
----------, Sep 13, 2019

Changes
  • Recipes now produce grappling hooks with a configurable number of uses.
    • Note: Recipes are not added by default. You have to add them to the config yourself.
    • Note: Old recipes are not converted to the new structure, you will have to remake them.
Examples:

Code (Text):

# Custom recipes (optional). Requires a restart.
recipes:
  # One use
  '1':
    slot2: IRON_INGOT
    slot4: STICK
    slot6: IRON_INGOT
    slot9: IRON_INGOT
  # Two uses
  '2':
    slot2: GOLD_INGOT
    slot4: STICK
    slot6: GOLD_INGOT
    slot9: GOLD_INGOT
  # Unlimited uses
  '0':
    slot2: DIAMOND
    slot4: STICK
    slot6: DIAMOND
    slot9: DIAMOND
 
----------, Sep 10, 2019

Changes
  • Fix bug where players were glitching when spamming right-click during a rappel.
  • Show number of uses left in the lore of the item.
Code (Text):

lore:
- '&r&7&oRight-click to throw'
- '&r&7&o{USES} use(s) left'
- '&r&e<Collector''s Item>'
- Found at the bottom of a
- cliff..
 
[​IMG]

[​IMG]
----------, Sep 8, 2019

Major changes
  • This version only supports 1.14+
  • This version breaks grappling hooks from version 1.x
  • Tons of bug fixes
  • Grappling hook now uses NBT tags to track state
  • "Cooldown stick" is gone
  • Can give grappling hooks custom amount of "uses"
    • Unlimited uses:
      • /gh give <player>
    • Limited uses:
      • /gh give <player> 5
Config changes
  • Removed `uses`. This is now specified in the give command.
    • /gh give <player> <uses>
  • Added `nofall_delay` to prevent rappelling fall damage during a certain amount of time
  • Added `throw_cooldown` to prevent players from spamming throws.
----------, Sep 6, 2019

Changes
  • Prevent players from stashing the cooldown stick in chest (inventories)
  • Limit grappling hook sounds to 32 blocks
----------, Sep 1, 2019

Changes
  • If the grappling hook was on cooldown and a player died then the cooldown item would be dropped and the grappling hook could not be used. This version fixes this issue.
----------, Sep 1, 2019

Changes
  • Fix recipe causing conflicts with other plugins/items
Note: Changing recipe requires a restart of the server
----------, Aug 31, 2019

Changes
  • Compatibility fixes for 1.12 and 1.13
----------, Aug 31, 2019

Changes

  • Add durability (uses) to the grappling hook
Config

Code (Text):

# Number of uses before the grappling hook breaks. 0 for unlimited uses.
uses: 0
 
----------, Aug 30, 2019

Changes
  • New config to restrict which blocks can be used to latch and rappel to
Config

Code (Text):

# Blocks that can be used with the grappling hook. Leave empty (or remove) to use all blocks.
blocks:
  - LEAVES
----------, Aug 29, 2019

Changes:
  • Auto-retract: Automatically retract grappling hook after a failed throw
  • Auto-rappel: Automatically rappel after the grappling hook latches onto a block
Config Updates:

Code (Text):
# Automatically retract grappling hook after a missed throw.
auto_retract: false

# Time (in milliseconds) to wait before retracting the grappling hook after a missed throw.
auto_retract_cooldown: 1000

# Automatically rappel after latching onto a block.
auto_rappel: false
----------, Aug 29, 2019

Resource Information
Author:
----------
Total Downloads: 23,642
First Release: Aug 29, 2019
Last Update: Nov 9, 2022
Category: ---------------
All-Time Rating:
38 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings