TerramizerServer

TerramizerServer is the dedicated-server companion for Terramizer. It improves how the server covers split-up players, prioritizes important world state during dense synchronization, recovers a few stale ownership routes, and provides bounded diagnostics without requiring the DLL on clients.

Install location

Install this package on the Valheim dedicated server only. Clients do not need TerramizerServer.

Manual install:

1. Install BepInExPack for Valheim on the dedicated server.
2. Copy TerramizerServer.dll into BepInEx/plugins.
3. Start the server once to generate BepInEx/config/r4v9n1.terramizerserver.cfg.

The Thunderstore package places the DLL at:

BepInEx/plugins/TerramizerServer/TerramizerServer.dll

What it does

• Combines active object coverage for every ready peer on the dedicated server.
• Predicts player travel so server-side loading can prepare in the direction of movement.
• Prioritizes player, terrain, solid, and explicitly prioritized ZDO state ahead of bulk objects.
• Applies strict queue backpressure and dense-area pauses to prevent streaming boosts from creating runaway backlog.
• Repairs narrowly validated stale ownership routes for removable build pieces and nearby item drops.
• Tunes sleep fast-forward while preserving the normal world-save policy by default.
• Skips visual/audio-only initialization that is unnecessary in a headless server process.
• Logs periodic synchronization, queue, streaming, ownership-repair, and stale-instance statistics.

Safe defaults

TerramizerServer runs only on a dedicated server by default. Experimental full local peer-zone creation, mass persistent-ZDO ownership transfer, ZDO throttling, and sleep-save skipping are disabled.

Version 0.4.7 also forces the legacy full peer-zone creation option off even if an older config enabled it. Valheim's normal ghost-zone generation remains active.

Compatibility

Version 0.4.7 is built against:

• Valheim 0.221.12 / network version 36
• Unity 6000.0.61f1
• BepInEx 5.4.23.3

TerramizerServer detects Better Networking, Fires Ghetto Network Mod, the older ZdoStreamTuner, and Valheim Serverside Simulations. It yields overlapping patches to those mods where necessary.

Optional IL patches validate the expected Valheim method shape. If a game update changes a target, the affected TerramizerServer feature is disabled and an explicit patch-mismatch message is written to the BepInEx log.

Back up the world before game or mod upgrades. Keep SkipSleepWorldSave = false unless you knowingly accept the durability tradeoff.

Configuration

The generated config is:

BepInEx/config/r4v9n1.terramizerserver.cfg

The shipped defaults are intended to be the safe testing baseline. Change one setting at a time and retain the BepInEx log when reporting performance or multiplayer interaction problems.

Support information

For useful diagnostics, include:

• the full BepInEx/LogOutput.log from server startup through the problem;
• the TerramizerServer version;
• Valheim and BepInEx versions;
• connected player count;
• whether the problem occurred during sailing, portal travel, sleep, building, or dense-base loading;
• the server config file with secrets removed.

Created by R4V9N1.