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.
HarpoonLooter
A buildable ballista that harpoons dropped items on the ground and reels them into a convenient pile at its base - no more scouring the battlefield for gear.
By DFG
| Date uploaded | a week ago |
| Version | 1.1.1 |
| Download link | DFG-HarpoonLooter-1.1.1.zip |
| Downloads | 30 |
| Dependency string | DFG-HarpoonLooter-1.1.1 |
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.2333
ValheimModding-Jotunn
Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.
Preferred version: 2.30.0README
Harpoon Looter
Adds a new build piece, the Harpoon Looter — a small ballista that automatically harpoons dropped items lying on the ground within range and reels them into a pile at its base.
No more chasing loot across the battlefield — build one near where you fight and everything gets dragged home and dumped at its feet to grab or stack.
A Valheim BepInEx 5 plugin built on Jotunn.
Features
- New build piece: Harpoon Looter (Hammer > Furniture), crafted from 10x Fine Wood and 5x Iron.
- Scans for dropped
ItemDrops within range (default 20 m) and fires a harpoon at them. - Reels items into a neat pile at the turret base. Items keep normal auto-stack behaviour — no inventory hacks, no ObjectDB edits.
- Configurable everything: range, reel speed, pile radius, harpoon flight time, concurrent targets, cooldown, tether visibility, and an ignored-items list.
Requirements
- BepInEx 5 (
denikson-BepInExPack_Valheim) - Jotunn 2.30.x (
ValheimModding-Jotunn)
Installation
- Install through your mod manager (recommended) — BepInEx and Jotunn are installed automatically.
- Manual: drop
HarpoonLooter.dllintoBepInEx\plugins\.
How to use
- Restart the game after installing (the build piece is registered at startup).
- Build the Harpoon Looter from the Hammer under Furniture.
- Place it near where you fight or loot. It runs unattended: items dropped within
CollectionRangeare harpooned and reeled toward the turret's base, landing in a scattered pile on the ground. - Loot the pile whenever you like — items auto-stack as they land.
- To keep the turret off certain loot (e.g.
Wood, Stone, Amber), setIgnoredItems. This is applied live without a restart.
Configuration
Generated on first launch at BepInEx\config\com.harpoonlooter.harpoonlooter.cfg:
| Key | Default | Description |
|---|---|---|
Enabled |
true |
Master toggle for the turret behaviour. |
AddBuildPiece |
true |
Register the piece in the Hammer build menu (requires restart). |
ShowTether |
true |
Draw the harpoon rope while reeling. |
CollectionRange |
20 |
Detection range in meters. |
ReelSpeed |
8 |
Pull speed in m/s. |
PileRadius |
2.5 |
Release radius around the turret base. |
HarpoonFlightTime |
0.45 |
Seconds for the harpoon visual to reach the target. |
MaxTargets |
1 |
Concurrent harpoons (1-6). |
Cooldown |
1 |
Seconds between collections. |
Scale |
0.5 |
Uniform scale of the turret model (1 = vanilla size, 0.5 = half). Requires restart. |
IgnoredItems |
(empty) | Comma-separated dropped items to never collect, e.g. Wood, Stone, Amber. Matches the item prefab name or name token, case-insensitive. |
Changelog
See CHANGELOG.md.
CHANGELOG
Changelog
All notable changes to Harpoon Looter.
1.1.1
- Fixed: dropped items that landed close to the turret (inside the pile radius) are now collected instead of silently skipped.
- Fixed: reeling is now reliable — items are pulled all the way into the pile by moving them directly, instead of via rigidbody velocity which vanilla physics damped out on settled items.
- Items arrive cleanly at the pile with their physics velocity zeroed.
1.1.0
- Added
Scaleconfig (default0.5) — the turret now spawns at half its vanilla size;1restores the original scale. - Added
IgnoredItemsconfig — comma-separated list of dropped items the turret will never collect (e.g.Wood, Stone, Amber). Applied live. - Collection range is still tweakable via
CollectionRange.
1.0.0
- Initial release.
- New buildable "Harpoon Looter" ballista (Hammer > Furniture, 10x Fine Wood + 5x Iron) cloned from the vanilla Ballista via Jotunn.
- Fires a harpoon visual at dropped items within
CollectionRangeand reels them into a pile at the turret base. - Config: Enabled, AddBuildPiece, ShowTether, CollectionRange, ReelSpeed, PileRadius, HarpoonFlightTime, MaxTargets, Cooldown.
