Harpoon Longboat

A buildable Harpoon Longboat — a longship variant that does the boring sea work for you. It carries a self-operating deck ballista that harpoons floating dropped items and reels them into the boat's cargo hold, can hook and pull sea creatures toward the ship, and mounts a rideable, manually-aimed deck catapult for when you want to launch things yourself.

A Valheim BepInEx 5 plugin built on Jotunn.

Features

• Harpoon Longboat build piece (Hammer > Misc), 40x FineWood / 40x AncientBark / 20x Iron / 10x DeerHide.
• Item harpooning: auto-targets floating dropped items within CollectionRange, fires a bolt, and reels them straight into the ship's vanilla cargo hold.
• Creature reeling: hooks one sea creature at a time (range/faction configurable) and pulls it toward the boat.
• Deck catapult: a rideable catapult that fires items from the cargo hold, with angle/aim/power controls and an ejector seat.
• Cosmetic options: hull/sail recolour, extra shields, glowing lanterns, a prow harpoon, a scaled hearth (warmth), and a canvas roof that grants Sheltered to players aboard.
• Live placement web GUI at http://127.0.0.1:8779/ to position the turret, catapult, hearth, roof, and lanterns.

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 HarpoonLongboat.dll into BepInEx\plugins\.

How to use

The harpoon ballista

1. Build the Harpoon Longboat from the Hammer under Misc and place it in deep water near your sailing lane.
2. Sit at the rudder. The ballista auto-aims at targets.
3. H toggles the harpoon on/off, J cycles its mode (Items / Creatures / Both).
4. While aboard: T starts/stops reeling a hooked creature, G releases it.
5. Collected items are deposited automatically into the ship's cargo hold.

The deck catapult

1. Walk to the chair on the catapult and press E to sit (hover prompt "Boat Catapult").
2. While seated: W/S or Up/Down = arm angle, A/D or Left/Right = aim yaw, Shift+Up/Down = power, Shift+F = fire (consumes one item from the hold), V = deploy legs, T = eject yourself (no fall damage by default), E = stand up.

Tuning visuals

Open http://127.0.0.1:8779/ while the game runs to move/rescale the turret, catapult, hearth, roof, and lanterns on the boat. Changes apply live and persist to harpoonlongboat_placement.json.

Configuration

Generated on first launch at BepInEx\config\com.harpoonlongboat.harpoonlongboat.cfg (select keys; most start as true):

Section	Key	Default	Description
General	Enabled	true	Master toggle.
General	AddBuildPiece	true	Add the piece to the Hammer menu (restart).
General	WebPort	8779	Placement GUI port.
General	ShowTether / ShowBolt	true	Harpoon rope / bolt visuals.
Collection	CollectionRange	25	Item pickup range (m).
Collection	ReelSpeed	10	Reel speed to the hold (m/s).
Collection	MaxTargets	2	Items reeled at once (1-8).
Collection	IgnoredItems	(empty)	Comma list of never-collected items.
Creatures	ReelCreatures	true	Pull sea creatures.
Creatures	CreatureRange	30	Creature hook range.
Creatures	TargetMonsters / TargetAnimals / TargetTamed	true / false / false	Which creatures to hook (tamed pulls livestock!).
Controls	ToggleKey / ModeKey / ReleaseKey / ReelToggleKey	H / J / G / T	Steering hotkeys.
Appearance	Recolor, AddLanterns, AddHearth, AddRoof, RemoveSail	true	Cosmetic toggles (mostly restart-gated).
Catapult	Enabled / AddCatapult	true	Enable and mount the catapult (restart).
Catapult	Scale	0.5	Catapult model scale.
Catapult	FireCooldown	2.5	Seconds between shots.
Catapult	EjectNoFallDamage	true	No fall damage when ejecting (T).

Most Appearance/Visual keys need a game restart. Recolor tints apply live.

Changelog

See CHANGELOG.md.