AtmosphericEnergizersRework

A BepInEx mod for MycoPunk that changes Atmospheric Energizers ammo regeneration behavior.

Description

This mod modifies the Atmospheric Energizers weapon so that instead of refilling the magazine clips, they now refill the ammunition reserves. This provides a more balanced ammo regeneration mechanic without ovely filling the active magazine.

The mod uses Harmony to patch the SwarmGun.OnActiveUpdate method with a prefix that handles ammo regeneration directly into stored ammo reserves, bypassing the original magazine refill logic.

Getting Started

Dependencies

• MycoPunk (base game)
• BepInEx - Version 5.4.2403 or compatible
• .NET Framework 4.8

Building/Compiling

1. Clone this repository
2. Open the solution file in Visual Studio, Rider, or your preferred C# IDE
3. Build the project in Release mode

Alternatively, use dotnet CLI:

dotnet build --configuration Release

Installing

Option 1: Via Thunderstore (Recommended)

1. Download and install using the Thunderstore Mod Manager
2. Search for "AtmosphericEnergizersRework" under MycoPunk community
3. Install and enable the mod

Option 2: Manual Installation

1. Ensure BepInEx is installed for MycoPunk
2. Copy AtmosphericEnergizersRework.dll from the build folder
3. Place it in <MycoPunk Game Directory>/BepInEx/plugins/
4. Launch the game

Executing program

The mod runs automatically when you launch the game. Once loaded, Atmospheric Energizers will refill ammunition reserves instead of magazine clips when the weapon's auto-regeneration conditions are met (weapon hasn't fired in 1 second, has bullets in the air, and regeneration interval has elapsed).

Help

• Mod not working? Ensure you've installed the correct version of BepInEx and that the DLL is placed in the right plugins folder
• Incompatibility issues? This mod uses Harmony patches. If you have other mods that modify SwarmGun ammo behavior, conflicts may occur
• Logs: Check the BepInEx console for any error messages on startup

Authors

• Sparroh
• funlennysub (original mod template)
• @DomPizzie (README template)

License

• This project is licensed under the MIT License - see the LICENSE.md file for details

Changelog

1.2.0

• Add ConfigManager with hot-reload (AimAnyTime-style)
• Configurable: Enabled, Fire Delay, Ammo Per Tick, Interval Multiplier, Cap Mode, Custom Cap
• Regen no longer skips the rest of SwarmGun.OnActiveUpdate (hover damage UI, heal pulse, auto-release, friend-fire, etc.)
• Skip custom regen while reloading (matches vanilla control flow)

1.1.1

• Maintenance and packaging update for the current build

1.1.0

• Refine Swarm Gun auto ammo regen while hovering bullets are active
• Enforce a short delay after last fire before regen

1.0.0

• Initial release
• Rework Atmospheric Energizers (Swarm Gun) auto ammo regeneration