HarpoonLooter

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

1. Install through your mod manager (recommended) — BepInEx and Jotunn are installed automatically.
2. Manual: drop HarpoonLooter.dll into BepInEx\plugins\.

How to use

1. Restart the game after installing (the build piece is registered at startup).
2. Build the Harpoon Looter from the Hammer under Furniture.
3. Place it near where you fight or loot. It runs unattended: items dropped within CollectionRange are harpooned and reeled toward the turret's base, landing in a scattered pile on the ground.
4. Loot the pile whenever you like — items auto-stack as they land.
5. To keep the turret off certain loot (e.g. Wood, Stone, Amber), set IgnoredItems. 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.