Grappling Hook icon

Grappling Hook -----

Enhance world exploration with a grappling hook



[​IMG]

Please do not ask for support or report bug fixes in the reviews. Use the discussion forum or my Discord (Crit#6408) to report issues.

[​IMG]
  • Easy to use
  • Customize Grappling Hook
    • Name
    • Lore
      • Can use the following variables in the lore:
        • USES: Total uses
        • USES_LEFT: Uses remaining
        • USE_COUNT: Current use count
        • DISTANCE
    • Uses (set to 0 for unlimited)
    • Distance (set to 0 for unlimited)
    • Glowing
    • Auto rappel
    • Auto retract
    • Pull mobs
    • Rappel to mobs
    • Mobs to allow
    • Blocks to allow
  • Configurable recipes with permissions (requires restart)
  • Configuration files for hooks (plugins/GrapplingHook/hooks/<hook-name>.yaml)
  • Stabilization for smooth animations
  • Configurable pull strength
  • WorldGuard region flag
[​IMG]

/grapplinghook give <player> <hook-name|json> Give player a Grappling Hook.

Using JSON:

Code (Text):

/gh give Notch {"name": "&7&oThe Ultimate Hook", "uses":25, "distance": 0, "pull_mob": false, "rappel_mob": true, "mobs":["SHEEP"], "blocks": ["OAK_LEAVES"], "auto_retract": true, "auto_activate": true, "glowing": true, "lore": ["&r&e<Epic Collectible>", "", "&7&oRight-click to use"]}
 
Using hook-name (ensure that a configuration file of the same name exists in the plugins/GrapplingHook/hooks/ directory - plugins/GrapplingHook/hook/boss_hook.yaml):

Code (Text):

/gh give Notch boss_hook
 
/grapplinghook debug Toggle debug logging in console.
/grapplinghook reload Reload configuration.

[​IMG]

grapplinghook.give: Given to OP by default. Give command.
grapplinghook.debug: Given to OP by default. Debug command.
grapplinghook.reload: Given to OP by default. Reload command.
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 all grappling hook recipes defined in config.
grapplinghook.craft.<recipe-name>: Ability to craft a single recipe defined in config. Not given by default. Note: Remove permission grapplinghook.craft from users when giving per-recipe permissions.
[​IMG]
plugins/GrapplingHook/config.yaml

Code (Text):

# ________ .__ .__ ___ ___ __
# / _____/_______ _____ ______ ______ | | |__| ____ ____ / | \ ____ ____ | | __
#/ \ ___\_ __ \\__ \ \____ \ \____ \ | | | | / \ / ___\ / ~ \ / _ \ / _ \ | |/ /
#\ \_\ \| | \/ / __ \_| |_> >| |_> >| |__| || | \/ /_/ >\ Y /( <_> )( <_> )| <
# \______ /|__| (____ /| __/ | __/ |____/|__||___| /\___ / \___|_ / \____/ \____/ |__|_ \
# \/ \/ |__| |__| \//_____/ \/ \/

# Print debugging messages to console.
debug: true

#
# Default Grappling Hook config.
#

# Grappling Hook item display name.
# Note: Changing this will break existing Grappling Hook's
name: '&bGrappling Hook'

# Grappling Hook lore text
# Variables:
# USES Total number of uses. Displays "Unlimited" when grappling hook has 0 uses.
# USES_LEFT Number of uses left. Displays "Unlimited" when grappling hook has 0 uses.
# USE_COUNT Number of times the grappling hook has been used. Displays "Unlimited" when grappling hook has 0 uses.
# DISTANCE Maximum distance (in blocks). Displays "Unlimited" when grappling hook has 0 distance.
lore:
- '&r&e<Collector''s Item>'
- ''
- '&r&7&o{USES_LEFT} use(s) left'
- '&r&7&o{DISTANCE} block distance'
- ''
- 'Found at the bottom of a'
- 'cliff..'
- ''
- '&r&7&oRight-click to throw'
# Number of times the grappling hook can be used. 0 for unlimited.
uses: 0
# Maximum distance in blocks that the grappling hook can be used. 0 for unlimited.
distance: 0
# Automatically retract grappling hook after a missed throw.
auto_retract: true
# Automatically rappel or pull after latching on to a block or entity.
auto_activate: true
# Blocks to allow rapelling to. Empty to allow all.
#blocks:
# Mobs to allow pulling/rapelling to. Empty to allow all.
#mobs:
# Pull mob when grappling hook latches.
pull_mob: false
# Rappel to mob when grappling hook latches.
rappel_mob: false
# Add glowing effect to ItemStack
glowing: true

#
# Global config.
#

# Time in milliseconds between each rappel.
rappel_cooldown: 500

# Sound when player is rappelling
rappel_sound: ENTITY_MAGMA_CUBE_JUMP

# Sound when hook latches to a block
latch_sound: ENTITY_SHEEP_SHEAR

# Grappling hook breaking sound
break_sound: ENTITY_ITEM_BREAK

# Hook throw speed multiplier. Original speed is based off a fishing hook cast.
throw_speed_multiplier: 2.8

# Number of milliseconds to wait before another throw.
throw_cooldown: 1000

# Disable fall damage after a player rappels.
nofall: true

# Number of milliseconds after rappelling to cancel fall damage.
nofall_delay: 3500

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

# Stabilize player to final location using teleport.
stabilize: true

# Stabilize player when X blocks away.
stabilize_distance: 5

# Pull strength multiplier. 1.0 = default fishing pole strength.
pull_multiplier: 1

# Recipes. Crafting ingredients are specified from slots 1-9 in the following order:
#
# 1 | 2 | 3
# 4 | 5 | 6
# 7 | 8 | 9
#
recipes:
  treetop_hook:
    hook:
      name: "&r&2&lTree Top Climber"
      uses: 25
      distance: 0
      auto_activate: true
      auto_retract: true
      glowing: true
      lore:
      - "&r&e<Collector's Item>"
      - ''
      - '&r&7&oRight-click to throw'
      blocks:
      - OAK_LEAVES
      - AZALEA_LEAVES
      - ACACIA_LEAVES
      - BIRCH_LEAVES
      - DARK_OAK_LEAVES
      - FLOWERING_AZALEA_LEAVES
      - JUNGLE_LEAVES
      - SPRUCE_LEAVES
      pull_mob: false
      rappel_mob: false
    recipe:
      slot1: NETHERITE_INGOT
      slot2: NETHERITE_INGOT
      slot3: NETHERITE_INGOT
      slot4: STRING
      slot7: STRING

messages:
   permissionDenied: '&cYou do not have permission!'
   playerNotFound: '&cPlayer not found!'
   reload: '&e[GrapplingHook] Config reloaded!'
   give: '&ePlayer was given a grappling hook!'
   debugOn: '&e[GrapplingHook] Debug on!'
   debugOff: '&e[GrapplingHook] Debug off!'
   invalidInput: '&cInvalid input. Check your input and try again.'
 
plugins/GrapplingHook/hooks/boss_hook.yaml

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: 0
distance: 0
auto_retract: true
auto_activate: true
blocks:
- GRASS
- OAK_LEAVES
pull_mob: false
rappel_mob: false
glowing: true
 
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