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 supported enemies with well-timed parries and sneak bow hits. Enemies fight unarmed, retrieve their dropped weapons and can disarm you in return.
| Date uploaded | a week ago |
| Version | 0.1.2 |
| Download link | AmberWardTeam-Weaponbreaker-0.1.2.zip |
| Downloads | 21 |
| Dependency string | AmberWardTeam-Weaponbreaker-0.1.2 |
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.
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.
Installation
Install with Gale or another Thunderstore-compatible manager. BepInExPack Valheim is the only required mod dependency. JSON runtime dependencies not supplied by the game are included; System.Memory.dll and System.Runtime.CompilerServices.Unsafe.dll are supplied by Valheim and are not bundled. MyEmotions is not required.
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. Host settings are intended to govern all clients. Full multiplayer and ownership-transfer testing remains outstanding.
Limitations and testing
Prepared for the Valheim 1.0.21 / BepInEx 5.4.23.6 environment used during development. The skeleton disarm, unarmed combat, retrieval and repeat-disarm cycle was tested in the author's existing Windows modded profile. The shield protection change has automated logic/IL checks; its in-game validation and installation from this release ZIP on a fresh profile remain outstanding.
For 0.1.1, automated probes run from the extracted ZIP using Valheim's own Mono runtime verified configuration creation/readback, JSON serialization/deserialization of host settings, and resolution of System.Memory and Unsafe from the game rather than bundled copies. These probes do not replace gameplay or multiplayer testing.
Enemy support uses an explicit weapon whitelist; not every creature or weapon variant is supported. Enemy-only equipment may drop as a mapped player-usable equivalent. Return movement can be obstructed by terrain. Interrupted disarm cycles across saving/reloading and network ownership changes are not guaranteed by this initial release.
Only this mod and its runtime libraries are shipped. Personal profile settings and game assemblies are not included. Library licenses are provided under the plugin's licenses directory.
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.
CHANGELOG
Changelog
0.1.10
- Ignore Valheim's internal
Unarmeditem when processing player disarms, preventing a bare-hands fight from creating anUnarmedweapon entry or drop. - Verify that the active weapon is still present in the player's inventory before committing a player disarm.
- Delay the first configuration request by 10 seconds after connection, then retry at most once per minute while keeping normal network housekeeping responsive.
0.1.9
- Add disarming from ordinary player bow hits with a 0.6 multiplier, between shield parries (0.25) and one-handed parries (1.0).
- Apply the 2.0 hidden-bow multiplier only when Valheim actually applies its native backstab bonus. Remove the moving-sneak check that excluded stationary crouched archers.
- Identify bow hits using projectile skill metadata rather than the player's weapon at impact. Carry the launch bow skill level through native HitData serialization to the enemy owner.
- Keep actual health loss, living supported targets, existing object ownership and cooldown requirements. Killing shots do not create an extra disarm drop.
- Add Bow diagnostics for applied bonuses, launch skill, final probabilities, failed rolls and skipped drops.
- Retain multiplayer fixes, enemy balance and Fuling spear-parry support. Require version 0.1.9 on host/server and participating clients.
0.1.8
- Allow a successful timed parry of a Fuling's thrown spear to disarm its equipped spear. Ordinary arrows and staff projectiles remain excluded.
- Use the existing enemy chance, blocker/skill multipliers and cooldowns for spear projectile parries.
- Give disarmed Fuling spearmen a reduced-damage melee fallback until retrieval, preventing invisible spear throws. Restore the original spear attack after pickup.
- Relay the spear projectile event to the existing enemy owner, rechecking the equipped spear and allowing a bounded 60-metre range only for this event type. Keep the 12-metre melee bound and ownership, expiry and duplicate protections.
- Retain the multiplayer fixes from 0.1.6 and balance from 0.1.7. Require version 0.1.8 on host/server and participating clients.
0.1.7
- Recognize vanilla Goblin prefab names and add separate settings for armed Fuling shamans, berserkers, Hildir variants and Deep North fulings. Exclude Yagluth and unarmed variants.
- Suspend alternative attacks while special fulings are disarmed and restore them when their weapon is recovered. Shamans and berserkers drop usable player-weapon equivalents.
- Scale default enemy disarm chances by enemy type: 56% for Skeletons, 52% for Draugr, 48% for ordinary Fulings, 44% for shamans, 40% for berserkers/Dvergr, and 36% for Charred, Hildir and Deep North variants.
- At one-handed weapon skill 100, these defaults produce chances from 70% down to 45%. Equipment and skill multipliers remain unchanged.
- Migrate legacy default 30% settings once, preserving other custom chances and player-disarm settings. Back up migrated JSON settings and inherit shared Fuling preferences for newly added variants.
- Retain the multiplayer world-loading and remote-parry fixes from 0.1.6. Require version 0.1.7 on host/server and participating clients.
0.1.6
- Fix multiplayer issues affecting world loading for connecting players and enemy disarming by remote players.
- Fix excessive configuration broadcasts during connection/world loading; synchronize host settings only with ready clients and when settings change.
- Relay confirmed player parries to the enemy's existing ZDO owner, including host-spawned enemies attacking a remote player.
- Validate the sender against the defending player's ZDO owner, registered blocker, distance, bounded skill multiplier and event age; reject duplicate events.
- Keep weapon removal and drop creation on the existing owner without claiming ownership or broadcasting parry events to every peer.
- Log the actual base chance, blocker and skill multipliers, random roll, and reasons for skipped disarms.
- Require version 0.1.6 on both host/server and participating clients.
0.1.5
- Remove configuration broadcasts from ZNet connection and update hooks; stop resending the complete configuration every frame.
- Synchronize settings only with compatible clients that request them after their player is ready. Wait for a valid, client-owned player ZDO before responding.
- Keep host settings in an isolated runtime snapshot. Clients cannot override host probabilities, cooldowns or optional integration policy through their local settings.
- Suspend client combat logic until host configuration arrives; contain malformed RPC/config failures within the mod.
- Check ZDO validity and ownership before weapon state writes, and retain pending weapon references while scene objects are still loading.
- Clear cached enemy state between worlds and add bounded network diagnostics plus disarm ZDO/owner logs.
0.1.4
- Rebalance player disarm probabilities to the 5–25% base range.
- Scale player disarm chance smoothly from 100% of the base value at weapon skill 0 to 25% at skill 100.
- Add optional DualWield compatibility: when two compatible one-handed weapons are equipped, use the corresponding DualWield skill.
0.1.3
- Add automatic EpicLoot compatibility for enchanted disarmed weapons.
- Follow EpicLoot's enemy loot settings, star scaling and luck by default.
- Add optional per-enemy enchantment chance overrides: Skeleton 15%, Draugr 20%, Fuling 25%, Dvergr 30%, Charred 35%.
- Place the override checkbox directly above its chance slider.
- Preserve the original enchantment result when an enemy retrieves its weapon and is disarmed again.
- Update the mod description and add the GitHub repository link.
0.1.1
- Remove bundled System.Memory and System.Runtime.CompilerServices.Unsafe assemblies supplied by Valheim.
- Retain the JSON libraries not supplied by the game and their license notices.
- Packaging update; disarm mechanics and default probabilities are unchanged.
0.1.0
- Initial packaged release with enemy and player disarming, skill scaling and per-enemy configuration.
- Enemies fight with 15% damage while disarmed and can retrieve their own weapons after a configurable delay.
- Restore original combat parameters after retrieval.
- Successful shield blocks protect the player's held weapon from disarming by that hit.
- Default enemy weapon disarm chance is 30%; configuration is synchronized from the host.