Ultimate Server Configuration Manager

Ultimate Server Configuration Manager (Ultimate SCM) 1.0.4

Every mod's settings. One panel. Synced live with the server.
💬 Join the Discord

> 💡 Suggestions, bugs and questions: https://discord.gg/aMkN89Cuas — when reporting a bug, attach your BepInEx LogOutput.log and say what you expected to happen.

A universal settings panel for Valheim. It shows the configs of all installed BepInEx mods, explains each one using the mod's own comment (with a button to translate it into your Valheim language), and syncs everything with the server.

> Install on the server and on all clients.

Screenshots

Home screen — every mod, what changed, what is pending:

Editing a mod as admin — edit any config live, choose per config or per mod what players see (Hidden · View only · Can edit), draft several changes and apply them at once:

What a player sees — by default everything is hidden until the admin releases it:

Mod Integration (1.0.4)

Mods with their own configuration panel can add it to Mod Integration in Ultimate SCM.

How to add your mod panel

1. Inside the Ultimate SCM mod folder, open:

Developer Integration/SCMPanel.cs

1. Copy SCMPanel.cs into your mod project, alongside your other .cs source files. If you use Visual Studio, you can also use Add → Existing Item and select SCMPanel.cs.

1. Make sure your mod already has a console command that opens its panel. Example:

new Terminal.ConsoleCommand(
    "yourmod_config",
    "Opens the mod settings panel.",
    new Terminal.ConsoleEvent(OnCommand),
    false, false, false, false, false, false, null, false, false, false
);

1. Immediately after registering that command, register it with Ultimate SCM:

SCMPanel.Register("yourmod_config");

This makes the panel available to Player + Admin.

For a panel that should be visible only to admins:

SCMPanel.Register("yourmod_config", true);

The first argument must be the exact console command that opens your mod's panel. The second argument is optional: false (default) means Player + Admin, while true means Admin only.

Ultimate SCM uses the registering mod's manifest.json and icon.png to build the card automatically. Mod Integration is always available in the sidebar: with zero integrations it appears like the standard menu items as Mod Integration (0) and shows an explanatory page; when at least one compatible panel is available, the entry receives the orange highlight and a count badge.

When you open the normal configuration page of a mod that has an accessible integrated panel, Ultimate SCM also shows a highlighted notice at the top of that mod's settings with an OPEN button. The notice is shown only for that matching mod and follows the same Player/Admin access rule as Mod Integration.

Complete example

new Terminal.ConsoleCommand(
    "yourmod_config",
    "Opens the mod settings panel.",
    new Terminal.ConsoleEvent(OnCommand),
    false, false, false, false, false, false, null, false, false, false
);

SCMPanel.Register("yourmod_config");

Installation

• Install through a mod manager (Thunderstore Mod Manager, r2modman, etc.), or copy the contents of plugins/ to BepInEx/plugins/Ultimate_SCM/.
• It must be installed on the server AND all clients.
• Requires BepInExPack_Valheim.

---

How to open

• ESC → "Mod Settings" (a button added to the pause menu), or
• F1 (configurable in Panel hotkey). ConfigurationManager also uses F1 by default: change the key of one of the two.
• ESC closes the panel (if a search is typed, the first ESC press clears the search).
• The window remembers where you left off: position, size (drag the top to move it and the bottom-right corner to resize it), last opened mod, collapsed sections, and filters. Center window resets it to the default.

Shortcuts

| Key | Action | |---|---| | F1 | opens/closes | | Ctrl+F | jumps to search | | Enter | applies the typed value | | Ctrl+Z | undoes the last change (outside text fields) | | Ctrl+S | applies the draft | | ESC | closes the confirmation → cancels the note → clears the search → closes the panel |

---

Sync rules