CombatAdjustments

Combat Adjustments — Shield Rework

BepInEx plugin implementing the shield stagger / durability / tower block-armor rework described in docs/shield-rework-requirements.md.

What it does

| Change | Towers | Round shields | Bucklers | | --- | --- | --- | --- | | Flat stagger grant (equipped) | yes (Flametal +70 max) | yes (Flametal +45 max) | yes (Carapace +20 max) | | +5% block armor (ceil) | yes | no | no | | +20% durability (ceil to 5) | yes | yes | no | | Orange tooltip Stagger: +N | yes | yes | yes (if grant > 0) |

Tower grants are seeded from post-block leftover against each shield's native medium hit (normalized to Flametal +70), not block armor alone. Round/buckler grants use block-armor ratios from their anchors, then snap to the nearest 5. Every grant is overridable in BepInEx/config (client) or config/bepinex (dedicated server).

Two-handed melee

• Greatswords, battleaxes, and sledges receive Balanced hyper armor: it

begins when the real attack animation begins and ends after that swing's hit event. During that window stagger gain is blocked. Incoming damage and knockback are unchanged. Tooltips show orange Hyper-armor.

• Greatsword primary-chain swings deal 1.5x stagger.
• Greatswords, battleaxes, and sledges deal +10% damage (bonus rounded down

per damage type; reflected on weapon tooltips). Atgeirs are unchanged.

• Two-handed club ground slams (Stagbreaker, Iron Sledge, Demolisher) grant

adrenaline per enemy hit, matching swing attacks (vanilla pays area attacks once per slam).

Feasts

Biome feasts unlock after the previous biome boss instead of that biome's own boss (Plains after Moder, not Yagluth). Sailor's Bounty still needs a serpent. See docs/feasts.md.

Every feast also gains extra food stats (configurable; defaults below). Tooltips and already-eaten feasts pick up the new numbers.

| Feast | Extra health | Extra stamina | Extra eitr | | --- | --- | --- | --- | | Most feasts | +10 | +10 | — | | Sailor's Bounty | +15 | +15 | — | | Mistlands | +10 | +10 | +7 (33 → 40) | | Ashlands | +10 | +10 | +12 (38 → 50) | | Deep North | +10 | +10 | +17 (43 → 60) |

Boss unlocks are not configurable.

The Deep North eitr bonus started as an extrapolation and was confirmed against an in-game dump on 1.0.7 (vanilla 43). The dump's FOODS section prints each feast's vanilla values beside its current ones — see docs/feasts.md.

Sailing

Calm wind (0–60%) keeps the vanilla intensity ramp (0.287 → 0.7). Above 60% the factor keeps climbing linearly to 2.0 at full storm. Ocean ThunderStorm chance is raised from ~7% to 21%. See docs/sailing.md.

Difficulty scaling

Effective enemy HP keeps scaling with nearby players past vanilla’s 5-player cap (+30% per extra player). Enemy damage dealt stays capped at 5. Toggle with Difficulty.EnableUncapHealthScaling (default true). See docs/boss-hp-scaling.md.

Install

1. Requires BepInEx 5 for Valheim.
2. Requires MushroomSync.dll, the shared server-authoritative sync plugin.

This mod declares a [BepInDependency] on it and will not load without it.

1. Build: dotnet build src/CombatAdjustments.ShieldRework -c Release — this also

builds MushroomSync, which it references.

1. Copy both into Valheim/BepInEx/plugins/:

• src/CombatAdjustments.ShieldRework/bin/Release/CombatAdjustments.ShieldRework.dll
• MushroomSync/bin/Release/MushroomSync.dll

Or take the release's MushroomMods-plugins.zip, which carries both.

1. Launch once to generate BepInEx/config/Abortipus.CombatAdjustments.ShieldRework.cfg

(or place server settings in config/bepinex/Abortipus.CombatAdjustments.ShieldRework.cfg).

Config

Config is read from both locations (game root relative):

| Path | Used by | | --- | --- | | BepInEx/config/Abortipus.CombatAdjustments.ShieldRework.cfg | Client — primary load/save path | | config/bepinex/Abortipus.CombatAdjustments.ShieldRework.cfg | Dedicated server — primary load/save path |

On clients, if both files exist, config/bepinex/ values overlay the client file (overlay wins). Dedicated servers (-batchmode) only use config/bepinex/ unless that file is missing.

• General.EnableStaggerGrant / EnableTowerArmorBonus / EnableDurabilityBonus
• General.SyncConfigInMultiplayer (default true on host/server) — pushes settings to

joining clients at runtime without overwriting their local .cfg

• Tooltip.StaggerColorHex (default #E85AC8)
• StaggerGrants.<PrefabName> — per-shield max-quality grant. Lower★ add

+1 (wood–iron), +2 (silver/serpent–carapace), or +3 (flametal) for towers/rounds; bucklers always +1 / ★. GrantTableVersion re-seeds max values when the designed table changes.

• Two-Handed Combat.Enable / GreatswordPrimaryStaggerMultiplier

/ AreaAdrenalinePerEnemy

• Feasts.EnableStatBonuses / HealthBonus / StaminaBonus /

SailorsHealthBonus / SailorsStaminaBonus / MistlandsEitrBonus / AshlandsEitrBonus / DeepNorthEitrBonus. Unlock bosses are hardcoded.

• Diagnostics.DumpObjectDb (default false) — write every ObjectDB item

prefab, its item type, shield and food stats, and the world's global keys to CombatAdjustments.ShieldRework.objectdb-dump.txt beside this config, once, on the next world load. cadump in the console does the same without a restart. Local only: never sent to or accepted from a host.

• Sailing.EnableWindCurve / CalmForceFactor / KneeForceFactor /