GrappleMomentum

GrappleMomentum

Turns Valheim's vanilla grappling hook into a fast, momentum-based traversal tool, inspired by

Pathfinder's grapple in Apex Legends. You get a kick when the hook lands, a pull that builds up

speed, a rope you can swing on, a boosted grapple jump, and you keep your speed when you let go.

• Client-side only. The server and other players don't need it. Other players see your

movement as normal.

• No new items or assets. It changes how the vanilla grappling hook behaves.
• Built for Valheim 1.0.16 with BepInEx 5.4.23.5. No Jötunn needed.

Features

• Initial impulse and progressive pull. When the hook lands you get a burst of speed toward

the anchor. After a short delay, the pull keeps accelerating, so longer grapples end up faster.

• Momentum on release. Release at any time to keep your full velocity. Releasing when you

reach the anchor also keeps it. Air braking is off until you touch ground or water, take a hit,

or slow below running speed (for example, by hitting a wall).

• Rope swing. If the anchor is above you, the rope works like a pendulum. Look away from the

anchor and steer with movement keys to open the arc.

• Grapple jump. Hook the ground ahead of you and jump within 0.5 s. You launch with a boosted

jump and keep your horizontal speed, and the hook stays attached. The tip of the rope glows gold

while the jump window is open.

• Off-hand hook. Fire the hook straight from your inventory with a mouse side button, even

with a sword or anything else in your hands.

• Short cooldown. The hook is ready again 0.2 s after a shot, even while you're attached.

There's no reload animation.

• Range indicator. With a hook in your inventory, a dot appears in the crosshair. It is

blue if a shot would latch within max range (60 m) and grey if it wouldn't.

• Feather cape friendly. Glide, hook in mid-air, get pulled, release, and keep gliding.

Controls

These are the defaults. GrappleMomentum uses your Valheim key bindings and supports gamepad.

| Action | Default |

|---|---|

| Fire the equipped hook | Attack (left mouse button) |

| Fire the hook from your inventory | Mouse back side button (Mouse4), configurable |

| Grapple jump | Jump, within 0.5 s of hooking the ground |

| Steer / open a swing | Movement keys or stick, plus camera direction |

| Release, keeping momentum | Block (right mouse button) |

Attacking or switching weapons doesn't release the hook. Dropping the hook from your inventory

does.

Quick start

• Get a grappling hook (spawn GrapplingHook 1 with devcommands for testing).
• On open ground, aim at the ground a bit ahead of you, fire, and press Jump right away.
• While flying, look slightly to one side and strafe to shape the arc.
• Release with Block and enjoy the momentum.
• Then try high anchors (trees, cliffs) to swing, and hooking from mid-air with a feather cape.

Stamina and fall damage

• Each hook shot costs 5 stamina. You can change this in the config. Jumps keep their vanilla

cost, including gear and feather cape modifiers.

• Gravity, collisions and fall damage work as in vanilla. If you want some fall-damage

protection after a release, set Inertia.FallGraceSeconds.

Configuration

The config file is BepInEx/config/dugi.GrappleMomentum.cfg. It is created the first time you

run the game with the mod. In r2modman, use Config editor. Changes apply live.

| Setting | Default | Description |

|---|---:|---|

| General.Enabled | true | Master toggle. Off restores vanilla behaviour. |

| General.StaminaPerShot | 5 | Stamina cost per hook shot (0–30). |

| General.CooldownSeconds | 0.2 | Time between shots. Replaces the vanilla reload (0–5 s). |

| Offhand.Key | Mouse4 | Fires the hook from your inventory. Mouse4 = back side button, Mouse3 = forward side button, None = off. |

| Pull.InitialImpulse | 8 | Speed added toward the anchor on attach, in m/s (0–30). |

| Pull.GroundLift | 1.5 | Minimum upward takeoff speed when you hook from the ground, in m/s (0–5). |

| Pull.JumpMultiplier | 1.5 | Gra