Reloadable Hand Cannons

Reloadable Hand Cannons 🪢🔫

Version 1.1.1 — Chain Launchers, Rope Cannons and Anti-Rope Cannons, unified and reloadable.

All 3 become "Hand Cannons" you can reload mid-run with pitons, normal rope, or anti-grav rope. The items name, look, and shot type follow whatever ammo you load.

Improved sync between all clients when the item is spawned or reloaded!

• Pair with Splice Spools to splice together full or leftover rope spools to free up inventory slots!
• Pair with Bridge Launcher for a Bridge Cannon roll on Chain Launchers. Empty stays empty after you shoot.
• 🗣️ 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 or chain launcher 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, Chain Cannon, Bridge Cannon, or Hand Cannon when empty
• 🖼️ Inventory icons follow the load: empty gun, piton, rope, anti-grav, or chain / bridge
• 👀 Barrel visuals update for piton vs rope vs anti-rope loads
• 🎲 Fresh Rope Cannons can spawn loaded as piton or rope (configurable chance). Anti-Rope Cannons and Chain Launchers remain vanilla on spawn (unless you have Bridge Launcher)

🎮 How to use

• Find a Rope Cannon, Anti-Rope Cannon, or Chain Launcher in the world
• Fire it until it’s empty
• Carry pitons and/or rope / anti-grav rope spools (hotbar and optionally backpack)
• Press R while holding the empty cannon
• 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

| Setting | Default | Description |

|---------|---------|-------------|

| Piton Spawn Chance | 0.5 | Chance (0.0–1.0) for a Rope Cannon (item 63) to spawn loaded with a piton instead of normal rope |

| Allow Backpack Reload | true | When true, reload can consume pitons/rope from a worn backpack |

| Reload Key | R | Key to reload an empty Hand Cannon from inventory |

📦 Installation

• Download
• Place the.dll in: /PEAK/BepInEx/plugins/
• 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. 🪢🔥