SailRange

SailRange gives a Valheim server control over the map exploration radius used while sailing, without requiring every client to install the mod.

Features

• Configurable boat exploration radius; 150 meters by default.
• Drivers and passengers both receive the larger radius while aboard a ship.
• Vanilla on-foot exploration remains unchanged.
• Clients are optional: unmodded players connect normally without the feature.
• Compatible modded clients receive the server value and see it as read-only.
• Local-world configuration remains editable.
• One self-contained DLL with no companion mod or sync-library dependency.

How synchronization works

When a compatible client connects, SailRange identifies itself to the server. The server replies with its configured radius, and the client uses that value until it disconnects. The client's original local value is restored afterward. Clients without SailRange never participate in this handshake and are not rejected.

Map exploration is client-side in Valheim. An unmodded client therefore keeps vanilla exploration behavior; installing the client DLL opts that player into the server-controlled larger radius.

Installation

Thunderstore / r2modman

Install SailRange on the server profile. Players who want the expanded boat exploration radius should install the same package in their client profile. Other players can connect without it.

Manual

Copy SailRange.dll into a folder under BepInEx/plugins on the server and on participating clients.

This mod replaces both BiggerBoatMapExploreRadius and BoatMapExploreRadiusServerSync. Remove those older plugins to avoid duplicate patches and competing configuration files.

Configuration

After first launch, edit BepInEx/config/jg224.BoatRadiusGuard.cfg on the server, or use a compatible in-game configuration manager. The legacy filename is intentionally retained so upgrades from BoatRadiusGuard keep their setting:

[General]

BoatExploreRadius = 150

The accepted range is 10–10000 meters. Very large values reveal substantially more map pixels during each exploration update and may cause a noticeable hitch.

Compatibility

• Valheim with BepInEx 5
• Dedicated servers and local worlds
• Steam and crossplay networking

Building

dotnet build .\SailRange.sln -c Release
dotnet run --project .\tests\SailRange.ApiTests\SailRange.ApiTests.csproj -c Release --no-build
powershell -ExecutionPolicy Bypass -File .\_verify_build.ps1

The plugin output is src/SailRange/bin/Release/net472/SailRange.dll.

License

MIT