Valheim
You are viewing a potentially older version of this package. View Latest Version
Install with App

Details

Date Uploaded
Downloads
291
Size
624KB
ADDatHost Valheim hosting
30% off

Weaponbreaker

Turn a well-timed parry into a chance to knock an enemy's weapon to the ground. Enemies keep fighting unarmed, return for their weapon after a cooldown, and resume armed combat when they retrieve it.

Features

  • Disarm supported melee weapon variants of Skeletons, Draugr, Fulings, Charred and Dvergr.
  • Pick up enemy weapons manually; automatic pickup is disabled for disarmed drops.
  • Enemies remember their own dropped weapon and can return for it during combat.
  • If you take their weapon, they keep fighting unarmed. They do not retrieve your dropped weapons.
  • Unarmed fallback attacks retain the original attack behavior with 15% damage; retrieving the weapon restores the original combat parameters and full damage.
  • Optional reverse disarming: supported enemies can knock your active weapon from your hands when they reduce your health.
  • A successful shield block or parry protects the weapon in your other hand, even if some damage gets through. A failed shield block does not. Blocking or parrying with a weapon still allows disarming if you take damage.
  • Per-enemy chances, cooldown settings and host configuration synchronization.
  • Optional EpicLoot compatibility: disarmed weapons can drop with enchantments using your EpicLoot loot settings.

Chances and skills

The default enemy weapon disarm chance is 30%. Only a successful timed parry in the vanilla 0.25-second window qualifies; holding a regular block does not disarm enemies. The item must support timed parries.

At skill level 25:

Action Enemy disarm chance
Shield parry 7.5%
One-handed weapon parry 30%
Two-handed weapon parry 37.5%
Qualifying sneak bow hit 60%

Shield parries use Blocking skill; weapons use their respective skill. Offensive skill multipliers range from 0.75 at level 0 to 1 at level 25 and 1.25 at level 100. Higher weapon skill also reduces your own risk of losing that weapon. Final probabilities are limited to 0–100%.

A qualifying bow hit requires sneaking, a bow projectile, actual health loss and a hit carrying the game's backstab bonus. Parrying an arrow does not disarm the archer.

Default cooldowns: 8 seconds before disarming the same enemy again, 8 seconds before an enemy can retrieve its weapon, and 15 seconds between player disarms. A previous combat target is restored after retrieval only if alive and within 30 metres.

EpicLoot compatibility

Weaponbreaker automatically detects EpicLoot. When it is installed, a disarmed weapon can be enchanted. By default, the chance and rarity follow EpicLoot's loot settings for that enemy, including its star level and nearby players' luck. EpicLoot generates effects for the weapon you actually disarm.

You can override the enchantment chance separately for each supported enemy family. Enable OverrideEpicLootEnchantChance, then adjust the EpicLootEnchantChance slider directly below it. The slider ranges from 0 to 1: 0.15 means 15%, and 1 means 100%.

Enemy Default enchantment chance when override is enabled
Skeleton 15%
Draugr 20%
Fuling 25%
Dvergr 30%
Charred 35%

These percentages apply to successfully disarmed weapons. Overrides are off by default, so EpicLoot's own chances remain active until you enable one. With an override enabled, star level and luck still influence rarity. The weapon must be eligible for enchantment and the enemy must have suitable equipment entries in EpicLoot's loot tables.

Without EpicLoot, these settings have no effect and weapons drop normally. Retrieving and disarming the same weapon again preserves its original enchantment result. EpicLoot's usual loot on enemy death remains separate.

Installation

Install with Gale or another Thunderstore-compatible manager. BepInExPack Valheim is the only required mod dependency.

For manual installation, install BepInEx for Valheim first, then copy the archive's plugins directory into BepInEx. The root metadata files do not need to be copied. Remove any older manually installed duplicate of Weaponbreaker.dll before using a mod-manager installation.

Configuration

After the first launch:

  • BepInEx/config/weaponbreakerConfigs.json: initial settings template.
  • BepInEx/config/salatrek.Weaponbreaker.cfg: active BepInEx settings. Saved values take priority over the JSON defaults on startup.

Enable or disable each mechanic, set enemy-specific probabilities, and adjust cooldowns. Optional BepInEx Configuration Manager exposes settings in-game. Natural-attack enemies such as boars and leeches expose only their chance to disarm the player; they have no weapon to drop.

In multiplayer, install the mod on the host/server and participating clients. The host controls the shared chances and cooldowns, including EpicLoot chance overrides.

Use version 0.1.6 on both host/server and clients. Configuration is requested only after the local player is ready, then sent to that client once its player ZDO is available. Changes on the host are sent only when settings change. Local client settings do not override the host; optional EpicLoot/DualWield integration also requires the host to enable that integration by having it installed. A client without host settings keeps Weaponbreaker combat inactive.

Confirmed parries are relayed to the enemy's current owner when the defending player is on another peer. The receiver validates the event and uses the host's configured chances with the defending player's reported skill multiplier. Weapon and inventory changes occur only on the owner. Logs marked [Parry] show forwarding, receipt, the calculated chance, failed rolls and skipped drops.

Valheim retains its normal object ownership: the owning peer applies weapon and inventory changes using the host's rules. Weaponbreaker does not claim ownership of players, alter their position or write their character saves. Its persistent state uses only weaponbreaker.* ZDO keys on the affected character or weapon drop.

For connection troubleshooting, look for [Network] in BepInEx/LogOutput.log: session start, local player readiness, peer character ZDO readiness, config request and application. [ZDO] entries identify the character, owner and dropped item for successful disarms. Diagnostics do not run every frame.

Source code

Weaponbreaker on GitHub

Community and support

If you enjoy this mod and would like to support its development, you can leave a one-time tip or become a subscriber.

Your support helps AmberWard Team continue creating, maintaining and improving mods for the Valheim community.

Credits

Created by Salatrek with AI-assisted development. The package icon was generated with AI.

Thunderstore development is made possible with ads. Please consider making an exception to your adblock.