ConfigurationManager

v1.1.25·Updated 2026-10-06

Localized, recolored, refined. Split view mode. Config files editor. Setting edit window. Changed values are highlighted. Prevent user input or pause the game while window is open. Window scale depend

About this mod Author’s original text

The mod was originally created and hosted by the BepInEx team

It is distributed under the GPLv3 and this version maintains that license.

That fork have additions from other similar mods

  • Coloring and localization are based on aedenthorn's
  • Color drawer is based on Azumatt's (dev branch)
  • Everything taken was improved and refined in various places

How to use

Press hotkey button in game (default F1) to open mod window and change configuration of mods.

Features improved

  • Localization - every button and label can be localized
  • Elements recolored - you can set color of background, widget and enabled toggle
  • Fonts colored - set distinct colors for default and changed values
  • Color drawer extended further
  • Window is draggable, resizable and remembers its size and position
  • Open and close window by hitting one hotkey. Close window with Escape.
  • Dropdown menu style refined; open dropdowns suppress hover highlights and tooltips on other manager controls
  • Reuses UI styles, enum metadata, and tooltip measurements instead of rebuilding them on every IMGUI event
  • Lots of minor refinements and improvements
  • Readonly entries (locked from server) could be colored, disabled or completely hidden
  • Dynamic ReadOnly and Browsable attributes are refreshed while the window remains open and rechecked immediately before a setting write
  • Synchronization state buttons with hover details for Jotunn, ServerSync and Conditional Config Sync settings; S means server-controlled and C means client-controlled. Conditional settings use the normal font color while their mod default is active and blue after server policy changes the ownership. Authorized administrators can toggle CCS Conditional ownership directly.
  • Optional compact config list layout applies uniform reduced vertical spacing to every setting row, is enabled by default and is switchable from the window header
  • default view is Split View where plugins and categories are showed as a tree in left column
  • File Editor for configuration files
  • Setting Edit Window for more detailed setting configuration

Valheim specific

Valheim 1.0.7 is the target game version. The manager uses ZCursor for cursor visibility and restores the current scene's cursor handling when it closes.

Prevent input supports three modes: Off allows pass-through; Player blocks gameplay and background HUD/menu controls while preserving the console; All also blocks console input. The manager itself remains interactive. These modes cover vanilla ZInput/uGUI paths, not arbitrary other mods reading Unity input directly.

Dropdown placement is derived from the actual button rectangle independently of background hover masking, including in scrolled and scaled windows.

Tooltips are available on setting names and synchronization indicators even when an entry is read-only. Tooltip hit areas respect the owning window and scroll viewport. Both manager scaling and the optional Valheim GUI scale are supported.

The game will be paused (if it can be paused) while the window is open (disabled by default).

Configuration Manager settings and server policy

All settings belonging to Configuration Manager itself are registered with Conditional Config Sync as policy-controlled settings. They remain client-controlled by default, preserving each player's local UI, input, window, text, color, and file-editor preferences.

When Configuration Manager is also installed on the server, administrators can use the CCS synchronization policy to force individual settings or complete sections to server-controlled ownership. Lock Configuration is always server-controlled. Configuration Manager remains optional on remote peers (ModRequired = false), so clients without the mod can still connect.

Hidden settings

Create file shudnal.ConfigurationManager.hiddensettings.json and place n

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.

Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.

Dependencies

Install these first, or the mod will not work:

denikson-BepInExPack_Valheimshudnal-ConditionalConfigSyncValheimModding-YamlDotNetValheimModding-JsonDotNET

File & checksum

Filename
ConfigurationManager-1.1.25.zip
File size
153.6 KiB
SHA-256
92559b877ad2d25f7baaf0253c212c76251d890a869a1597edf383578e69338d
Stored at
2026-10-07 05:08