
Weaponbreaker
Disarm enemies with parries and arrows, with a bonus for sneak attacks. Enemies retrieve their weapons and can disarm you. Optional EpicLoot compatibility adds enchanted weapon drops with per-enemy chance settings.Weaponbreaker
Turn a well-timed parry or bow hit 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 weapon variants of Skeletons, Draugr, Fulings, Charred and Dvergr, including Fuling shamans, berserkers, Hildir and Deep North variants.
- 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 depends on enemy type. 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.
For a Skeleton at skill level 25:
| Action | Enemy disarm chance |
|---|---|
| Shield parry | 14% |
| One-handed weapon parry | 56% |
| Two-handed weapon parry | 70% |
| Ordinary bow hit | 33.6% |
| Qualifying sneak bow hit | 100% (capped) |
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%.
| Enemy type | Base chance | One-handed weapon skill 100 |
|---|---|---|
| Skeleton | 56% | 70% |
| Draugr | 52% | 65% |
| Fuling | 48% | 60% |
| Fuling shaman | 44% | 55% |
| Fuling berserker / Dvergr | 40% | 50% |
| Charred / Hildir fulings / Deep North fulings | 36% | 45% |
These defaults distinguish enemy types, not star levels. Each listed Fuling type has its own configuration section. Yagluth and unarmed variants are excluded. Berserkers drop an iron sledge equivalent; shamans drop a fireball staff equivalent. Their alternative attacks are suspended until they recover the weapon.
Bow hits use a 0.6 multiplier; hits that actually receive Valheim's native backstab bonus use 2.0 instead. The arrow must reduce a living supported enemy's health. Standing still while crouched does not block eligibility, and switching weapons after firing does not change the arrow's recorded bow skill. Killing shots do not create an extra disarm drop. Crossbows and magic are excluded. Parrying an arrow does not disarm the archer. A successful timed parry of a Fuling's thrown spear can disarm its equipped spear, using the same chances and cooldowns as a melee parry. While disarmed, the spearman uses a reduced-damage melee attack until retrieving its weapon; pickup restores spear throwing. Staff projectiles, including shaman fireballs, remain excluded.
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.
Version 0.1.7 migrates old default 30% enemy-disarm chances once. Other custom values and player-disarm chances are preserved. The original JSON is saved as weaponbreakerConfigs.json.pre-balance-v1.bak. New Fuling sections inherit existing Fuling enablement, player-disarm and enchantment preferences, with their own new enemy-disarm defaults.
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.9 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.
[Bow] entries report actual backstab application, launch bow skill, final disarm chance, failed rolls and skipped drops.
Source code
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.