Tonto-Autosail icon

Autosail

Pick a pin or any spot on the map and your ship sails there by itself, planning a route over open water and stopping at the nearest shore. Made for Njord's Belt and Charm.

By Tonto
Last updated 12 hours ago
Total downloads 62
Total rating 1 
Categories Mods Vehicles Transportation AI Generated
Dependency string Tonto-Autosail-0.1.2
Dependants 0 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2350 icon
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.2350
BranchOfYore-SailingProgression-0.1.12 icon
BranchOfYore-SailingProgression

Level Sailing together to improve boat speed and hull endurance. Equal XP and boat camera zoom for passengers and helmsmen, with adjustable bonuses.

Preferred version: 0.1.12
Azumatt-Official_BepInEx_ConfigurationManager-18.4.1 icon
Azumatt-Official_BepInEx_ConfigurationManager

Mod to assist with configuration of BepInEx mods

Preferred version: 18.4.1

README

Autosail

Pick a pin, or any spot on the map, and your ship sails there by itself. Autosail plans a route over open water, steers around coasts, rocks and other ships, slows down near the end and stops at the nearest safe water if your spot is on land.

It is built for Njord's Belt and Njord's Charm from Sailing Progression. Njord's Favor keeps a steady tailwind pointing the way the ship faces, so the autopilot never has to tack and only has to steer.

How to use

  1. Wear Njord's Belt or Charm and take the helm (hands on the wheel).
  2. Open the map (M).
  3. Hover the mouse over a pin or any spot. A pin within 300 m of the cursor is used in place of the exact spot.
  4. Press H. The map closes and the ship starts sailing.
  5. To stop, press H again with the map closed. Steering by hand, leaving the helm, taking the belt off, or getting stuck also switches it off.

To change destination, open the map, hover a new spot and press H again.

Do not double-click the map while choosing. That opens the pin name box, and H would type into it. If you want a new pin, name it first, then hover over it and press H.

Settings

Everything can be changed in-game with the Configuration Manager (F1), or in BepInEx/config/tonto.autosail.cfg.

Setting Default What it does
AutopilotKey H Start, change destination, or stop
CloseMapAfterStart on Closes the map after you pick a destination
RequireNjordsFavor on Only start while wearing the belt or charm
CellSize 64 Route grid size in metres; smaller finds narrower channels
MinDepth 3 Metres of water required under the route
ShoreMargin 25 Sideways clearance kept from the coast
ArrivalRadius 45 Stop when this close to the end of the route
PinSnapRadius 300 How close a pin must be to the cursor to be chosen
SteerRange, Damping 35, 0.02 Steering feel; raise Damping if the ship swings past its heading
AvoidDistance 80 How far ahead it looks for obstacles
InvertRudder off Flip the rudder if the ship turns away from its target
Log off Extra detail in LogOutput.log

Good to know

  • Routes use the world's terrain, so they also work across areas that are not loaded. Player-built structures and terraformed ground are not part of the route; the forward obstacle check handles what it can see.
  • Dangerous waters such as serpents cannot be avoided from the map alone, so stay alert.
  • It runs only on the player at the helm. Other players do not need the mod.
  • You can turn off RequireNjordsFavor, but without a tailwind the wind decides your speed and the ship cannot tack.

Problems?

Set Log to on, reproduce the problem and attach BepInEx/LogOutput.log (the lines containing "Autosail") when you report it.

Credits

Njord's Belt and Njord's Favor come from Sailing Progression by BranchOfYore. Autosail only reads whether you are wearing them.