Heavy Integration

A BepInEx mod for Mycopunk that combines heavy-weapon QoL into one package:

1. Loadout heavy — keep a heavy in your stored slot from the gear menu
2. Ammo regen — other weapons’ damage refills heavy magazine ammo
3. Heavy Focus — Focus heavies so upgrade drops can skew toward them
4. Selection UI — scrollable heavy crate list when many heavies are unlocked

Replaces the standalone LoadoutHeavy, HeavyAmmoRegen, and HeavySelectionExpansion mods. Disable those if both are installed to avoid double-patching.

Features

Loadout heavy

Vanilla loadouts only save two primaries and a grenade. Heavies are mission pickups in the stored slot. This mod lets you pick a heavy in the gear menu and always have it on the stored-weapon key.

• Left-click an unlocked heavy in the Heavy Weapons list to set it as loadout heavy
• Left-click again to clear (empty is allowed)
• Right-click still opens upgrades / inspect
• Spawned into Gear[5] (vanilla stored / heavy pickup slot)
• World pickups temporarily replace stored; your loadout heavy returns after drop (configurable)
• Selection persists in BepInEx config by gear ID

Ammo regen

Heavy magazines refill when your other loadout weapons deal damage — same damage-to-ammo idea primaries use, at a configurable rate.

• Detects heavies via GearType.Heavy across all gear slots (and held gear)
• Default 100% of vanilla conversion density into the heavy mag
• Optional ammo refund sound

Heavy Focus

Vanilla blocks Focus on GearType.Heavy in the gear UI. Backend drop weighting already supports any focused gear (~50% chance to force that gear’s upgrade pool). This mod re-enables the Focus binding on unlocked heavies that have world-pool upgrades.

• Uses the same Favorite / Focus bind as primaries
• Same gates as vanilla: unlocked, player level ≥ 5, gear menu (not showcase), world-pool upgrades
• Does not auto-focus when you equip a loadout heavy — Focus stays a separate action

Selection UI

When many heavies are unlocked (vanilla G6 plus custom heavies), the heavy crate WeaponSelectWindow grows its slot list but vanilla never lays out the extras or enables scroll — they clip past the menu. This mod:

• Stacks active heavy slots into a vertical list (using prefab spacing when available)
• Clips overflow with a rect mask
• Enables mouse-wheel / stick scrolling (reuses an existing ScrollArea/ScrollBar when present, otherwise a lightweight fallback driver)
• Hides unused trailing slots left over from a previous open with more heavies
• Null-guards ScrollArea.Scroll so Menu/ScrollWheel after UI teardown does not spam NREs

How to use

Loadout

1. Open the gear / loadout menu.
2. Open Heavy Weapons.
3. Left-click the heavy you want.
4. Close the menu — it appears on your stored-weapon hotkey.
5. Left-click the same heavy again to unequip it from your loadout.

Focus

1. Open the gear menu → Heavy Weapons.
2. Hover an unlocked heavy.
3. Press the Focus (Favorite) bind — same as focusing a primary.
4. Rainbow outline / “focused” property appear; upgrade drops skew toward that heavy.
5. Press Focus again to clear.

Heavy crate picker

Open a heavy weapon crate in-mission. If you have more unlocked heavies than fit on screen, scroll the list with mouse wheel or stick.

Configuration

Edit BepInEx/config/sparroh.heavyintegration.cfg (created on first launch):

The config file is watched and reloads automatically after you save changes. The ScrollArea null-guard stays on regardless of the Selection UI toggle.

Controls

Dependencies

• Mycopunk
• BepInEx Pack for Mycopunk 5.4.2403 or compatible

Installation

Thunderstore / r2modman (recommended)
Install from Thunderstore once published, or add a local profile install of your built package.

Manual
Copy HeavyIntegration.dll to:

<Mycopunk>/BepInEx/plugins/

Disable standalone LoadoutHeavy, HeavyAmmoRegen, and HeavySelectionExpansion if present.

Building

dotnet build --configuration Release

Output:

bin/Release/netstandard2.1/HeavyIntegration.dll

Notes

• Marked sandbox (ModFlags.IsSandbox) because it changes combat loadout and ammo.
• Multiplayer: gear spawn uses the normal owner → server path (best as host / listen-server owner).
• Compatible with mods that leave the stored slot alone (e.g. Equip All Weapons extras use other indices).
• Content mods may still list standalone HeavySelectionExpansion as an optional soft dependency; this package covers the same UI fixes.

Authors

• Sparroh

License

MIT — see LICENSE.

Changelog

1.0.0

• Initial release integrating LoadoutHeavy + HeavyAmmoRegen
• Loadout heavy: select in gear menu, spawn into stored slot, reapply after temporary pickups
• Ammo regen: other weapons’ damage refills heavy magazine ammo
• Heavy Focus: enable vanilla Focus binding on heavies so upgrade drops can skew toward them
• Integrated HeavySelectionExpansion
• Heavy crate WeaponSelectWindow: vertical layout, clip, and scroll when many heavies unlock
• ScrollArea null-guard (Menu/ScrollWheel NRE after UI teardown)
• Config: Selection UI → Enable Feature (default on; null-guard always on)