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

---

🌐 Available Translations

Want to help translate Shield Me Bruh? Community translations are welcome! Please submit a PR on GitHub or stop by our Discord.

---

📥 Installation

Mod Manager (Recommended)

1. Install via R2ModMan or Thunderstore Mod Manager.
2. Dependencies (BepInExPack, Jotunn (JVL)) are installed automatically.

Manual Installation

• Copy ShieldMeBruh.dll to your Valheim/BepInEx/plugins directory.

---

🔒 Anonymous Telemetry & Privacy

Shield Me Bruh includes lightweight, privacy-first anonymous telemetry to help monitor mod stability, diagnose unhandled errors, and understand active version adoption across game updates.

• 100% Anonymous: We never collect personal data, Steam IDs, IP addresses, character/world names, or file system paths. Stack traces from errors are automatically sanitized to strip local user directories.
• Full Player Control: Telemetry is completely optional and can be enabled or disabled at any time:
  • In-Game (Startup Modal): Check or uncheck the Enable Telemetry toggle in the startup splash window.
  • In Configuration: Set Enable Anonymous Telemetry = false under [Local Config] in BepInEx/config/vapok.mods.shieldmebruh.cfg (or adjust it live via the BepInEx Configuration Manager).
• Privacy Policy: Read our full data practices and commitment at vapok.io/privacy-policy.

---