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.
HarpoonLongboat
A buildable longship with a self-operating deck ballista that reels in floating drops and sea creatures, cosmetic hull options, and a rideable deck catapult.
By DFG
| Last updated | 3 days ago |
| Total downloads | 53 |
| Total rating | 1 |
| Categories | Transportation AI Generated |
| Dependency string | DFG-HarpoonLongboat-1.0.0 |
| Dependants | 0 other packages depend on this package |
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 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
- Install through your mod manager (recommended) — BepInEx and Jotunn are installed automatically.
- Manual: drop
HarpoonLongboat.dllintoBepInEx\plugins\.
How to use
The harpoon ballista
- Build the Harpoon Longboat from the Hammer under Misc and place it in deep water near your sailing lane.
- Sit at the rudder. The ballista auto-aims at targets.
- H toggles the harpoon on/off, J cycles its mode (
Items/Creatures/Both). - While aboard: T starts/stops reeling a hooked creature, G releases it.
- Collected items are deposited automatically into the ship's cargo hold.
The deck catapult
- Walk to the chair on the catapult and press E to sit (hover prompt "Boat Catapult").
- 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.
