Invau-CrewManualSailControl icon

CrewManualSailControl

Crew play for boats. Players aboard trim the sail by hand to catch the wind while another steers, and can man oars to add speed. Oar count, positions and speed bonus are configurable per boat.

By Invau
Last updated 2 weeks ago
Total downloads 105
Total rating 1 
Categories Mods Client-side Utility
Dependency string Invau-CrewManualSailControl-0.9.5
Dependants 0 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2351 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.2351

README

Crew Manual Sail Control

A mod built for crew play on boats. While one player steers, the others can trim the sail by hand and man the oars. Still in development, bugs may occur.

Features

Manual sail

  • In the base game the sail faces the wind on its own. With this mod, you swing the sail yourself to catch the wind.
  • How well the sail is trimmed sets how much power you get, from a configurable minimum (so you never fully stop) up to full power.
  • Any player standing on the boat can trim the sail, not only the helmsman. The sail angle is shared with everyone aboard.

Crew oars

  • Raft, Karve, Longship and Drakkar get oar stations on their sides.
  • Walk up to an oar and press the use key to man it. Press it again to leave.
  • Each active rower adds a speed bonus, a bit higher with the sail up than with the sail down.
  • Oars only push when someone is at the helm, and they follow the helmsman: forward when sailing forward, backward when reversing, no push when stopped.
  • The number of rowers is shown on screen while aboard.

Controls

Active while you are aboard a ship. Keys can be changed in the config.

Key Action
Left Arrow Swing the sail to port
Right Arrow Swing the sail to starboard
Use key on an oar Man or leave the oar

Installation

Install with a mod manager, or copy ManualSail.dll into BepInEx/plugins. Requires BepInExPack Valheim.

The physics of a boat runs on the game of one player aboard, so the simplest is for everyone who sails together to install the mod. A dedicated server does not need it. Works alongside Faster Boats.

Configuration

The config file BepInEx/config/com.bouns.manualsail.cfg is created on first launch. It can also be edited in game with a configuration manager.

General, controls and sailing

Setting Default Description
Enabled true Master switch for the whole mod (sail and oars). false = base game.
RotateSailLeft LeftArrow Hold to swing the sail to port.
RotateSailRight RightArrow Hold to swing the sail to starboard.
RotateSpeedDegPerSec 60 How fast the sail swings while a key is held.
MaxAngleDeg 90 Maximum swing to each side.
MinEfficiency 0.25 Lowest wind efficiency, even badly trimmed or into the wind (0 to 1). 0 means you can be brought to a full stop.
Debug false Show the sail angle and wind efficiency on screen.

Oars

Setting Default Description
Enabled true Crew oars on or off.
SpeedBonusPerRowerSailUp 6 Speed bonus per active rower with the sail up, in percent.
SpeedBonusPerRowerSailDown 4 Speed bonus per active rower with the sail down, in percent.

Each boat type also has its own section (Oars 1 Raft, Oars 2 Karve, Oars 3 Longship, Oars 4 Drakkar) with OarCount, SideOffset, Spacing, Height, StandOffset, OarLength and OarWidth. Positions update live. Length and width apply when the boat loads.

Default oar count: 2 on the Raft and Karve, 4 on the Longship and Drakkar.

Credits

Thanks to the BepInEx team for the framework, to Andreas Pardeike and the HarmonyX project for the runtime patching library, and to the Valheim modding community for the documentation.

If you want to support me: Buy Me a Coffee