PEAK
This package has been deprecated and may no longer be maintained. We recommend looking for an alternative.
Install with App

Details

Latest version
2.0.1
Last Updated
First Uploaded
Downloads
21.3K
Likes
1
Size
121KB
Dependants

🪝 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

  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

Thunderstore development is made possible with ads. Please consider making an exception to your adblock.