You are viewing a potentially older version of this package. View all versions.
Sparroh-CoreProtectionRework-2.0.0 icon

CoreProtectionRework

Nerfs piercing and explosive damage that bypasses enemy shell armor to hit cores. Configurable structural armor falloff.

Date uploaded a month ago
Version 2.0.0
Download link Sparroh-CoreProtectionRework-2.0.0.zip
Downloads 78
Dependency string Sparroh-CoreProtectionRework-2.0.0

This mod requires the following mods to function

BepInEx-BepInExPack_Mycopunk-5.4.2403 icon
BepInEx-BepInExPack_Mycopunk

BepInEx pack for Mycopunk. Preconfigured and ready to use.

Preferred version: 5.4.2403

README

Core Protection Rework

A BepInEx mod for Mycopunk that reduces how hard piercing and explosive damage can skip enemy shell armor and dump damage straight into cores.

Features

  • Structural armor checks — uses the live enemy component tree (EnemyShell under a core), not fragile GameObject name matching.
  • Piercing falloffIgnoreImmunity can still hit cores, but damage scales down for each living shell still attached.
  • Explosive falloff — explosive, AOE, and mega-explosive core hits are scaled while shells remain.
  • Vanilla bonus replacement — the free full-armor explosive core poke and the vanilla x2 explosive core bonus are replaced with configurable values (defaults: heavily reduced / no bonus).
  • Config file — tune penalties, floors, and bonuses without rebuilding. Edits to the cfg on disk hot-reload in-game (debounced).

What this does not do

  • It does not re-implement outer→inner shell gating (vanilla EnemyShell already blocks hits on shells that still have shell children).
  • It does not force-kill cores when shells die (vanilla already handles core death when children are gone).

Getting Started

Dependencies

  • Mycopunk
  • BepInEx 5.4.2403+ (Mycopunk pack)
  • HarmonyLib (via BepInEx)

Building

dotnet build --configuration Release

Output DLL: bin/Release/netstandard2.1/CoreProtection.dll

Installing

Thunderstore / r2modman: install the package normally.

Manual: copy CoreProtection.dll to <Mycopunk>/BepInEx/plugins/.

Configuration

After the first launch, edit:

BepInEx/config/sparroh.coreprotection.cfg

Section Key Default Meaning
General EnablePierceNerf true Scale IgnoreImmunity (armor-pierce) damage against cores still protected by shells
General EnableExplosiveNerf true Scale explosive / AOE / mega-explosive damage against armored cores, and replace vanilla core explosive bonuses
Piercing ShellPenalty 0.55 Falloff strength per alive shell (higher = harsher)
Piercing MinMultiplier 0.25 Lowest pierce multiplier against armored cores (0–1)
Explosives ShellPenalty 0.75 Falloff strength per alive shell (higher = harsher)
Explosives MinMultiplier 0.15 Lowest explosive multiplier against armored cores (0–1)
Explosives FullArmorMultiplier 0.10 Extra multiplier when no shells have been broken yet (vanilla free core hits). 0 blocks effective damage
Explosives OpenCoreBonus 1.0 Replaces vanilla x2 explosive bonus once the core is fully exposed (0 shells left). 1 = no bonus, 2 = vanilla
Explosives ArmoredBonus 1.0 Replaces vanilla x2 explosive bonus while some shells remain but the core is already vulnerable. Applied after shell falloff

Falloff formula:

multiplier = max(MinMultiplier, 1 / (1 + ShellPenalty * aliveShells))

Multiplayer

This mod changes combat math and is marked as sandbox content that all players should run at the same version. The host’s damage path is what matters for application; keep the mod matched across the lobby.

Changelog

See CHANGELOG.md.

License

MIT — see LICENSE.

Author

Sparroh

CHANGELOG

Changelog

2.0.0

Changed

  • Full rewrite as a standalone mod (separated from the old rebalance compilation)
  • Shell detection now uses the live enemy component tree instead of GameObject names
  • Pierce (IgnoreImmunity) core damage scales with living shells still attached
  • Explosive / AOE / mega-explosive core damage scales with living shells
  • Vanilla full-armor explosive core bypass and x2 core explosive bonus are replaced with configurable values
  • MycoMod flags corrected for gameplay-affecting multiplayer use (IsSandbox + same-version requirement)

Added

  • BepInEx config for pierce/explosive toggles, shell penalties, multiplier floors, and core bonuses

Removed

  • Fragile GameObject name-based shell layer detection
  • Global shell ID maps
  • Redundant core-kill logic (vanilla already handles core death when children are gone)

1.0.0

Added

  • Initial release
  • Layered shell/core protection rework (name-based)