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, Error Reporting & Privacy

Shield Me Bruh includes lightweight, privacy-first telemetry and error reporting to help monitor mod stability, diagnose unhandled bugs, and track 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.
• Granular Player Control:
  • Anonymous Telemetry (Opt-In): Tracks version adoption and session launches. Defaults to unchecked / disabled when first loaded (Enable Anonymous Telemetry = false).
  • Error Reporting (Opt-Out): Captures sanitized mod crash diagnostics to rapidly identify and fix bugs. Defaults to enabled (Send Error Reports = true) with one-click opt-out.
  • Data Disclaimers: Hover over any toggle in the startup modal for interactive tooltip disclaimers detailing exactly what data is transmitted.
• In-Game & Online Privacy Policy: The full privacy policy can be viewed directly in-game by clicking [ PRIVACY POLICY ] on the startup splash modal, or online at vapok.io/privacy-policy.
• Configuration Files: Settings can be managed in-game via the startup modal, through the BepInEx Configuration Manager, or under [Local Config] in BepInEx/config/vapok.mods.shieldmebruh.cfg.

---