🪝 Useable Rescue Hooks (One-Time)

PEAK mod that makes Rescue Hooks true consumables: fire it, ride the pull, and when the rope lets go the hook is automatically removed from your hand and inventory. If you’re the host/MasterClient, one-time use is enforced for everyone in the lobby. ITEM NAME CHANGE is Client Side Only! If the host is the only one with the mod, other players will still see the item as "Chain Launcher"

PAIR THIS MOD WITH MY OTHER MOD PEAK Luggage Items TO OBTAIN THE ITEM

Any bugs, feedback, or fanmail can be launched directly into the PEAK modding discord

✨ Features

• 1️⃣ One-Time Use — consumed after the pull finishes (on let-go or a short timeout).
• 🧹 Clean Removal — destroys the held instance (so it vanishes from your hand) and clears the inventory slot; also clears currentItem one frame later as a safety net.
• 📏 Host-Enforced — if you’re host, all players’ hooks are one-and-done (clients don’t need the mod).
• 🚦 Robust Signals — arms at cast completion and finalizes on rope let-go (LetGo/Release/Detach variants supported); falls back to a timeout if needed.
• 🪶 Lightweight — optional interval polling, no per-frame allocations on the hot path, quiet logs by default.

Hot it works

• Rescue Hooks were already mostly functional but remain in inventory after use. I changed it to 1 time use with forced wipes.
• Host with mod: everyone’s hook becomes one-time use; removal uses the game’s RPCs so all clients stay in sync.
• Client (not host): only your hooks are one-and-done; others remain vanilla unless the host runs this plugin.
• Unmodded clients: still receive the host’s authoritative removals — no desync.
• Tracks your current item while using primary and arms cleanup when cast completes. Patches the hook’s let-go method dynamically (supports name variants). On let-go: destroys held object, clears slot, then nulls currentItem next frame.
• If let-go never arrives: timeout cleanup.

⚙️ Configuration

After launching the game once with the mod installed, a config file will be created at:

BepInEx/config/tony4twentys.Useable_Rescue_Hooks.cfg

You can customize:

📦 Installation

1. Download tony4twentys-Useable Rescue Hooks.dll
2. Drop it into your BepInEx/plugins/ folder
3. Load into PEAK and launch yourself (further)

🔥 Or use Thunderstore Mod Manager for 1-click install 🔥

🔮💡

1. Configurable pull force
2. Configurable uses amounts
3. Overall better implementation

🙏 Credits

• 🧠 Mod Author: tony4twenty
• 📚 Check out my other PEAK mods

[2.0.1] 2025-08-27

• OOOPS configs werent generating! They are now!

[2.0.0] 2025-08-16

• One-Time Use is now more protected. Anytime you use the item it will be taken from you no matter the mode at the appropriate time.
• Two Modes** — toggle anytime: Hang - latch to walls without ragdoll/auto-release & Auto-Release - classic yank (ragdoll + auto let-go)
• Keeps the core rescuce function where you can pull another player towards you
• Rappel Controls (Hang mode) : Mouse Wheel shortens/lengthens rope & Rapid Reel with Left-click while hanging to zip toward the anchor briefly
• No fall damage while truly hanging + 2 s grace after release
• Range cap**: shots hard-capped to 40 m for balance (instead of the 200 m that it had original, was too OP)
• 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

[1.0.0] 2025-08-14

• Initial Release