🪝 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).

---

✨ 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

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

Thunderstore

• Use Thunderstore 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/Auto modes, rename, and basic polish.

---

🙏 Credits

• 🧠 Mod Author: tony4twenty
• Community feedback & playtesting via PEAK modding Discord.

---

📜 License

Personal use allowed; contact the author for redistribution/derivatives.