SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedWeapons, items & crafting

SmartShield

by cjayride · for Valheim

Auto-equips a shield when you switch to a one-handed weapon, including after a bow or crossbow.

868Downloads
53d agoLast updated
BepInExLoaders
ThunderstoreSource

About SmartShield

From Thunderstore

Auto-equips a shield when you switch to a one-handed weapon, including after a bow or crossbow.

SmartShield

Automatically equips a shield when you switch to a one-handed weapon. Works after bow/crossbow. No popups, no hotkeys.

Client-side. Drop Cjayride.SmartShield.dll in BepInEx plugins.

Disable AutoEquipShield if both are installed.

Changelog

1.0.11

  • Fix: default UnequipOnSheath is now false so R-sheath shows weapon + shield on your back (vanilla). Set UnequipOnSheath = true if you prefer weapon-only on the back.

1.0.10

  • Fix: first sword draw after spawn now auto-equips the shield (warmup no longer baselines the weapon without applying).

1.0.9

  • Fix: hotbar deselect only unequips the shield when you put away a one-handed weapon — manually equipping a shield alone no longer gets yanked away.
  • Fix: R sheath no longer unequips the shield in a HideHandItems prefix (that emptied both hands and made R pop weapons back out).
  • Fix: drawing with R now triggers shield auto-equip reliably.

1.0.8

  • UnequipOnHotbarDeselect default is now true.

1.0.7

  • New: UnequipOnHotbarDeselect — unequip the shield when you deselect the weapon on the hotbar. UnequipOnSheath stays R-only.

1.0.6

  • Fix: sheath retract now unequips the shield before vanilla stashes it on the back, then destroys the back mesh (UpdateEquipmentVisuals). Default UnequipOnSheath = true.
  • Intentional: hotbar deselect keeps the shield unless you enable UnequipOnHotbarDeselect.
  • Note: existing configs may still have UnequipOnSheath = false — set it to true (or delete the cfg line to pick up the new default).

1.0.5

  • Fix: UnequipOnSheath now hooks vanilla HideHandItems (sheath) immediately and clears the back-slot shield (SetLeftBackItem). 1.0.4’s poll raced Player.Update and often missed.

1.0.4

  • Fix: UnequipOnSheath was never applied. Sheathing (R) now retracts the shield when the option is enabled.

Config Values

[Behavior]

Equip a shield whenever a one-handed weapon is equipped. Setting type: Boolean Default value: true AutoEquipOnOneHanded = true

Also equip a shield after switching from a bow/crossbow (or other ranged) to a one-handed weapon. Setting type: Boolean Default value: true EquipAfterRanged = true

Unequip the shield when a two-handed or ranged weapon is equipped. Setting type: Boolean Default value: true UnequipOnTwoHanded = true

Unequip the shield when weapons are sheathed with R (clears the back slot). Setting type: Boolean Default value: true UnequipOnSheath = true

Unequip the shield when you deselect a one-handed weapon on the hotbar (press the same slot again). Does not unequip a manually equipped shield alone. Setting type: Boolean Default value: true UnequipOnHotbarDeselect = true

[Filters]

Comma-separated ItemType, skill, or prefab names. Empty = all one-handed weapons. Setting type: String Default value: AllowedWeaponTypes =

Comma-separated shield prefab names that must never be auto-equipped. Setting type: String Default value: BlacklistShields =

[General]

Master switch. No messages are ever shown. Setting type: Boolean Default value: true Enabled = true

[ShieldSelection]

Best = highest block power. First = first shield in inventory. Preferred = use PreferredShield. Setting type: String Default value: Best SelectionMode = Best

Prefab name used when SelectionMode is Preferred (example: ShieldWood). Setting type: String Default value: PreferredShield =

Contact

𝕏: x.com/cjayride

Discord: discord.gg/cjayride (find me at the top of the user list) "cjayride"

Twitch: twitch.tv/cjayride

AI Generated

This code was AI Generated.

Highlights

From source data

Loaders

Runs on BepInEx.

Footprint

Rated a light load on a server.

Last update

Its author last shipped an update 53d ago.

SmartShield on Nxeon

From our catalogue
One-click install
Supported on Nxeon Valheim servers, for BepInEx servers. We download it from Thunderstore, place it, and restart the server.
Server type needed
BepInEx
Server load
light
Smallest plan we suggest
Valheim — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
1.0.11, released 2026-09-29

Game versions by loader

LoaderGame versionsNewest
BepInEx

From 2 recorded builds of SmartShield.

Recent builds

BuildReleasedGame versionsLoaders
1.0.112026-09-29n/aBepInEx
1.0.102026-09-28n/aBepInEx

Dependencies

Declared by the newest build that lists any. Required ones are installed with it on one-click installs.

Run SmartShield on a Valheim server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Thunderstore as “Content”

Weapons, items & crafting

New weapons, gear, items and the recipes to make them.

Compatibility

Game
Valheim
Loaders
BepInEx
Requires
One-click install needs a BepInEx server.

Verified at the source

  • ✓ThunderstoreOfficial listing, checked 2026-10-16Open ↗
  • ✓Authorcjayride, as published on Thunderstore
  • ✓LicenseNot published by the sourceFree

SmartShield, answered

Generated from the mod’s own source data.

Which loaders does it support?

BepInEx.

Is it free?

Yes. SmartShield is free to download from Thunderstore.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run SmartShield on a Valheim server.

Deploy in about a minute from $6.50 a month, then add SmartShield in one click.