Compatibility
Minecraft: Java Edition
26.3
26.2
26.1.x
1.21.4–1.21.11
Platforms
Tags
Creators
Details
Licensed MIT
Published 3 days ago
Updated last week
Grapple
A lightweight, physics-driven grappling hook plugin for Paper 1.21+. Instead of relying on clunky vanilla fishing rod bobbers or linear velocity pulls, Grapple uses tangential pendulum physics, camera-assisted arc steering, and multi-segment BlockDisplay Bezier curves for a smooth, responsive swinging experience.

Features
- Pendulum Swing Physics: Converts falling and outward momentum into tangential swing speed rather than dragging the player in a straight line.
- Curved 3D Rope Rendering: Uses 1.21
BlockDisplayentities arranged along a quadratic Bezier curve that whips on impact and bends with air drag. - Active Winch / Reeling: Right-click while attached to reel yourself in and shorten the rope on the fly.
- Camera Steering: Gently influence your swing arc by looking in the direction you want to curve.
- Action Bar Mini-HUD: Live readout showing current hook state (
SWINGING,REELING,LOOSE), speed meter (m/s), and rope length. - Resource Pack Ready: Full support for 1.21.4+
item_modelnamespaces and custom model data.
Controls
| Input | Action |
|---|---|
| Right-Click (Unattached) | Fire grappling hook |
| Right-Click (Attached) | Reel in / shorten rope |
| Left-Click or Sneak (Shift) | Cut rope / release early |
Commands & Permissions
/grapple— Gives the player a Grappling Hook item./grapple reload— Reloadsconfig.ymlon the fly.- Permission:
grapple.admin(Default:op)
Configuration (config.yml)
# Item Settings
item:
material: TRIPWIRE_HOOK
name: "Grappling Hook"
model: "" # 1.21.4+ item model key, e.g. "myserver:grappling_hook"
custom-model-data: 0 # Legacy numeric custom model data (0 = disabled)
# Grapple Settings
arrow-speed: 4.0
max-range: 56.0
min-rope: 2.5
max-speed: 1.35
cooldown-ticks: 10
# Physics tuning (careful increasing steer or spring too much)
physics:
attach-boost: 0.45
pull-speed: 0.065
gravity: 0.055
steer-force: 0.025
spring: 0.18
drag: 0.975
# Visuals & HUD
visuals:
rope-material: STRIPPED_ACACIA_WOOD
segments: 14
thickness: 0.07
show-hud: true

