Reloadable Hand Cannons 🪢🔫

Version 1.0.0 — Rope Cannons and Anti-Rope Cannons, unified and reloadable.

Both the normal Rope Cannon and the Anti-Rope Cannon become Hand Cannons you can reload mid-run with pitons, normal rope, or anti-grav rope. The barrel name, look, and shot type follow whatever ammo you load.

• 🗣️ Find the mod in the Peak Modding Discord under #mod-releases for issues, reports, or appreciation

🛠️ Features

Ammo types (both cannon bodies)

• 📌 Piton — fires a climbing spike / piton shot
• 🪢 Normal rope — fires a standard rope shot (uses that cannon’s shot length)
• 🌌 Anti-grav rope — fires an anti-grav rope shot (uses anti-rope shot length)
• ✅ Either cannon (item 63 or 64) can be reloaded with any of the three ammo types

Smart rope spool usage

• 📏 Tracks real spool length (segments / meters) — a reload costs a full cannon shot’s worth of rope, not a whole spool by default
• 🧩 Combines spools when one spool isn’t long enough — uses multiple inventory/backpack spools until the required length is met
• ✂️ Supports partial spool deduction so leftover length stays on the spool when possible
• 🎒 Optional backpack reload — pull ammo from a worn backpack as well as hotbar slots

Reload flow

• 🔑 Hold an empty Hand Cannon and press R (configurable) to reload
• ⚡ If only one valid ammo option is available, it reloads immediately — no menu
• 📋 The ammo picker menu only opens when you have multiple ammo types available (e.g. a piton and enough rope). Pick with 1 / 2 / 3, click a button, or cancel with Esc / reload key again

World / visuals

• 🏷️ Dynamic names: Piton Cannon, Rope Cannon, Anti-Rope Cannon, or Hand Cannon when empty
• 👀 Barrel visuals update for piton vs rope vs anti-rope loads
• 🎲 Fresh Rope Cannons (item 63) can spawn loaded as piton or rope (configurable chance). Anti-Rope Cannons stay anti-rope on spawn

🎮 How to use

1. Find a Rope Cannon or Anti-Rope Cannon in the world
2. Fire it until it’s empty
3. Carry pitons and/or rope / anti-grav rope spools (hotbar and optionally backpack)
4. Press R while holding the empty cannon
5. If you only have one ammo type that works → it reloads right away
   If you have more than one → choose from the menu

Tip: Short leftover spools still count — the mod will combine them to make a full shot when needed.

⚙️ Config Options

Config file: BepInEx/config/tony4twentys.Reloadable_Hand_Cannons.cfg

📦 Installation

1. Download via Thunderstore
2. Place the .dll in: /PEAK/BepInEx/plugins/
3. Launch the game — config is generated on first run
   🪢 or use a Mod Manager 🪢

📦 Dependencies

Required

• BepInExPack_PEAK

📣 Feedback

Suggestions, ideas, or issues?
Reach out via the PEAK Modding Discord

🙌 Credits

• Author: tony4twenty

Happy climbing. 🪢🔥

Changelog

[1.0.0] - 2026-08-06

• Initial release of Reloadable Hand Cannons
• Unifies Rope Cannon and Anti-Rope Cannon into reloadable Hand Cannons
• Both cannon types can reload with piton, normal rope, or anti-grav rope
• Reload key (default R) while holding an empty cannon
• Ammo picker menu opens only when multiple ammo types are available; a single valid option reloads instantly
• Rope reloads use real spool lengths (full shot cost in segments/meters)
• Can combine multiple spools (including partials) to make up enough length for a shot
• Optional backpack ammo consumption
• Dynamic item names and barrel visuals based on loaded ammo
• Configurable piton spawn chance for Rope Cannons, backpack reload toggle, and reload key
• Basic multiplayer ammo sync via item data + host RaiseEvent