You are viewing a potentially older version of this package. View all versions.
DeathCab-ComboSpear-1.0.0 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.

Date uploaded a month ago
Version 1.0.0
Download link DeathCab-ComboSpear-1.0.0.zip
Downloads 126
Dependency string DeathCab-ComboSpear-1.0.0

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

CHANGELOG

1.0.0 — first public release

This is the 1.0 release.

  • Only three settings now. The public build exposes nothing but the three damage multipliers (normal hits / block hits / jump-back throw) in a single 1 - Damage section. Every other knob — animation choice, speed, spear pose, clips, timings, jump height — is a tuned constant. Exposing those only ever produced broken animations and mistimed hits.
  • Animations are embedded in the DLL: one file to install.
  • Log quiet: the per-attack and per-spam-click messages moved to debug level, so a normal session writes a handful of lines instead of one per swing. Failures and warnings still log.
  • If the jump-back throw cannot start, the log now names the reason (staggering, dodging, indoors...) instead of only saying it failed.
  • Documented that the mod is client-side: every player who wants to see the animations needs it; a dedicated server does not need it for the combo or the visuals to work.
  • Display name is Combo Spear, the install folder is BepInEx\plugins\ComboSpear, and the plugin GUID is andythedemon.combospear, and the DLL is ComboSpear.dll. Consistent naming everywhere a player or a mod manager sees it.
  • Install folder is BepInEx\plugins\ComboSpear (was SpearCombo). The DLL keeps its assembly name SpearCombo.dll; only the folder was renamed. icon.png ships inside it so mod managers show the icon.

Pre-release internal history

The numbers below were used during development and do not exist as public releases.

1.16.0 — single-file packaging

  • Release DLL embeds the animation bundle; the dev build keeps the .bundle on disk.
  • Load order: file first, embedded as fallback. Verified in game both ways.

1.15.9 — the build the owner called fully functional

  • A frozen defence clip now counts as finished for the input gate. The pose hold was pinning the animator inside the attack state, so the attack never reported "done" and presses were refused for up to 1.5 s — longer than the 1 s combo window. Chains stalled after hit 2 and the next press started a fresh chain. This was the "spam clicking jitters, holding is smooth" bug.
  • A real pending click is kept alive while a defence hit plays (the game's own press ticket is 0.5 s, shorter than the 0.63–0.77 s clips, so taps landing early in a clip were being lost).
  • Block-combo shield uses the same 45° yaw as every other state instead of a square board (the only 0° pose in the game, so entering/leaving the combo swung the board 45° in ~2 frames).
  • In-plane roll of the shield board is constrained by the animation solver: shield-hand rotation drift across a block-combo clip went from 51–55° to 0.2–0.8°.

1.15.6 – 1.15.8

  • The animator's block bool is cleared together with the game's m_internalBlockingState, so the block stance returns after a hit instead of leaving the character in plain idle.
  • A finished block-combo clip holds its last pose briefly (configurable), removing the idle hop between hits; the hold is released before the next hit starts (~0.05 s per hit saved).

1.15.0 – 1.15.5

  • The block combo advances on the player's press instead of Valheim's 0.2 s chain window.
  • A press during a block-combo hit is dropped rather than queued on top of it.
  • Block intent is read from the actual block button, because m_blocking reads false during the game's short input-delay windows and let normal combo hits start while blocking.

1.14.x

  • Jump-back throw no longer spawns a duplicate spear.
  • Wires Combat Flow compatibility: its recovery-cancel is skipped while a block-combo hit plays.

1.0 – 1.13 (original internal numbering)

  • Three-hit spear combo with custom Blender clips, per-hit speed/pose config, shield and torch variants, the jump-back throw finisher, and the block combo.