You are viewing a potentially older version of this package. View Latest Version

Install

Date Uploaded

11 months ago

Downloads

21K

Size

116KB

Dependency string

tony4twenty-Useable_Rescue_Hooks-1.0.0

Download

Details Required (1)Versions

🪝 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:

Setting	Default	Description
DebugLogs	`false`	Verbose diagnostics. Keep false for normal play
MaxPullSeconds	`2.5`	Max wait after arming for the rope to “let go” before forced cleanup
CheckInterval	`0`	Poll cadence in seconds. 0 = every frame. Try 0.02 (~50 Hz) or 0.033 (~30 Hz)
PreferCaptureSlot	`true`	Prefer slot captured at shot time (then current/last). When false, allow hotbar scan

📦 Installation

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

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

🔮💡

Configurable pull force
Configurable uses amounts
Overall better implementation

🙏 Credits

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

🪝 Useable Rescue Hooks (One-Time)

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:

Setting

Default

Description

DebugLogs

false

Verbose diagnostics. Keep false for normal play

MaxPullSeconds

2.5

Max wait after arming for the rope to “let go” before forced cleanup

CheckInterval

0

Poll cadence in seconds. 0 = every frame. Try 0.02 (~50 Hz) or 0.033 (~30 Hz)

PreferCaptureSlot

true

Prefer slot captured at shot time (then current/last). When false, allow hotbar scan