PaddlePower

v1.0.2·Updated 2021-03-07

More ship passengers means more hands to help paddle

About this mod Author’s original text

A small thematic mod to make it more fun to sail around with friends.

Features

  • Each additional passenger increases the speed that ships move when in paddle mode (forward or back 1 arrow speed)
  • Speed increase is configurable, and defaults to a geometric series sum with a = 1/2, r = 7/8, and n = passenger count

Known issues

  • All users on a server should have the mod installed to minimize issues
  • Logging out or disconnecting while on the deck of a ship may cause the passenger count to be incorrectly increased until all players leave the area

Pre-Requisites

This mod requires BepInEx. Follow the instructions here if you don't have it installed already:

Installation

  • Extract the archive into a folder. Do not extract into the game folder.
  • Move the contents of "plugins" folder into "\Bepinex\plugins"
  • Start the game

Configuration

Configuration file is located at "\Bepinex\config\ohmg.mods.paddlepower.cfg"

"enabled": enables or disables this plugin in its entirety

"debug_logging": enables or disables printing debug log messages. Kind of spammy and not necessary unless you're trying to figure out a particular issue

"counting_method": What players to count as contributing to ship speed

  • ALL: All players on the deck of the ship
  • ATTACHED: (default) Only count players on the ship that are seated or holding onto the mast or bow
  • SEATED: Only count players that are seated (includes pilot)

"scaling_method" selects which formula to use for calculating player speed contributions

  • GEOMETRIC: (default) Each additional player contributes a diminishing amount of extra speed
  • LINEAR: Each additional player contributes the same amount of extra speed

GEOMETRIC specific configuration properties:

  • Check out for a primer on geometric series
  • The "coefficient" and "ratio" properties correspond to "a" and "r" in the article
  • The "ratio" configuration property is constrained to between 0 and 1

LINEAR specific configuration properties:

  • "base_amount": Paddle force contributed by the ship pilot
  • "additional_amount": Paddle force contributed by each additional player
  • "maximum_bonus": Maximum paddling force, regardless of player count

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.

Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.

Dependencies

Install these first, or the mod will not work:

denikson-BepInExPack_Valheim

File & checksum

Filename
PaddlePower-1.0.2.zip
File size
27.1 KiB