Report a bug or buy us a coffee at dfgaming.net.

Safe Harbor

Buildable ship docks that do the seamanship for you. Steer any longship, karve, or raft into an open berth, press a key at the rudder, and the ship eases into a cradle, lifts out of the water, and is dry-docked (physics frozen) — with auto-repair each time. Press the key again to slide it back out to the waterline. Docking persists across save and reload.

A Valheim BepInEx 5 plugin built on Jotunn.

Features

• Two buildable dock pieces (Hammer > DFG):
  • Safe Harbor Dock (large, ships) — 40 Wood / 20 FineWood / 10 Iron.
  • Safe Harbor Skiff Dock (small, karves/rafts) — 20 Wood / 8 FineWood / 3 Iron.
• Docked ships are lifted and frozen; berth occupancy is stored so docking survives reloads.
• Status lamps per berth: green = open, red = docked.
• In-game tuner (Alt+L) plus a web tuner (http://127.0.0.1:8781/) to position lamps/pieces live.
• Optional PlanBuild/Infinity Hammer blueprint look-and-feel for custom docks.
• Indestructible by default; auto-repair on dock.

Requirements

• BepInEx 5 (denikson-BepInExPack_Valheim)
• Jotunn 2.30.x (ValheimModding-Jotunn)

Installation

1. Install through your mod manager (recommended).
2. Manual: drop SafeHarbor.dll into BepInEx\plugins\.

How to use

1. Restart the game after installing (the build pieces are registered at startup).
2. Build a Safe Harbor Dock (large) or Skiff Dock (small) at the waterline near your base.
3. Steer a ship toward a free berth. When within 50 m of a dock with a free berth, a prompt appears: Shift+D to choose dock.
4. With the prompt visible, press Shift+D to open the berth picker (click or press 1-9). The ship eases into the berth, lifts ~1.8 m, and freezes — and is auto-repaired.
5. To leave, sit at the rudder and press Shift+D again — the ship slides clear and pushes off.

Optional extras

• Status lamps show berth open/docked at a glance (config StatusLights).
• Alt+L opens the "Safe Harbor Tuner" to move/rescale lamps and pick a deck material live; "Save defaults" writes it back to config.
• Blueprint docks: with UseBlueprint on, a safeDock.blueprint (large) or smallDock.blueprint (skiff) auto-found in the PlanBuild blueprint folder is used instead of the procedural model; per-piece tuning is saved to safeharbor_dock.json / safeharbor_skiff.json.

Configuration

Generated on first launch at BepInEx\config\com.safeharbor.safeharbor.cfg (excerpts; keys marked restart need a game restart):

Changelog

See CHANGELOG.md.

Support

If this mod has made your journey through the Tenth World a little better, consider tossing a coin into my Ko-fi jar: https://ko-fi.com/draugrforgedgaming. Your support keeps the forge hot and the mead flowing! Skål!

Changelog

All notable changes to Safe Harbor.

[1.0.29]

• The large dock is the included dock.glb model. dock.glb and dock_icon.jpg ship next to the DLL.
• Press E on the dock controls to dock a nearby ship, deploy it, board it, or open its hold.
• A ship docked again after undocking stays registered, so Deploy, Board, and Dock storage stay available.
• Status lights sit on the model's lanterns: green when the berth is open, red when a ship is docked.
• The placement ghost keeps the dock underside on the shore or the water.
• The web tuner saves berth, ship level, and the three light nudges to safeharbor_model.json.

[1.0.4]

• New harbor icon: a docked longship with green and amber berth lanterns.

[1.0.3]

• The package page now points to dfgaming.net to report a bug or buy a coffee.

[1.0.2]

• Safe Harbor Dock and Safe Harbor Skiff Dock now show on the Hammer DFG tab. They are added to the live Hammer build table after the world loads, with real Wood, Fine Wood, and Iron costs.

[1.0.1]

• Bug fixes and improvements to docking, appearance, and the web tuner.

[1.0.0] - Initial release

• Buildable "Safe Harbor Dock" and "Safe Harbor Skiff Dock" pieces (Hammer > Misc) via Jotunn.
• Dock ships into a berth, lift and dry-dock them (physics frozen), auto-repair on dock, and persist docking across save/reload.
• Undock slides the ship clear and gives it a forward push.
• Per-berth status lamps (green/red), in-game tuner GUI (Alt+L), and web tuner on port 8781.
• Optional PlanBuild/Infinity Hammer blueprint docks with per-piece JSON tuning.
• Config: General / Controls / Blueprint / Docking / Dock / SmallDock sections.