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

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

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. 🪢🔥