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.
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.
By DeathCab
| 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
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2351README
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
- Install BepInEx 5 (64-bit) for Valheim.
- Copy the
BepInExfolder from this package into your Valheim folder. - 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 - Damagesection. 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 isandythedemon.combospear, and the DLL isComboSpear.dll. Consistent naming everywhere a player or a mod manager sees it. - Install folder is
BepInEx\plugins\ComboSpear(wasSpearCombo). The DLL keeps its assembly nameSpearCombo.dll; only the folder was renamed.icon.pngships 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
.bundleon 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_blockingreads 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.