Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
You are viewing a potentially older version of this package.
View all versions.
ShieldMeBruh
A Valheim Quality of Life Mod that will auto equip a selected shield when a one-handed weapon is equipped. I need a shield! Shield me Bruh!
| Date uploaded | 2 weeks ago |
| Version | 2.0.2 |
| Download link | Vapok-ShieldMeBruh-2.0.2.zip |
| Downloads | 2572 |
| Dependency string | Vapok-ShieldMeBruh-2.0.2 |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2350
ValheimModding-Jotunn
Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.
Preferred version: 2.30.2
ValheimModding-YamlDotNet
Shared version 16.3.0 of YamlDotNet from Antoine Aubry and contributors, net47 package for use in Valheim mods. Maintained by the ValheimModding team.
Preferred version: 16.3.1README
🛡️ Shield Me Bruh!
Automatic shield pairing and auto-equipping for one-handed weapons in Valheim.
Never get caught in battle with an empty off-hand! Shield Me Bruh! is a sleek quality-of-life mod that seamlessly auto-equips your favorite shield whenever you draw any one-handed weapon (swords, axes, maces, spears, clubs, or knives).
⚔️ How It Works
- 🖱️ Mark Your Shield: Open your Player Inventory and Middle-Click your desired shield. A special Shield Me Bruh! icon appears on the item icon to confirm it is your designated combat shield.
- 🔄 Unmark or Swap: Middle-Click the shield again to unmark it. If you middle-click a different shield while wielding a 1H weapon, your character will instantly equip the new shield!
- ⚔️ Automatic Combat Ready: Whenever you equip a one-handed weapon, Shield Me Bruh! automatically equips your marked shield. Unequipping or switching to a 2H weapon safely stows your shield.
- 💾 Persistent Across Sessions: Your shield selection persists across game saves, world transitions, and character logouts.
🕹️ Controls Summary
| Action | Input / Control | Description |
|---|---|---|
| Mark Shield | Middle-Click (in Inventory) | Designates the clicked shield as your auto-equip shield. |
| Deselect Shield | Middle-Click (on Marked Shield) | Removes the mark and disables auto-equip for that shield. |
| Quick Swap | Middle-Click (on New Shield) | Instantly marks and auto-equips the new shield if a 1H weapon is held. |
🛡️ Advanced Safeguards
- 📦 Container Move Protection: Quick-moving items into containers (Ctrl + Left Click) or bulk transfers will never accidentally strip the mark from your shield.
- ⚡ Zero Lag Overhead: Uses clean Harmony prefix/postfix hooks during item equip events with zero per-frame background polling.
🤝 Verified Mod Compatibility
| Mod | Compatibility Status |
|---|---|
| AdventureBackpacks | 🟢 Fully Supported (Equipped backpacks & quick transfer work seamlessly) |
| FastItemTransfer | 🟢 Fully Supported |
| Equipment & Quick Slots | 🟢 Fully Supported |
| Epic Loot | 🟢 Fully Supported (Enchanted shields remain marked) |
| Jewelcrafting | 🟢 Fully Supported |
🌐 Available Translations
🇺🇸 English • 🇩🇪 German • 🇫🇷 French • 🇪🇸 Spanish • 🇨🇳 Chinese • 🇷🇺 Russian
📥 Installation
Mod Manager (Recommended)
- Install via R2ModMan or Thunderstore Mod Manager.
- Dependencies (
BepInExPack,Jotunn (JVL)) are installed automatically.
Manual Installation
- Copy
ShieldMeBruh.dllto yourValheim/BepInEx/pluginsdirectory.
👨💻 Created by Vapok Gaming
Author: Vapok
Source Code: GitHub Repository
Community & Support: Discord Server
Changelog: Release Notes
CHANGELOG
2.1.1 - Performance, Server Hardening & Sentry Fixes
- Performance Optimizations: Cached inventory grid badge components, eliminating hundreds of per-frame lookups when browsing inventory.
- Dedicated Server Safety: Ensured client equipment and UI patches are completely bypassed on headless dedicated servers.
- Multiplayer Safety: Isolated shield management strictly to the local player, preventing nearby players' equipment or death events from affecting local shields.
- Bug Fixes: Resolved harmless errors during inventory item moves and game exit routines.
- Dependency Updates: Updated Jotunn to 2.30.2 and internal dependencies for stability.
2.0 Changelog History (Valheim Release) (click to expand)
2.1.0 - 1-Handed Weapon Exclusion & Red X Badges
- 1-Handed Weapon Exclusion: Added ability to middle-click any one-handed weapon (such as woodcutting axes) in your inventory to mark it as excluded from automatic shield deployment.
- Red X Visual Indicator: Excluded weapons display a crisp red X badge in the inventory grid (matching the shield badge styling) that seamlessly follows the item across slot moves and swaps.
- Multi-Weapon Support: Multiple one-handed weapons can be excluded simultaneously while retaining your single designated auto-equip shield.
- Configurable: Added
Enable Weapon Exclusionsetting underLocal Configto toggle the feature on or off as desired.
2.0.8 - Dedicated Server AutoShield Reset Fix & Valheim 1.0.15 Alignment
- Dedicated Server AutoShield Reset Fix: Added null-conditional invocation for
OnResetEventduringPlayer.SetLocalPlayer, eliminatingNullReferenceExceptioncrashes on dedicated servers when no client UI handlers are registered. - Valheim 1.0.15 Alignment: Updated all game assembly references and internalized
Vapok.Valheim.Common3.13.1015.
2.0.7 - Splash Window Updates & Valheim 1.0.14 Alignment
- Splash Window Updates:
- Telemetry is now unchecked when first loaded (Opt-In visibility)
- Added Send Error Logs (Opt-Out)
- Privacy Policy is now available directly in-game
- Added Data Disclaimers on hover over checkboxes for transparency on what data is sent
- Valheim 1.0.14 Alignment: Updated game assembly references and internalized 3.12.1014.
2.0.6 - Jewelcrafting Font Compatibility
- Fixed: Jewelcrafting packages it's own font which was overriding part of a vanilla font, causing the Splash screen to appear blank.
2.0.5 - Updated README with Telemetry Information
- Updated the README.md with Anonymous Telemetry information per request of mod stores.
2.0.4 - Unified Splash Screen & Telemetry Controls
- Unified Startup Splash Screen: Integrated with a centralized startup splash screen.
- Added configurable
Show on Game Startupwhich can be enabled or disabled in the configuration file.
- Added configurable
- Anonymous Telemetry:
- Added configurable
Enable Anonymous Telemetryconfiguration which can be enabled or disabled in the configuration file.- Defaults to enabled with auto-opt-in on launch. Uncheck to Opt-Out
- ANONYMOUS DATA ONLY - I track version number and usage data. No personal data is ever collected. For more information, see the Privacy Policy.
- Added configurable
2.0.2 - Dependency & Compatibility Maintenance
- Dependency Updates: Updated Jotunn and BepInEx runtime package bindings.
- Compatibility Maintenance: Verified compatibility against the latest Valheim 1.0 release.
- Documentation Improvements: Standardized README, user guides, and technical patch documentation.
2.0.1 - Container Quick Move Mark Persistence Fix
- Fixed: Resolved an issue where using Quick Move (Ctrl + Left Click) on items into a container would inadvertently clear the mark from a marked shield.
2.0.0 - Valheim 1.0+ Update & Shield Marking Mechanics
- Updated codebase for Valheim 1.0.
- Adjusted shield marking mechanics: marking a new shield while holding a one-handed weapon now instantly auto-equips the newly marked shield.
- Added visual icon badges on marked shields in player inventory.
1.0 Changelog History (Valheim Early Access) (click to expand)
1.1.2 - Dependency Maintenance
- Updated all dependencies to latest versions.
1.1.1 - Dedicated Server Config Syncing Fix
- Resolved an issue preventing dedicated servers from properly enforcing configuration settings on connected clients.
- Added graceful dependency handling and notifications.
1.1.0 - Valheim 0.221.4 & Unity Engine Updates
- Updated for Valheim 0.221.4 and Unity runtime adjustments.
1.0.0 - Initial Release of Shield Me Bruh!
- Initial release of automatic shield pairing and auto-equipping when wielding one-handed weapons.
- Implemented middle-click shield marking in player inventory.
