COMBO SPEAR by AndyTheDemon  -  v1.0.0
=======================================

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

  Normal combo   : left click x3      (jab, jab, lunge)
  Jump-back throw: special during the 3rd hit (leap back + throw, 0.5x damage)
  Block combo    : hold block + left click   (hit 1 -> 2 -> 3 behind the shield)
  Vanilla throw  : middle mouse, untouched


INSTALL
-------

1) Install BepInEx 5 (64-bit) for Valheim.
2) Copy the "BepInEx" folder from this package into your Valheim folder and merge it:

     Valheim\BepInEx\plugins\ComboSpear\ComboSpear.dll

   One file. The animations are inside it.
3) Play.


SETTINGS
--------

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

  NormalHitsDamageMultiplier = 1
  BlockHitsDamageMultiplier  = 1
  SpearThrowDamageMultiplier = 0.5

Everything else is tuned and fixed on purpose.


CHECK IT LOADED
---------------

In BepInEx\LogOutput.log:

  [Info   :Combo Spear] Spear Combo 1.0.0 loaded.
  [Info   :Combo Spear] Damage: normal hits x1, block hits x1, jump-back throw x0.5.


REQUIREMENTS
------------

CLIENT-SIDE: every player who wants to SEE the animations needs this mod installed. Each client
chooses the custom animation itself, so an unmodded player sees the plain spear attack instead.

DEDICATED SERVER: nothing server-side is required - the combo, damage and animation all happen on
the attacker's client. Installing it on the server too is harmless (its player-specific code checks
for a local player and does nothing without one) and only useful for keeping mod lists identical.
Server admins: tell players to install it, or they will see spear users attacking with no animation.

Valheim + BepInEx 5.4.23 or newer (64-bit). No other mods needed.


FILES
-----

  BepInEx\plugins\ComboSpear\ComboSpear.dll   plugin + all animations (965 KB)
  BepInEx\plugins\ComboSpear\icon.png         mod icon - shows in CDEV ModManager and friends
  icon.png  README.md  CHANGELOG.md  manifest.json


UNINSTALL
---------

Delete BepInEx\plugins\ComboSpear\  (nothing is written into your save)
