Automatically equip your preferred shield when you draw a one-handed weapon.

Features

• Choose a shield with a middle-click in your inventory.
• Automatically equip it alongside a one-handed weapon.
• Optionally unequip it when you put the weapon away.
• Remember the same shield across sessions, storage, and death recovery.

Installation

Requires Valheim 1.0.12 and BepInExPack_Valheim 5.4.2350.

1. Install the dependencies in your r2modman profile.
2. Download the package from GitHub Actions, or build the project using the instructions below.
3. Close Valheim and copy ShieldMeBruhReforged.dll into your profile's BepInEx/plugins/ShieldMeBruhReforged/ directory.
4. Launch with Start modded.

Disable or remove the original ShieldMeBruh first. Reforged starts with fresh settings and shield selection.

Build and compatibility checks run in GitHub Actions.

Controls

Middle-click a shield in your inventory to select it. Click it again to deselect. A shield marker shows your selection.

Auto-equip and auto-unequip can be toggled in the mod's BepInEx configuration.

Your character remembers the selected shield's ID. Storing it or dying keeps the preference; it resumes when that shield returns, even in another inventory slot. Only deselecting or choosing another shield changes the preference. These IDs are plain-text custom data that vanilla does not use.

Build

Requires .NET SDK 8 and the game dependencies above.

GitHub Actions builds and checks the plugin automatically. Pushing a version tag creates a GitHub release with the built ZIP and publishes it to Thunderstore. Use bumpp to update versions and create the tag.

dotnet build src/ShieldMeBruhReforged/ShieldMeBruhReforged.csproj -c Release \
  -p:GameDir="/path/to/Valheim" \
  -p:BepInExDir="/path/to/profile/BepInEx"

Output: src/ShieldMeBruhReforged/bin/Release/netstandard2.1/ShieldMeBruhReforged.dll.

Development and releases · Repository layout · Changelog

Code and artwork licensed under the MIT license.

Shield Me Bruh Reforged Patchnotes

1.0.1

• Fix Thunderstore banner and screenshot links using public GitHub images pinned to the release tag.

1.0.0 - Independent fork for Valheim 1.0.12

• Rename the mod, assembly, and package to ShieldMeBruhReforged.
• Use a new plugin ID and configuration file without migrating original settings or shield selections.
• Target .NET Standard 2.1 and the current Valheim game assemblies.
• Use Valheim's InventoryElement component for shield selection and markers.
• Replace the bundled Vapok library and Jotunn initialization with BepInEx configuration and logging.
• Remove YamlDotNet and remember the preferred shield through native character and item metadata.
• Preserve the preference through storage, logout, death, and recovery into another slot.
• Restore markers on inventory refresh without requiring a grid resize.
• Clear the saved preference only when explicitly deselecting a shield.
• Keep inventory input registered when auto-shield starts disabled.
• Add portable builds, ZIP packaging, persistence and lifecycle tests, and static compatibility checks.
• Build and validate packages in GitHub Actions; version tags create GitHub releases and publish to Thunderstore.
• Add bumpp configuration to update mod versions and create release commits and tags.

Upstream 1.1.2 - Updating Dependencies

• Updated to latest version of dependencies