Riverheim Config

Riverheim Config

WARNING: BETA — HIGH RISK. BACK UP YOUR WORLDS AND SAVES.

• Experimental build. Functionality is not guaranteed.
• May cause unintended consequences, including corrupted worlds or saves.
• Back up existing worlds and characters before installing or changing settings.
• Recommended: Test on a fresh world first. Do not use on critical servers without backups.
• Use at your own risk. Report findings on the Riverheim Discord.

Server-enforced configuration mod for Riverheim Rivers & Lakes. Allows server administrators to customize river and lake generation with automatic client synchronization.

Features

• Server-Enforced Config: All clients automatically use the server's configuration
• 26 Configurable Parameters: Control every aspect of river and lake generation
• Version Checking: Ensures all players have compatible mod versions
• No Client Setup Required: Clients just need the mod installed - config syncs automatically

Configuration Categories

• River Spawning
• Density: Control how many rivers spawn (0.25 = default, 0.7 = ~2000 rivers)
• Starting Variability: Randomness in river spawn locations
• Weight Recovery: How quickly river density recovers after spawning
• Min Land Neighbors: Minimum land tiles adjacent to river mouths
• Min Pointer Magnitude: Minimum flow direction strength
• River Size
• Width Scale: Base river width multiplier (140 = default, 280 = Amazon-like)
• Width Power: How width scales with river depth
• Width Offset: Width adjustment offset
• River Filtering
• Min Strahler: Minimum river order to keep (2 = default, 1 = keep all streams)
• Min Width: Minimum river width in meters
• Max Catchment Diff: Maximum drainage area difference
• River Appearance
• Meander Amplitude: How much rivers curve and wind
• Meander Period: Frequency of river curves
• Min Depth: Minimum river depth (visual)
• Bank Steepness: How steep river banks are
• Max Bank Height: Maximum height of river banks
• River Valleys
• Valley Offset: Base valley depth (-160 = default)
• Valley Magnitude: Valley depth multiplier
• Valley Exponent: Valley shape curve
• Lakes
• Spawn Threshold: Lake spawn probability (0.9 = default, 0.8 = many lakes)
• Noise Scale: Lake distribution pattern scale
• Lowland Contribution: How much lowlands favor lakes
• Curiosity Contribution: Lakes near interesting terrain features
• World Size
• World Radius: World radius in meters (10500 = default 21km diameter)
• Tile Spacing: Distance between generation points (70 = default)

Installation

Server

• Install BepInEx
• Install Riverheim Rivers & Lakes
• Install this mod
• Configure settings in BepInEx/config/com.valheim.riverheim.config.cfg
• Start server

Client

• Install BepInEx
• Install Riverheim Rivers & Lakes
• Install this mod
• Connect to server - config will sync automatically!

How It Works

When a client connects to a server:

• ServerSync sends all configuration values from server to client
• Client temporarily uses server's values (local config file unchanged)
• World generation uses server settings
• Both server and client generate identical terrain

Important Notes

• Create a NEW world after changing config values
• All players must have both Riverheim and this mod installed
• Config values have "True Limits" (hard-coded) and "Practical Ranges" (recommended)
• Extreme values may cause performance issues or crashes

Example Presets

Cross-Continent Rivers

Density = 0.7

WidthScale = 280

MinStrahler = 3

Lake-Heavy World

LakeSpawnThreshold = 0.8

LakeLowlandContribution = 0.6

Minimal Rivers

Density = 0.15

MinStrahler = 4

MinWidth = 25

Compatibility

• Requires: Riverheim Rivers & Lakes 0.12.0+
• Compatible with: Most Valheim mods
• Conflicts with: ExpandWorldSize (if you modify WorldRadius)

Support

Please report feedback and issues on the Riverheim Discord (preferred) or the mod page. Include logs and your config file when possible.

Credits

• ServerSync: blaxxun-boop
• Riverheim: Riverheim_Dev

Changelog

See C