Skip to content

Add grappling hook - #493

Merged
alRex-U merged 5 commits into
alRex-U:1.19.2from
guivnf:grappling-hook
Aug 17, 2026
Merged

Add grappling hook#493
alRex-U merged 5 commits into
alRex-U:1.19.2from
guivnf:grappling-hook

Conversation

@guivnf

@guivnf guivnf commented Aug 15, 2026

Copy link
Copy Markdown
Contributor

Adds a grappling hook item to the ParCool tab.

Controls

  • Attack throws the hook, attack again releases it
  • Hold use to haul yourself along the rope, sneak to pay rope out
  • Movement keys steer the swing, jump releases with an upward boost

Swing

The rope is a length constraint solved over several substeps per tick. Contact points slide along block edges rather than snapping to corners, so the rope bends around obstacles as you swing past them and unwinds again in the order it wound on. The hook lets go if the line is overstretched or overloaded.

Momentum is kept for a short window after releasing, since Minecraft's air friction is tuned for jumps and would otherwise eat almost all of a swing's speed within a second.

Targeting

The exact crosshair ray is used when it hits something. When it misses, an assist cone is sampled and the hit closest to a good swing point is chosen. A marker shows where a throw would land, using the same prediction the throw itself uses.

Other

  • New Hook item, used to craft the grappling hook
  • Two ActionOption flags, needLearning and availableWhileExhausted, for abilities gated by an item rather than by the skill tree or stamina
  • Everything is configurable under [GrapplingHook] in the server and client configs
  • English and Japanese translations

Tested on 1.19.2 with Forge 43.5.0.

guivnf and others added 3 commits August 15, 2026 00:57
new item in the ParCool tab, crafted from a new hook part. attack throws
and releases it, holding use hauls you in, sneak pays rope out.

the swing is a rope length constraint solved with substeps. the rope
slides along block edges and bends around corners as you swing past them,
and lets go if the line gets overstretched or overloaded.

adds two ActionOption flags for abilities gated by an item rather than by
the skill tree or stamina.
@alRex-U
alRex-U merged commit 6f78535 into alRex-U:1.19.2 Aug 17, 2026
@alRex-U

alRex-U commented Aug 17, 2026

Copy link
Copy Markdown
Owner

Thank you so much!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants