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.
| Date uploaded | 4 days ago |
| Version | 1.0.0 |
| Download link | ztag96-ValheimReelableHarpoon-1.0.0.zip |
| Downloads | 36 |
| Dependency string | ztag96-ValheimReelableHarpoon-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
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 up to the MinDistance which is set in the configuration.
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 only pull targets along the x & z axes, so only forward, backward, left, and right. By modifying the noUpForce parameter to the Utils.Pull method, harpoons can affect a target's y position.
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. The config files should sync across a server, and admins have the ability to lock edits to the config. Keeping the PullSpeed not much higher than 1 facilitates a "lore-friendly" experience.
| 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. | 1 |
| MinDistance | The closest a creature can be reeled. | 5 |
| CanPullUp | If the harpoon can pull creatures up or down. | true |
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.
CHANGELOG
1.1.0
- Added partial support for custom bindings.
- Gamepads now only need to press one button by default.
- Smoothed the rate of change between pull speeds. The default pull speed is now 10 because of this adjustment.
- CanPullUp is now false by default.
- Pull prefix patch does a conditional check to ensure the harpooned body is being pulled before modifying noUpForce.
1.0.0
- Initial release
