2 - Getting Started

Updated a week ago

Getting started

Install

  1. Install BepInEx (BepInExPack Valheim). That's the only requirement.
  2. Install Straumr with your mod manager, or drop Straumr.dll into BepInEx/plugins.
  3. Start the game. Rivers start flowing on any world, Valheim's own or Riverheim's.

Optional, picked up automatically:

  • Riverheim: big river networks for Straumr to set flowing.
  • Rivers and Lakes: streams, lakes and waterfalls above sea level. Straumr leaves that water to it.
  • Seasonality: spring snowmelt, higher rivers and flood plains, low winter water.
  • ValheimRAFT: its vehicles ride the current too.

Not recommended together: Undertow and Fires Valheim Galaxies. Both move the sea and push boats along their own currents, so anything afloat would be carried twice. With NorgerWater, Straumr hands the water's surface over to it and switches its own built water off.

Multiplayer and servers

  • Install Straumr on the server and on every player's game.
  • The server's physics settings are sent to everyone who joins, and players get their own back when they leave. How the water looks and sounds stays each player's own choice.
  • Dams, cofferdams and kept pools belong to the server. It decides them and keeps them with the world, so everyone sees the same water and a restart picks up where things were.
  • On a dedicated server, keep [Currents] RiverLevels on (the default). Dams need it.
  • A player joining with an older Straumr, or none, is told on screen that their water will differ.

Multiplayer has been tested on a dedicated server with lab clients and join, config-sync and restart tests, and played by one player. It hasn't yet been played by a group.

Riverheim 1.2 and 1.3

Riverheim 1.2.x Riverheim 1.3.x
Straumr 0.1.3 works works
Straumr 0.1.2 works rivers break: update Straumr

Moving a world from Riverheim 1.2 to 1.3:

  • Back up the world first (its .fwl and .db files). The first time Riverheim 1.3 saves an old world, it converts it to Worldhalla's format, and Riverheim 1.2 can't read it after that.
  • A world made with Riverheim_Config's settings needs Riverheim_Config 3.1.1 or later on Riverheim 1.3, or its terrain changes.

Upgrading an existing world to 0.1.3

Dams, cofferdams and kept pools are on by default. When 0.1.3 loads a world:

  • walls you already built across a river become dams, their pools taken as long full;
  • rings of wall standing in the water start to drain.

To keep a world exactly as it was, set these to false before loading it (on a server, in the server's config):

[Dams]
Enabled = false
[Cofferdams]
Enabled = false
[Pools]
Enabled = false

Floods are off by default ([Floods] Enabled).