Grappling Hook

A new item for White Knuckle: a grappling hook on a rope. Throw it, let it catch on something, and swing.

What it does

• Throw it and it flies in an arc. It catches on whatever solid thing it hits.
• The rope wraps around corners, beams and pipes, and unwraps when you swing back. You can loop it around the same beam several times.
• Swing from where it caught. If the hook catches on something moving, it drags you along with it.
• Climb or slide: hold Sprint to reel in and climb up, hold Crouch to let rope out and slide down.
• Slack rope falls and piles up on the floor instead of hanging in a straight line.
• Out of rope: if a throw doesn't catch anything, the hook hangs on the end of the rope. It can still catch if it swings into something, or if the rope is draped over a ledge when you pull away.
• The game's own barnacle hook is left alone. This is a separate item.

Controls

Getting the item

For now the item isn't in the game's loot. Spawn it from the console:

1. Open the console (Shift + backtick) and enter cheats.
2. Enter spawnitem item_swinggrapple.

Turning cheats on disables saving stats for that session. That's the game's own rule.

Settings

After the first launch, the settings are in BepInEx/config/(USER).whiteknuckle.swinghook.cfg:

• ThrowSpeed, ThrowGravity: how fast the hook flies and drops.
• RopeLengthMax: total rope you have (30 m by default).
• MinRopeLength: the shortest the free rope can be.
• SwingAssist: extra pull along the swing, so swings feel lively (0 = plain pendulum).
• ReelSpeed: climbing and sliding speed (0 turns reeling off).
• ReleaseHop: the boost when you jump off the rope.
• ModelScale, RopeScale: the size of the hook and the thickness of the rope.

Install

• With a mod manager (r2modman or Thunderstore Mod Manager): install it, then start the game from the manager.
• By hand: install BepInExPack 5 for White Knuckle first. Then copy the plugins folder from this zip into White Knuckle/BepInEx/, so the mod ends up in BepInEx/plugins/WhiteKnuckleSwingHook/ with its assets folder next to the DLL.

To uninstall, remove the mod in the manager, or delete BepInEx/plugins/WhiteKnuckleSwingHook.

Troubleshooting

• No item, or the console says it doesn't exist: check BepInEx/LogOutput.log for lines containing Grappling Hook. A working install logs Registered 'Grappling Hook' as Item_SwingGrapple.
• The hook or rope is invisible: the assets folder must be next to WhiteKnuckleSwingHook.dll.

Compatibility

• Single-player game, so there's nothing to sync.
• Doesn't change any of the game's own items.

Credits

• Made with BepInEx and Harmony.
• The hook model, rope, textures, held-item sprites and icon were made procedurally in Blender for this mod. No AI image generation was used.
• The item reuses the game's barnacle-hook sound effects, loaded from the game at runtime. They aren't included in this package.