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.
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
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2351README
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.

How to Use
- Harpoon a creature normally.
- 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.