Grappling Hook

Add a grappling hook without replacing your player controller

Grappling Hook is a reusable 2D grappling system for Godot built around one important idea:

The grappling system should handle grappling, not take over the rest of your character.

Keep your own movement, gravity, jumping and input code while Grappling Hook handles targeting, rope constraints and grappling behavior.

5 grappling behaviors

• Swing
• Pull Player
• Pull Object
• Fixed Rope
• Elastic Rope

Swing with momentum

Create rope-based swinging while preserving player momentum.

Tune rope length, swing control, reel speed and release behavior to fit anything from slow exploration to fast platforming.

Pull the player

Use Pull Player mode for hookshot-style movement that accelerates the character toward the attachment point.

Speed, acceleration and release behavior are configurable.

Pull physics objects

Pull Object mode works with compatible RigidBody2D objects.

The attachment follows the object as it moves, so the rope remains connected to the correct point.

Fixed and elastic ropes

Fixed Rope gives you a strict tether.

Elastic Rope behaves more like a spring, with configurable strength and damping.

Raycast or Anchor Assist

You can grapple directly onto collision geometry or place optional AsagoGrappleAnchor2D nodes for more intentional attachment points.

Anchor Assist can consider range, aim angle and target priority.

Know what the player will grapple before firing

The target preview API lets your game ask the grappling system what it would hit without actually firing.

This is useful for:

• Crosshair feedback
• Highlighting anchors
• Valid / invalid grapple indicators
• Contextual UI

Available methods include:

can_grapple_at()
get_best_target()
get_best_target_position()
get_target_preview()

Configure the rope

Control minimum length, maximum length, initial length, reeling, momentum, release boost, width and optional rope textures.

Your visuals, not mine

The grappling mechanics are separate from presentation.

Use your own textures, SpriteFrames, rope visuals, sounds and VFX without changing the core mechanics.

Reusable Grappling Profiles

Optional Godot Resources let you save and reuse complete Swing, Pull, Fixed or Elastic setups.

Included

• Complete Grappling Hook addon
• 5 grappling behaviors
• Grapple Anchor component
• Raycast targeting
• Anchor Assist
• Target preview API
• Reusable Grappling Profiles
• Custom visual and rope support
• Audio and VFX hooks
• Full GDScript source
• Documentation and integration guides

Compatibility

Godot 4.7+

Developed and tested with Godot 4.7.2 stable.

2D only.

Source included

The complete GDScript source is included and can be modified to better match the movement feel of your own game.

License

Commercial use is allowed in your own games and applications.

Redistribution or resale of the addon itself as a standalone product, template, toolkit or competing asset is not permitted.