EasyWeapon

EasyWeapon

AI generated statement: This module is written by the AI ​​agent (WorkBuddy) under the clear needs and itemized acceptance of the user;

Functional design, real-device testing and release decisions are all led by users.

Weapon feel. Pure client module.

Features (3 items)

| # | Function | Default | Configuration Section |

| --- | --- | --- | --- |

| 1 | Reload time multiplier - Crossbow / Hookline | 0.5 (= reload time halved) | 1 - Reload Speed ​​|

| 2 | Reloading is not interrupted - reloading is not cleared when running / jumping / dodging and rolling | All three are enabled | 2 - Uninterruptible Reload |

| 3 | Chain Lightning Enhancement - unified weapon trigger rate + ChainLightningRed special effect parameters | See 3 - Chain Lightning Section | 3 - Chain Lightning |

These two requirements are actually the same mechanism in the game

Disassembly confirmation (game 1.0.14, assembly_valheim.dll):

| Items | Localization keys | m_requiresReload | m_reloadTime | Reload animation | Skills |

|---|---|---|---|---|---|

| Grapplinghook | $item_graplinghook ⚠️ There is one less p in the game | true | 2.0 s | reload_crossbow | None (no skills) |

| Crossbow (Arbalest / Ripper×4 / Gold×3 and its variants, 8 in total) | $item_crossbow_* | true | 3.5 s | reload_crossbow | Crossbows |

| Lightning Staff (default not moving) | $item_staff_lightning | true | 1.9 s | recharge_lightningstaff | ElementalMagic |

Both share ItemData.GetWeaponLoadingTime():

if (!m_requiresReload) return 1f; ← This branch must be bypassed

float skill = Player.m_localPlayer.GetSkillFactor(m_skillType);

return Mathf.Lerp(m_reloadTime, m_reloadTime * 0.5f, skill); ← The maximum level of the crossbow skill has already been halved

Therefore, "Crossbow in half" and "Hook in half" are one mount point, and there is no need to write two sets.

Configuration

BepInEx/config/easyweapon.client.only.cfg

1 - Reload Speed

| key | default | description |

| --- | --- | --- |

| Enabled | true | Master switch |

| ReloadTimeMultiplier | 0.5 | Time multiplier: 0.5 = reload time halved (faster). ⚠️ Fill in 2 to slow down |

| Crossbows | true | crossbow |

| GrapplingHook | true | grappling hook |

| Staves | false | Staff (currently the lightning staff is being recharged, charging 1.9 s) |

| OtherReloadWeapons | false | Other weapons that "need to be reloaded" (newly added in game updates and not yet recognized by this module). I would rather stay still than get hurt by accident |

| Verbose | true | Record a log when encountering a weapon for the first time (including the time spent before and after), and only record the same weapon once |

2 - Uninterruptible Reload

| key | default | description |

| --- | --- | --- |

| Enabled | true | Master switch |

| OnRun | true | Do not interrupt reloading while running |

| OnJump | true | Do not interrupt reloading when jumping |

| OnDodge | true | Do not interrupt reloading when dodging a roll |

| Verbose | true | Record one every time a new reloading action is protected (the same action is only recorded once, no screen refresh) |

Attacks will still interrupt reloading - that was the original design, this mod doesn't do that.

3 - Chain Lightning

| key | default | description |

| --- | --- | --- |

| Enabled | true | Master switch (weapon side + special effects side are controlled together) |

| WeaponProcChance | 0.66 | All attack slots that "generate chain prefabs on hit" use this chance for both main and secondary attacks. Original main attack 0.25 / secondary attack 0.20 |

| RedStartChance | 1.0 | ChainLightningRed's starting chance (original 0.9). ⚠️ The determination is once per frame (during survival), not "the trigger rate of each swing" |

| RedChancePerTarget | 0.66 | The probability of each candidate target being linked (original version 0.3), each target is determined independently |

| RedMinTargets | 4 | Minimum number of targets chained at one time (original version 2) |

| RedMaxTargets | 6 | The maximum number of targets …