Movement

Hookshot

Find a new way across.

Turn a fishing rod into a grappling hook with per-player range, pull speed, and effects.

  • Spigot / Paper
  • Minecraft 1.20.1
  • Java 17+
  • MIT

What it does

Block grappling pulls the player to the hook. Catching a non-player living entity pulls it toward the player. Range, speed, boost, sound, and particles can be adjusted per player.

  • Toggle Mode
  • Block Grappling
  • Entity Grappling
  • Configurable Hook Velocity

Features

  • Toggle Mode

    Each player independently enables or disables grappling hook mode - casting while disabled behaves as a normal fishing rod with no side effects

  • Block Grappling

    When the hook lands on a block within range, the player is pulled toward that position immediately with velocity proportional to their configured pull speed and vertical boost

  • Entity Grappling

    When the hook catches a non-player living entity (mob, animal, etc.), the entity is pulled toward the player - useful for mob retrieval and custom gameplay scenarios

  • Configurable Hook Velocity

    Adjustable throw multiplier (1.0-5.0) controls how fast and far the hook travels through the air before landing

  • Configurable Pull Speed

    Adjustable pull speed (0.5-5.0) controls how quickly the player is moved toward the hook landing point

  • Vertical Boost

    Optional upward momentum (0.0-1.5) added to the pull direction, helping players clear ledges and obstacles naturally

  • Range Limit

    Each player has a maximum hook range (10-100 blocks set by the server); pulls beyond that range are cancelled with an informational message

  • Pull Cooldown

    A 250 ms gap is enforced between consecutive pulls to prevent rubber-banding or velocity stacking

  • Sound Feedback

    Optional pull sound (ENTITY_ENDER_DRAGON_FLAP) played at the player's location, toggleable per player

  • Particle Trail

    Optional CLOUD particle burst spawned at the player's location on pull, toggleable per player

  • Persistent Settings

    All per-player data is written to plugins/Hookshot/playerdata.yml on every change and on server shutdown, and reloaded on every player join

  • Reset Command

    Restores all personal settings to the server-configured defaults in a single command

Installation

  1. 1

    Check your server

    Run Spigot / Paper with Java 17 or newer, built for Minecraft 1.20.1. No other plugins are required.

  2. 2

    Add the JAR

    Stop the server, download Hookshot-1.0.1.jar, and place it in plugins/. When upgrading, replace the previous JAR.

  3. 3

    Start and configure

    Start the server and check the console. Review the generated configuration with the release documentation.

First command
/hookshot

Enable grappling mode, hold a fishing rod, and cast toward a block within your configured range.

Commands14

CommandPermissionDescription
/hookshothookshot.useToggle grappling hook mode on or off (shorthand for toggle)
/hookshot togglehookshot.useToggle grappling hook mode on or off
/hookshot range <value>hookshot.settingsSet your hook range in blocks - must be within server min/max
/hookshot speed <value>hookshot.settingsSet your pull speed - controls how fast you are pulled to the hook
/hookshot boost <value>hookshot.settingsSet your vertical boost - upward momentum applied on every pull
/hookshot velocity <value>hookshot.settingsSet your hook throw velocity - controls how far the hook is launched
/hookshot soundhookshot.settingsToggle your personal sound effects on or off
/hookshot particleshookshot.settingsToggle your personal particle effects on or off
/hookshot resethookshot.useReset all your settings to the current server default values
/hookshot infohookshot.useDisplay all of your current hookshot settings in chat
SubcommandSuggested values
range10, 20, 30, 50, 100
speed1.0, 1.5, 2.0, 2.5, 3.0
boost0.0, 0.3, 0.5, 0.8, 1.0
velocity1.0, 1.5, 2.0, 3.0, 4.0

Permissions3

PermissionDescriptionDefault
hookshot.useUse the grappling hook and run /hookshot toggle, /hookshot reset, /hookshot infotrue
hookshot.settingsAdjust personal settings with /hookshot range, speed, boost, velocity, sound, particlestrue
hookshot.adminAdministrative access to hookshot featuresop

Configuration14

KeyDefaultDescription
default-range30.0Starting hook range in blocks for new players
pull-speed2.0Default pull speed multiplier
vertical-boost0.3Default upward momentum added to the pull vector
hook-velocity-multiplier2.0Default hook throw speed multiplier
play-soundtrueWhether sound is enabled by default
show-particlestrueWhether particles are enabled by default
KeyDefaultDescription
min-range10.0Minimum range a player may set (blocks)
max-range100.0Maximum range a player may set (blocks)
min-pull-speed0.5Minimum pull speed a player may set
max-pull-speed5.0Maximum pull speed a player may set
min-vertical-boost0.0Minimum vertical boost (0 = no upward assist)
max-vertical-boost1.5Maximum vertical boost a player may set
min-hook-velocity1.0Minimum hook throw velocity a player may set
max-hook-velocity5.0Maximum hook throw velocity a player may set

Release notes

Hookshot v1.0.1

Hookshot v1.0.1 corrects release metadata and standardizes Java packaging.

Questions or an issue?

Bug reports, questions, and contributions go to this plugin’s GitHub repository.

Open an issue