Combo Spear — by AndyTheDemon

Makes your spear feel like a real weapon in your arsenal — so you stop stabbing your own feet while you try to hit someone.

Three attacks, no clutter:

• Normal combo — three chained thrusts: jab, jab, lunge.
• Jump-back throw — press the special during the third hit: you leap back and throw the spear (0.5× damage).
• Block combo — hold block and attack: three thrusts from behind the shield, hit 1 → 2 → 3. You still block while attacking, at 50% / 70% / 100% damage.

Everything else about the spear is untouched — the plain middle-mouse throw keeps full damage.

---

Install

1. Install BepInEx 5 (64-bit) for Valheim.
2. Copy the BepInEx folder from this package into your Valheim folder.
3. Play. That's it — one file: BepInEx\plugins\ComboSpear\ComboSpear.dll

The animations are inside that DLL. Nothing else to copy.

---

Settings

Only three, in BepInEx\config\andythedemon.combospear.cfg (or press F1 in game):

setting	default	what
NormalHitsDamageMultiplier	1	damage of the three normal combo hits
BlockHitsDamageMultiplier	1	damage of the three block-combo hits
SpearThrowDamageMultiplier	0.5	damage of the jump-back finishing throw

Everything else — animations, speeds, grip, timing — is tuned and fixed. That is deliberate: those knobs only ever produced broken animations and mistimed hits.

---

Multiplayer

Client-side mod. Every player who wants to see the animations needs it installed — each client picks the custom clip itself when the attack arrives, so a player without the mod sees the plain spear attack instead (no animation plays for that thrust on their screen).

Dedicated servers: nothing server-side is required. The combo, the damage and the animation all happen on the attacker's client, and the plugin has no server-side work to do — install it on the server only if you want every machine running the same mod list. It is safe to run there: all of its player-specific code checks for a local player and does nothing when there isn't one.

Server admins: tell your players to install it client-side, or they will see spear users attacking with no animation. It adds no items and touches no save data, so it is safe on existing worlds.

Requirements

Valheim + BepInEx 5.4.23 or newer (64-bit). No other mods needed. Wires Combat Flow is detected and cooperated with automatically.

---

Note

Fully written by AI (DeepSeek Harness) — the plugin, the 18 animation clips, the arm and shield solver, and this document. The human owner (AndyTheDemon) designed it and tested every build in game.

v1.0.0 · see CHANGELOG.md