Conditional Config Sync

Conditional Config Sync

Conditional Config Sync is a shared infrastructure library for Valheim mods. It does not add gameplay content, items, UI, or configuration options of its own. Install it when another mod lists it as a dependency.

The package provides centralized config synchronization, version checks, server-side policy overrides, protected locking, and synchronized runtime values. Keeping this logic in one standalone dependency means fixes can be shipped by updating this package instead of rebuilding every mod that uses it.

It is an independent synchronization option for mod authors who need per-setting ownership policy, hidden-setting controls, and expanded runtime-value behavior. Jotunn and ServerSync remain separate libraries with their own use cases and development paths.

For players

Normally, a mod manager installs Conditional Config Sync automatically as a dependency. Keep it installed while any enabled mod depends on it.

This package:

• []does not replace, modify, or intercept ServerSync used by other mods;[/]

  []does not migrate or modify configuration belonging to other mods;[/]

  []can run alongside Jotunn and mods that use ServerSync;[/]

  []only handles mods that were explicitly built against Conditional Config Sync.[/]

Package contents

The Thunderstore package contains:

• []ConditionalConfigSync. Plugin.dll - the BepInEx bootstrap registered as _shudnal. ConditionalConfigSync;[/]

  []ConditionalConfigSync.dll - the public API and synchronization runtime used by dependent mods;[/]

  []ConditionalConfigSync.xml - IntelliSense documentation for IDEs and mod authors;[/]

  []SHA256SUMS.txt - SHA-256 hashes of both release DLL files.[/]

Compatibility

Conditional Config Sync uses its own BepInEx and Harmony identifier:

_shudnal. ConditionalConfigSyncIt does not patch, replace, or disable Jotunn synchronization or ServerSync. These libraries can coexist in the same process because each mod continues using the synchronization library it was compiled against.

Embedding or ILRepacking ConditionalConfigSync.dll into another mod is intentionally unsupported. An embedded copy rejects initialization and reports an explicit