Useable Rescue Hooks

🪝 Useable Rescue Hooks (One-Time)

Make Rescue Hooks disposable, smart, and smooth.

Fire it, ride it, hang or auto-release, then the hook vanishes from your hand + inventory the moment you’re done.

Fire it at your friend and yank them towards you! Just have a blast and I want to see some cinematic stories come to life!

Get the item via PEAK Luggage Items (pair this mod with it).

Find the mod in the Peak Modding Discord under #mod-releases to discuss mod related topics like issues/reports/appreciation.

✨ Features

• One-Time Use

Hook is consumed when you:

• Let Go manually (your release key)
• trigger Auto-Release in Auto mode
• successfully rescue someone (pulled target reaches you)

• Two Modes — toggle anytime:
• Hang: latch to walls without ragdoll/auto-release
• Auto-Release: classic yank (ragdoll + auto let-go)

• Rappel Controls (Hang mode)

Mouse Wheel shortens/lengthens rope

Defaults: start 2 m, min 0.05 m, max 40 m, step 3 m

• Rapid Reel (quality of life)

Left-click while hanging to zip toward the anchor briefly (no more scrolling forever).

• Safety & Polish
• No fall damage while truly hanging + 2 s grace after release
• Range cap: shots hard-capped to 40 m for balance
• Fire lockout while hanging (prevents re-firing line mid-hang)
• Drop & switch guard: you cannot drop/switch away mid-use (prevents forced drops when inventory is full)
• Clean inventory removal using the game’s RPC + slot cleanup
• Renamed in UI to “Rescue Hook”

🎮 Controls

• Fire: Left-Click (vanilla)
• Toggle Mode: 5 (Alpha5) → Hang ↔ Auto-Release
• Manual Let Go (wall only): Space
• Rappel (Hang mode): Mouse Wheel
• Up = shorten (climb)
• Down = lengthen (descend)
• Rapid Reel: Left-Click while hanging (short timed zip toward anchor)

⚙️ Configuration

A config file is created on first run:

BepInEx/config/tony4twentys.Useable_Rescue_Hooks.cfg

| Section | Key | Default | Description |

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

| LetGo | ModeToggleKey | Alpha5 | Toggle Hang ↔ Auto-Release |

| LetGo | ManualLetGoKey | Space | Manual Let Go while wall-hanging |

| UI | NotifyPosX | 0 | On-screen notifier X offset (pixels) |

| UI | NotifyPosY | -600 | On-screen notifier Y offset (pixels) |

| UI | NotifyColorHang | #9D7CFF| Notifier color in Hang |

| UI | NotifyColorAuto | #C54BFF| Notifier color in Auto-Release |

Hard-coded balance (for now):

• Max shot range: 40 m
• Rappel range: 0.05–40 m, step 3 m, default 2 m
• Fall-damage grace: 2 s after leaving hang

📦 Installation

Manual

• Install BepInEx (if not already).
• Copy the DLL to BepInEx/plugins.
• Run the game once to generate the config.
• (Optional) Customize keys & UI in the config.

• Use Mod Manager for one-click install.

🧪 Compatibility Notes

• Tested with C# 7.3 target.
• Uses Harmony patches with safe prefixes/transpilers designed to fail-open.
• Works in multiplayer; uses RPCs for cleanup and keeps slots in sync.

🔧 Troubleshooting

• “My hook dropped when switching items!”

This build blocks both dropping and slot switching during hook use, specifically to avoid forced drop when your inventory is full. If you still see a drop, report the exact steps (were you rescuing a player vs. wall-hanging, etc.).

• “It didn’t consume after climbing.”

The mod consumes after hang→climb transitions even if the hook is auto-unequipped mid-animation, by clearing held state and emptying the correct slot. If it doesn’t, share a log and which climb type (wall/vine/rope).

• “UI label is in the way.”

Tweak NotifyPosX / NotifyPosY and colors in the config.

🗒️ Changelog (highlights)

• 2.5.1 (current) — “Quiet” build; critical logs only; compile & API guard; same behavior.
• 2.5.0 — Logging trimmed (noisy debug removed).
• 2.4.x — Added switch blocking to prevent forced drop when inventory is full; Rapid Reel any-distance; robust slot-aware consumption; fall-damage grace.
• ≤2.3 — Initial one-time consume, Hang