You are viewing a potentially older version of this package. View all versions.
LEGIOmods-ShipTweaks-1.0.0 icon

ShipTweaks

Configurable Valheim ship speeds with rowing force multiplied by players on the ship.

Date uploaded 2 days ago
Version 1.0.0
Download link LEGIOmods-ShipTweaks-1.0.0.zip
Downloads 46
Dependency string LEGIOmods-ShipTweaks-1.0.0

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2333 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.2333

README

ShipTweaks

ShipTweaks is a standalone Valheim BepInEx 5 mod for configurable ship speed and rowing behavior.

Status

This release has been tested in multiplayer, but ship physics can still vary with latency, world load, and other ship-related mods. Back up important worlds before using it on a long-running server.

AI Disclosure

This mod and Thunderstore package were created with AI assistance. OpenAI Codex was used to help generate code, package structure, and documentation.

Features

  • Configurable multipliers for rowing/reverse, half sail, and full sail.
  • Optional normal hard speed limit and separate thunder/storm speed limit.
  • Normal rowing/reverse force can be multiplied by the number of players on the ship.
  • While rowing, xPlayerCount is shown next to the ship speed icon.
  • No seat, W/S, or extra oar mechanics.
  • PaddlePower-compatible approach: existing ship values are changed only temporarily per physics tick.

Configuration

After first launch, edit:

BepInEx/config/domen.valheim.shiptweaks.cfg

Simple settings:

  • RowSpeedPercent
  • HalfSailSpeedPercent
  • FullSailSpeedPercent
  • MaxSpeedLimit
  • StormSpeedLimit
  • PassengerRowingEnabled

If PassengerRowingEnabled = true, rowing uses:

Rowing force = vanilla rowing force * RowSpeedPercent / 100 * players on ship

Example: RowSpeedPercent = 100 and 3 players on the ship gives 3x vanilla rowing force. RowSpeedPercent = 150 and 3 players gives 4.5x vanilla rowing force.

Default values:

  • RowSpeedPercent = 150
  • HalfSailSpeedPercent = 125
  • FullSailSpeedPercent = 150
  • MaxSpeedLimit = 0
  • StormSpeedLimit = 0
  • PassengerRowingEnabled = true

For MaxSpeedLimit and StormSpeedLimit, 0 means ShipTweaks does not apply an additional hard speed limit. It does not mean 0 m/s. Valheim still limits ships through physics, wind, mass, and water resistance.

Vanilla reference values:

  • Raft: paddle 1.6 m/s, half sail 1.7-2.2 m/s, full sail 2.2-3.1 m/s
  • Karve: paddle 3.14 m/s, half sail 2.8-4.8 m/s, full sail 3.9-7.0 m/s
  • Longship: paddle 3.16 m/s, half sail 3.6-6.7 m/s, full sail 5.0-9.75 m/s
  • Drakkar: paddle 2.50 m/s, half sail 3.3-6.2 m/s, full sail 4.65-8.9 m/s

Multiplayer

Install ShipTweaks on the server and on all clients that should experience the same ship behavior and UI indicator.

Build

.\Build-Package.ps1
.\Install-Local.ps1

CHANGELOG

Changelog

1.0.0

  • Current public release candidate for Thunderstore.
  • Configurable rowing, half sail, and full sail speed multipliers.
  • Optional normal speed limit and storm speed limit.
  • Passenger rowing can multiply rowing force by the number of players on the ship.
  • Rowing UI indicator shows the active player multiplier.
  • Added AI-assisted creation disclosure to the README and assembly metadata.
  • English release documentation and config descriptions.