DeathCab-ComboSpear icon

ComboSpear

Makes your spear feel like a real weapon: a three-hit combo, a jump-back finishing throw and a three-hit block combo behind the shield. Client-side - everyone who wants to see the animations needs it. Fully written by AI.

Last updated 2 weeks ago
Total downloads 112
Total rating 0 
Categories Mods Tweaks AI Generated Client-side Server-side
Dependency string DeathCab-ComboSpear-1.0.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2351 icon
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.2351

README

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