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

• Install through your mod manager (recommended) — BepInEx and Jotunn are installed automatically.
• Manual: drop HarpoonLooter.dll into BepInEx\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 CollectionRange are 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), 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.