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]](/proxy/image?url=https%3A%2F%2Fi.imgur.com%2FvyZuIUR.png)
- 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]](/proxy/image?url=https%3A%2F%2Fi.imgur.com%2FSqcltkP.png)
/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]](/proxy/image?url=https%3A%2F%2Fi.imgur.com%2Fwttyzmd.png)
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]](/proxy/image?url=https%3A%2F%2Fi.imgur.com%2FA40joI3.png)
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