PeakShotgun

peak-shotgun

Turns PEAK's leftover blowgun into a shotgun.

A blast throws eight pellets in a short cone, about every 0.85 seconds. Scouts who are hit take a heavy Injury and get flipped. Zombies ignore Injury. The first hit flips them and adds Drowsy. The second hit knocks them out, and they stay down until PEAK kills them. See the zombie page.

Requirements

• BepInExPack for PEAK
• PEAKLib Core
• PEAKLib Items

PEAK does not include a shotgun model. The mod builds the gun from the blowgun already in the game, names it Shotgun, and makes it fire on its own. Installing the mod is the whole setup.

Where it spawns

• Roots: every run, at least two random luggage anywhere on the Roots map are forced to contain a shotgun. No mod config turns it off, but a custom run that disables the shotgun in its item settings gets none.
• Other biomes: luggage outside Roots is locked out only when Zombies is the sole enabled [Shootables] target. Any other shootables mix (or CanSpawnOnAnyBiome = true) allows RidiculouslyRare rolls in every biome. Roots still forces two suitcases either way.
• Cap: at most 4 luggage per biome can contain a shotgun in a single run (including Roots).

It looks like the blowgun, because that is the model PEAK ships. It does not replace the blowgun.

Configuration

After one launch, edit BepInEx/config/PeakShotgun.cfg:

| Section | Key | Default | Meaning |

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

| [Shotgun] | CanSpawnOnAnyBiome | false | Force rare rolls in every biome. When false, Roots-only only if Zombies is the sole [Shootables] target |

| [Shotgun] | Shots | 5 | Shots per shotgun (host's value in multiplayer) |

| [Shotgun] | EnableRecoil | true | Push the shooter back on each shot |

| [Shotgun] | Recoil | 5 | Recoil strength in m/s (0–10) |

| [Combat] | FriendlyFire | true | true = injure other scouts. false = knockback only, no Injury |

| [Shootables] | Zombies | true | Hit / knock down zombies |

| [Shootables] | Mandrake | false | Destroy mandrakes |

| [Shootables] | Beetles | false | Kill beetles |

| [Shootables] | Spiders | false | Stun spiders |

| [Shootables] | Spores | false | Break spore bombs (spore, explosive, poison) / clear spore clouds |

| [Shootables] | Scorpions | false | Kill scorpions |

| [Shootables] | Dynamite | false | Light dynamite fuses |

| [Debug] | EnableDebugMode | false | Host spawns test zombies, a shotgun, and luggage at the Airport / Shore |

In multiplayer, Shots, FriendlyFire, and every [Shootables] toggle come from the host, so the whole lobby plays by the same rules. Recoil and the hold pose stay per player.

The host keeps track of which suitcases gave a shotgun in each run, in BepInEx/config/PeakShotgun.loot.json, so the per-biome cap and the Roots picks survive loading a quicksave or the host leaving mid-run.

Install

• Install the package with r2modman / Gale, or drop PeakShotgun.dll into BepInEx/plugins/PeakShotgun.
• Launch PEAK from r2modman. Starting the game from Steam skips BepInEx.

How to test

• Set EnableDebugMode = true under [Debug] in the PeakShotgun config file (it appears after one launch). Host a run. On the Shore, three zombies appear near you, and a Shotgun is on the ground in front of you. With debug mode off (the default) nothing is force-spawned there; open Roots luggage to find the two guaranteed shotguns.
• Press primary fire. It shoots a spread of pellets about every 0.85 seconds, plays the shotgun fire sound and pushes you back a little. Each shotgun has 5 shots. Tune Shots, EnableRecoil, and Recoil under [Shotgun] as needed.
• Shoot another scout. They take a heavy Injury and get flipped. You cannot hit yourself.
• Reach the Roots (Peak ascent or higher for natural zombies). Open luggage until you find a shotgun, then shoot a zombie. The first blast flips it, and it can get back up. The second blast knocks it out, and it stays down. Or use debug Shore zombies from step 1.

Build

Requires PEAK installed (auto-detected under common Steam paths), or set PEAK_GAME_DIR