HarpoonLongboat

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.