Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
Weaponbreaker
Disarm enemies with parries and sneak bow hits. Enemies retrieve their weapons and can disarm you. Optional EpicLoot compatibility adds enchanted weapon drops with per-enemy chance settings.
| Last updated | a day ago |
| Total downloads | 61 |
| Total rating | 2 |
| Categories | Mods Tweaks Enemies Gear AI Generated |
| Dependency string | AmberWardTeam-Weaponbreaker-0.1.3 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2360README
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.
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.
