SpecialAttack
Adds unique special attacks to 13 weapon categories. Each weapon gets a distinct skill with cooldown HUD, configurable damage, skill level gating, and an optional custom activation key to keep vanilla secondary attacks untouched.SpecialAttack
⚠️ WARNING: This mod is still in testing. Do not use it yet.
📌 This mod was inspired by and references sighsorry's SecondaryAttacks.
Adds unique special attacks to each weapon category in Valheim.
Every weapon type gets a distinct skill with cooldown tracking, configurable damage multipliers, visual/audio feedback, and an optional custom activation key.
Special Attacks by Weapon
| Weapon | Special Attack | Description |
|---|---|---|
| 1H Sword | Sword Chain | 3-hit combo chain with rising damage per hit |
| 2H Sword (Claymore / Krom) | Quad Slash | 4-hit slash combo — each hit has its own damage multiplier |
| Bastard Sword | Charge Slash | Hold to charge, release for a devastating slash |
| Spear | Spear Pin | Throws the spear into an enemy, slowing their movement |
| Battleaxe (2H Axe) | Impact Burst | Throw the axe — it explodes in an AoE on landing |
| 1H Mace / Club | Launch Slam | Launches enemies into the air, AoE on landing |
| Sledgehammer / 2H Mace | Aftershock | Ground slam sends multiple shockwave rings forward |
| Battle Hammer (Clubs + 2H) | Spinning Sweep | Spinning AoE sweep hitting all nearby enemies |
| Polearm / Atgeir | Triple Thrust | Rapid 3-hit thrust combo with stagger buildup |
| Knife / Dagger | Sneak Ambush | Crouch to charge, attack for massive backstab burst damage |
| Unarmed | Knockback Chain | Kick launches enemies and chains knockback to nearby foes |
| Fist weapons (Warfare mod) | Counter Upper | Duck to dodge incoming attacks, then unleash a powerful uppercut — counter bonus on successful dodge |
Note: Battle Hammer and Polearm/Atgeir both support Spinning Sweep (toggle via
EnableBattleHammer/EnablePolearms). Polearm/Atgeir also has Triple Thrust as a separate SA with its own cooldown.
How It Works
- Secondary attack key triggers specials by default — each has its own cooldown
- Optionally bind a custom key (
SpecialAttackKey) to separate specials from vanilla secondary attacks- Custom key pressed → special attack only (no secondary swing)
- Custom key pressed while on cooldown → nothing happens
- Secondary attack key → always vanilla secondary attack
- Cooldown icons appear on your HUD
- Charge bars shown on screen for Sneak Ambush and Charge Slash
- All values are fully configurable via the BepInEx config file
Configuration
Edit BepInEx/config/com.specialattack.plugin.cfg after first launch.
[General]
| Key | Default | Description |
|---|---|---|
SpecialAttackKey |
None |
Custom activation key (Unity KeyCode). When set, secondary key = vanilla only. Example: Mouse4, Mouse2, F |
[Hud]
| Key | Default | Description |
|---|---|---|
HudX |
0.5 |
Cooldown HUD X position (0 = left, 1 = right) |
HudY |
0.15 |
Cooldown HUD Y position (0 = bottom, 1 = top) |
[SwordChain] — 1H Sword
| Key | Default | Description |
|---|---|---|
Enable |
true |
Toggle on/off |
Cooldown |
10 |
Cooldown in seconds |
ChainWindow |
0.8 |
Time window to trigger next chain hit (seconds) |
AnimSpeed |
1.4 |
Animation speed multiplier |
Damage1 |
1.2 |
1st hit damage multiplier |
Damage2 |
1.4 |
2nd hit damage multiplier |
Damage3 |
2.0 |
3rd hit (finisher) damage multiplier |
MinSkillLevel |
0 |
Minimum Swords skill level required (0 = no limit) |
[QuadSlash] — Claymore / 2H Sword (THSwordKrom, claymore prefix)
| Key | Default | Description |
|---|---|---|
Enable |
true |
Toggle on/off |
Cooldown |
12 |
Cooldown in seconds |
AnimSpeed1–3 |
2.5 |
Animation speed for hits 1–3 |
AnimSpeed4 |
2.0 |
Animation speed for finisher (hit 4) |
Damage1–3 |
1.0 |
Damage multiplier for hits 1–3 |
Damage4 |
1.5 |
Damage multiplier for finisher |
MinSkillLevel |
0 |
Minimum Swords skill level required |
[ChargeSlash] — Bastard Sword
| Key | Default | Description |
|---|---|---|
Enable |
true |
Toggle on/off |
Cooldown |
20 |
Cooldown in seconds |
MaxChargeTime |
1 |
Time to reach 100% charge (seconds) |
DamageMult |
3.0 |
Maximum damage multiplier at full charge |
MinSkillLevel |
0 |
Minimum Swords skill level required |
[SpearPin] — Spear
| Key | Default | Description |
|---|---|---|
Enable |
true |
Toggle on/off |
Cooldown |
18 |
Cooldown in seconds |
SpeedFactor |
0.35 |
Movement speed multiplier while pinned (0.1–1.0) |
PinDuration |
8 |
Duration of the pin effect (seconds) |
PullRange |
3 |
Distance to retrieve the pinned spear (meters) |
PullRestoreTime |
3 |
Time for movement speed to recover after spear pulled (seconds) |
MinSkillLevel |
0 |
Minimum Spears skill level required |
[ImpactBurst] — Battleaxe (2H Axe)
| Key | Default | Description |
|---|---|---|
Enable |
true |
Toggle on/off |
Cooldown |
12 |
Cooldown in seconds |
DamageFactor |
0.75 |
AoE damage multiplier |
PushFactor |
4 |
AoE knockback multiplier |
Radius |
4 |
AoE radius (meters) |
ThrowSpeed |
30 |
Throw velocity (m/s) |
MinSkillLevel |
0 |
Minimum Axes skill level required |
[LaunchSlam] — 1H Mace / Club
| Key | Default | Description |
|---|---|---|
Enable |
true |
Toggle on/off |
Cooldown |
10 |
Cooldown in seconds |
LaunchHeight |
4 |
Launch height (meters) |
DamageFactor |
0.5 |
Landing AoE damage multiplier |
LandingRadius |
3 |
Landing AoE radius (meters) |
MinSkillLevel |
0 |
Minimum Clubs skill level required |
[Aftershock] — Sledgehammer / 2H Mace
| Key | Default | Description |
|---|---|---|
Enable |
true |
Toggle on/off |
Cooldown |
15 |
Cooldown in seconds |
Waves |
3 |
Number of shockwave rings |
Interval |
0.5 |
Interval between rings (seconds) |
WaveDecay |
0.2 |
Damage decay per ring (0.2 = 20% reduction) |
ForwardStep |
3 |
Advance distance per ring (meters) |
Radius |
4 |
Hit radius per ring (meters) |
DamageFactor |
1.5 |
Base damage multiplier |
PushForce |
8 |
Knockback force |
MinSkillLevel |
0 |
Minimum Clubs skill level required |
[SpinningSweep] — Battle Hammer / Polearm
| Key | Default | Description |
|---|---|---|
EnableBattleHammer |
true |
Enable for Battle Hammer (Clubs + TwoHanded, excludes Sledgehammer) |
EnablePolearms |
true |
Enable for Polearms (Atgeir, etc.) |
Cooldown |
8 |
Cooldown in seconds |
AnimationSpeed |
1.0 |
Animation speed multiplier |
BattleHammerMoveSpeedFactor |
0.3 |
Movement speed during spin (Battle Hammer) |
PolearmsMoveSpeedFactor |
0.75 |
Movement speed during spin (Polearms) |
MinSkillLevel |
0 |
Minimum skill level required |
[TripleThrust] — Polearm / Atgeir (Polearms skill + TwoHanded)
| Key | Default | Description |
|---|---|---|
Enable |
true |
Toggle on/off |
Cooldown |
12 |
Cooldown in seconds |
AnimSpeed |
2.5 |
Animation speed multiplier for the 3-hit sequence |
StaggerMultiplier |
2.5 |
Extra stagger buildup per hit |
Range |
3.5 |
Hit detection range (meters) |
MinSkillLevel |
0 |
Minimum Polearms skill level required |
[SneakAmbush] — Knife / Dagger
| Key | Default | Description |
|---|---|---|
Enable |
true |
Toggle on/off |
Cooldown |
15 |
Cooldown in seconds |
ChargeTime |
2 |
Max charge time at Sneak level 0 (seconds) |
ChargeSpeedFactor |
2 |
Charge speed multiplier at Sneak 100 |
AggroResetRadius |
10 |
Aggro reset radius on activation (0 = disabled) |
BackstabBonus |
3.0 |
Backstab multiplier bonus (stacks with weapon base) |
MinSkillLevel |
0 |
Minimum Knives skill level required |
[KnockbackChain] — Unarmed
| Key | Default | Description |
|---|---|---|
Enable |
true |
Toggle on/off |
Cooldown |
12 |
Cooldown in seconds |
PushFactor |
2.5 |
Kick knockback multiplier |
MaxChainTargets |
3 |
Max enemies hit by chain knockback (0 = no chain) |
CollisionRadius |
3 |
Chain detection radius (meters) |
ChainDecay |
0.6 |
Knockback decay per chain hop (0–1) |
ChainDamageFactor |
0.5 |
Chain collision damage (relative to kick, 0 = no damage) |
MinSkillLevel |
0 |
Minimum Unarmed skill level required |
[CounterUpper] — Warfare Fist/Claw weapons
| Key | Default | Description |
|---|---|---|
Enable |
true |
Toggle Counter Upper on/off |
Cooldown |
10 |
Cooldown in seconds |
DuckTime |
0.4 |
Total i-frame window duration (seconds) |
DodgeDisplayTime |
0.25 |
Dodge animation display time — must be ≤ DuckTime |
CounterMult |
2.5 |
Damage multiplier on successful counter (taking a hit during duck) |
UppercutSpeed |
1.4 |
Uppercut animation speed multiplier |
MinSkillLevel |
0 |
Minimum Unarmed skill level required |
Requirements
- BepInExPack Valheim
- Warfare mod: required for Fist/Claw weapons (Counter Upper)
Changelog
1.1.0
- Added Counter Upper for Warfare mod Fist weapons (Fist/Claw category)
- Duck phase: dodge animation + perfect parry i-frame window
- Counter mechanic: taking a hit during the duck → uppercut deals bonus damage (configurable multiplier)
- Uppercut animation speed configurable via
UppercutSpeed - Dodge display time configurable via
DodgeDisplayTime
- Added Quad Slash for Claymore / THSwordKrom (4-hit combo, per-hit damage and speed config)
- Added Triple Thrust for Polearm / Atgeir (3-hit rapid thrust with stagger buildup)
- Added Spear Pin for all Spear weapons (replaces Spear Rain) — pins enemy, slows movement
- Spinning Sweep now supports Polearms via
EnablePolearmsconfig option
1.0.1
- Fixed Charge Slash Mouse4 hold charge bug
1.0.0
- Initial release
- 10 weapon categories with unique special attacks
- Configurable custom activation key — separate specials from vanilla secondary attack
- Per-weapon minimum skill level requirement
- Cooldown HUD with radial icons
- Charge bar HUD for Sneak Ambush and Charge Slash
- Fully configurable via BepInEx config