ztag96-ValheimReelableHarpoon icon

ValheimReelableHarpoon

Reel in harpooned creatures with a button press instead of running away.

Last updated 9 hours ago
Total downloads 53
Total rating 0 
Categories Tweaks Gear Tools Server-side Client-side Utility
Dependency string ztag96-ValheimReelableHarpoon-1.1.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

Valheim Reelable Harpoon

A simple Valheim mod that lets you pull targets with the harpoon by pressing a combination of keys (currently Run+Use or Shift+E). This is my first Valheim mod, so I decided to try something that seemed simple. I based my design philosophy around the description of Wendigo's mod HarpoonReelin. So, all this does is patch a couple methods: SE_Harpooned.UpdateStatusEffectand Utils.Pull.

video1

How to Use

  1. Harpoon a creature normally.
  2. Hold Shift+E, or Run+Use, to the pull creature towards you.
  • Your stamina will drain while pulling a creature. The drain rate is the same as vanilla.
  • You can only pull a creature until it's closer than MinDistance.

What does it do?

The harpoon's distance from the player is saved when it attaches to a creature. By deliberately decreasing that distance, we can simulate pulling. I've also allowed players to choose whether they can pull targets "up." Vanilla harpoons cannot pull creatures upwards. By modifying the noUpForce parameter to the Utils.Pull method, harpoons can now do this.

Configuration

The config file can be found at <valheim_install_path>/BepInEx/config/ztag96.ValheimReelableHarpoon.cfg You can also make changes to the config mid-session except for the keybindings. The config files should sync across a server, and admins have the ability to lock edits to the config.

Option Description Default Value
IsLocked Whether the config is locked and cannot be edited. true
PullSpeed The speed at which the harpoon will reel in. 10
MinDistance The closest a creature can be reeled. 5
CanPullUp If the harpoon can pull creatures up. false
PreferredButton What button to prefer using for pulling. Default

Dependencies

All you need is BepInEx. This was made on v5.4+ if you care. Confirmed Compatibility is only with Valheim 1.0+.

Conflicts

This mod will almost definitely conflict with HarpoonReelin and any other mods that add any sort of Reeling behaior, especially those that modify SE_Harpooned members. Let me know if you find any other conflicts.

Bugs?

Post an Issue on the GitHub Repository.

AI Disclosure

No vibe coding here. Generative AI was used for research into the BepInEx, Harmony, Valheim, and other libraries after solo research failed. Debugging was also assisted by AI.