PassageWind

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

Passage Wind

Personal ship fast-travel — "TradeWind for people". Record named docks, then board your own ship, pick a destination, and sail there in a straight line. The pilot makes the ship kinematic and drives it straight through terrain and waves, so nothing can beach or block you.

A Valheim BepInEx 5 plugin.

Features

• Record docks with a hotkey; optionally drop a saved map pin for each.
• Import docks from map pins named PW <name>.
• Single-destination fast travel (not multi-waypoint routes): sit on your ship, pick a dock, sail.
• Trips only advance while at least one player is seated — if everyone unboards, the ship holds position.

Requirements

• BepInExPack Valheim (installed automatically)

Installation

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

How to use

1. Record docks — stand where you want a dock and press Alt+N (auto-named "Dock 1", "Dock 2", ...). With DropMapPins on, a PW <DockName> pin is dropped on the map.

Alternative: place map pins named PW <name> anywhere, then press Alt+I to import them all as docks.

1. Pick a destination — press Alt+R to open the dock menu (press 1-9 to select, or click a row; the selected dock is highlighted). Alt+R closes it.
2. Sail — sit on your own ship, set gear with Alt+G (Cruise/Standard/Full), then press Shift+G to start and stop the trip. Arrival is announced with a message.
3. The ship travels in a straight line, clipping through terrain intentionally, and holds position if nobody is seated.

Configuration

Generated on first launch at BepInEx\config\com.passagewind.passagewind.cfg:

| Section | Key | Default | Description | |---------|-----|---------|-------------| | General | Enabled | true | Master toggle. | | General | DebugLogging | true | Log trip activity. | | General | DropMapPins | true | Drop a saved map pin when recording a dock. | | Navigation | ArriveRadius | 12 | Distance from the dock that counts as arrived (m). | | Navigation | TurnRate | 90 | How fast the ship yaws toward a destination (deg/s). | | Navigation | StartRange | 10 | Max distance from a ship to show the sail prompt (m). | | Speeds | CruiseSpeed / StandardSpeed / FullSpeed | 3.5 / 5 / 7 | Gear speeds (m/s). | | Speeds | Gear | 1 | Active gear: 0 = Cruise, 1 = Standard, 2 = Full. | | Routes | MapPinPrefix | PW | Map pin prefix for docks. | | Routes | RoutePinIcon | Icon3 | Vanilla pin icon for dock pins. | | Routes | SelectedDock | (empty) | Destination dock the ship sails to. | | Controls | MenuKey | Alt+R | Open/close the dock menu. | | Controls | DepartKey | Shift+G | Start/stop the trip (seated on a ship). | | Controls | GearKey | Alt+G | Cycle speed gear. | | Controls | RecordKey | Alt+N | Record the current location as a dock. | | Controls | ImportKey | Alt+I | Import PW <name> map pins as docks. |

Notes

• Depart is Shift+G (not Alt) — deliberate, so it doesn't clash with the menu key.
• Trips ignore sailing physics and beaching entirely (intentional design).
• Docks are stored in passagewind_docks.json under BepInEx\config\.

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!