1 items
About this mod
Each additional passenger increases the speed that ships move when in paddle mode
- Requirements
- Permissions and credits
- Donations
A small thematic mod to make it more fun to sail around with friends. AKA make your friends help you row!
Features
Known issues/limitations
Pre-Requisites
This mod requires BepInEx. Follow the instructions here if you don't have it installed already: https://valheim.thunderstore.io/package/denikson/BepInExPack_Valheim/
Installation
Configuration
Configuration file is located at "<GameDirectory>\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 https://en.wikipedia.org/wiki/Geometric_series 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
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 = number of players seated or bracing the bow or mast
- Speed scaling formula and player counting method is configurable, see the Configuration section below for more information
Known issues/limitations
- All users on a server should have the mod installed to minimize issues
- Players do not need to be sitting on a seat or holding fast to the bow or mast of the ship in order to increase the speed; anywhere on the deck will count as helping. I hope to improve this in a future update
- 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: https://valheim.thunderstore.io/package/denikson/BepInExPack_Valheim/
Installation
- Extract the archive into a folder. Do not extract into the game folder.
- Move the contents of "plugins" folder into "<GameDirectory>\Bepinex\plugins"
- Start the game
Configuration
Configuration file is located at "<GameDirectory>\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 https://en.wikipedia.org/wiki/Geometric_series 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