ShocklanceElementFix

A BepInEx mod for MycoPunk that fixes element upgrades on Shocklance to be properly exclusive.

Description

This client-side mod addresses an upgrade system issue where the Shocklance weapon could theoretically equip both Firelance (Elemental Blast) and Decaylance (Elemental Siphon) upgrades simultaneously. These elemental upgrades are designed to be mutually exclusive, as combining fire damage-over-time with damage-draining effects would break the intended weapon balance.

The mod automatically patches the upgrade type field of these specific upgrade instances (ID: 1561150 and 1601558) to OnlyOneOfThisType during game initialization, preventing the player from equipping both upgrades on the same weapon. This ensures proper exclusivity behavior for Shocklance elemental modifications.

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 "ShocklanceElementFix" under MycoPunk community
3. Install and enable the mod

Option 2: Manual Installation

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

Executing program

Once installed, the mod works automatically during game initialization:

Fixed Behavior:

• Element Exclusivity: Firelance and Decaylance cannot be equipped together on Shocklance
• Upgrade Type Modification: Specific upgrades forced to OnlyOneOfThisType during Global.Initialize
• Comprehensive Logging: Track all upgrade modifications in BepInEx console

Affected Upgrades:

• Firelance (1561150) - Elemental fire damage-over-time
• Decaylance (1601558) - Elemental damage siphon and life steal
• Only applies to these specific upgrade IDs on Shocklance weapons

Help

• Both elements still equippable? Make sure the mod is loading correctly - check BepInEx logs for initialization messages
• Only affects Shocklance? Yes, this mod specifically targets Shocklance elemental upgrades only
• Performance impact? Minimal - only runs during game initialization once per session
• Conflicts with mods? May conflict with mods that modify upgrade types or Shocklance upgrade behavior
• Upgrade IDs different? The mod targets specific IDs - if game updates change them, the fix won't work
• Verification? Check BepInEx console log for confirmation of upgrade type modifications

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