Valheim Battle Royale

Server-controlled Battle Royale matches for Valheim with shrinking safe zones, synchronized timers, map circles and configurable outside-zone damage.

Installation and upgrade

Requires BepInEx for Valheim. Install 1.1.0 on the server and every participating client. This release uses protocol 110 and is incompatible with previous releases.

For manual installation, place ValheimBattleRoyale.dll in BepInEx/plugins/. Replace the previous DLL and remove duplicate copies. Restart the server and clients after updating. The configuration file is BepInEx/config/com.xtasy.ValheimBattleRoyale.cfg.

Features

• Server-controlled match start countdown and zone transitions.
• Current and next safe zones with configurable waiting and shrinking times.
• Server-authorized outside-zone damage, applied by the owning client.
• Automatic PvP during matches.
• Safe-zone circles on the map and minimap.
• TextMeshPro HUD with English and Russian text.
• Administrator commands, configurable hotkeys and rate-limited diagnostics.

Quick start

1. As an administrator, set an initial zone with br here 1000, or Shift + left click on the large map.
2. Start the countdown with br start or F7.
3. Set a next zone using br nexthere 500 or Shift + left click on the large map. The waiting phase precedes shrinking.
4. Stop the match with br stop or F7.

Zone controls require administrative access. Map shortcuts are configurable. Map commands are blocked during text entry and menus, and require a pointer hit on the map.

Commands

Command	Action
br start / br stop / br toggle	Control the match
br status	Display local match/synchronization information
br zone <x> <z> [radius]	Set the initial/current zone
br here [radius]	Set the initial/current zone at your position
br next <x> <z> [radius]	Set the next zone
br nexthere [radius]	Set the next zone at your position
br cancelnext	Cancel the next zone when allowed

Default map controls are Shift + left click to place/move a zone and Ctrl + left click to cancel a zone. Cancellation prioritizes NEXT; cancelling CURRENT can stop the match. Zone changes are restricted during shrinking.

Changes in 1.1.0

• Fixed locally issued host/server commands failing to read their packets.
• Fixed living characters with an absent health field being skipped by outside-zone damage.
• Added verification of the actual transport peer, message direction and destination before BR RPC routing.
• Added rate-limited diagnostics for rejected packets and absent explicit health values.
• Fixed PvP notification filtering, preservation of the original PvP setting across respawns and map input focus.
• Corrected server state-age reporting and added HUD component recovery/diagnostics.

See CHANGELOG.md for details and previous release notes.

Diagnostics and limitations

Enable diagnostic logging in the plugin configuration and collect BepInEx/LogOutput.log from the server and affected clients. Check that all participants report version 1.1.0. A missing or incompatible client mod cannot participate correctly; the server waits for its state acknowledgement before sending zone damage.

This release addresses all confirmed critical and P2 findings from the October 25 review, including PvP notifications, restoration across respawns and map input focus. Disabled or missing HUD rendering components are recovered, with additional diagnostics. The reported missing HUD on some clients has not yet been reproduced conclusively. Client-side damage application is not an anti-cheat guarantee.

The DLL compiled successfully against the available local game/BepInEx libraries. 478 critical-fix checks and 210 zone serialization checks passed. No live multiplayer or HUD rendering test was performed; a multiplayer validation run is still needed.

License

MIT. See LICENSE.