TAIJI-WindheimShips icon

WindheimShips

Per-player ship management for Valheim. Assign a Flagship and Boat, recall your ships from anywhere with a keypress, and track them on the minimap. Supports all vanilla ships and OdinShip.

CHANGELOG

Changelog

All notable changes to WindheimShips are documented here.


[0.1.0] — 2026-06-29

Initial public release.

Added

  • Fleet system — per-player Flagship and Boat slots, stored in ZDOs and persisted across sessions.
  • Ship recall — configurable hotkey (default K) opens the Fleet panel. One click teleports the selected ship to a valid water position near the player.
  • Unloaded zone recall — when a ship is in an unloaded zone, recall nudges its ZDO toward the player without requiring the chunk to be loaded first.
  • Stale ZDO recovery — two-pass recovery system: exact ZDOID match first, then nearest ship of the same type within 50 m. Full ZDOMan scan as fallback.
  • Boat slot — persistent secondary vessel (default Raft). Indestructible. Stores to virtual inventory when not deployed; spawns on demand with no resource cost.
  • Minimap pins — Flagship (hammer icon) and Boat (pin icon) tracked on both minimap and large map. Colors and labels configurable.
  • Pin restoration — ship pins are restored after Valheim's ClearPins wipes the minimap (e.g., on map reopen).
  • Occupied ship protection — configurable behavior (block / force-recall) when another player is aboard the target ship.
  • OdinShip support — all Ship-component vessels, including OdinShip's 7 custom prefabs, register automatically via the Ship.Awake postfix patch.
  • Dual helm patch — patches both ShipControlls.Interact and ShipControlls.TryInteract with HarmonyPrepare guards so the correct method is patched regardless of Valheim build version.
  • Modular config system — nine static config classes: General, Fleet, Recall, Map, UI, Persistence, Compatibility, Debug, Experimental. Generates com.TAIJI.windheim.cfg on first launch.
  • Plugin GUIDcom.TAIJI.windheim
  • Dependencies — BepInExPack_Valheim 5.4.2333, Jotunn 2.29.1