Mod Configs

Change any client-side mod's config in-game with a UI that matches the native Settings panel. Browse and edit BepInEx plugin .cfg settings without leaving the game or alt-tabbing to edit files by hand.

Edits save to your local .cfg files. No server install is required for Mod Configs itself. When a mod uses ServerSync (or tags settings with ReadOnly / IsAdminOnly), this UI shows the current values after sync and disables editing while those settings are locked — so clients display what the server enforced without overwriting it locally.

• Wood-panel Settings-style window (toggles, sliders, steppers, dropdowns, keybind rebind)
• Dynamically lists BepInEx configs from loaded plugins
• CFG description text above each option
• Reset to Defaults for the selected mod (skips read-only / server-locked entries)
• Global presets 1-5 (tabs on the left) that store every mod's settings at once; the bottom Save button fills the active one
• Presets 1-5 per mod with Delete / Save and an active-preset marker
• Name and describe any preset (right-click it, or press Y on a controller)
• Controller support: navigate everything with the D-pad, open dropdowns with A, close with B
• Open from the pause menu (after Settings); optional main-menu button

Install with Gale (recommended)

1. Install Gale.
2. Select Valheim and open your profile.
3. Make sure BepInExPack Valheim is installed.
4. Download this mod and click Install with Mod Manager,
   or go to Import → local mod and select the downloaded zip.
5. Click Launch.

Manual install (BepInEx)

1. Install BepInExPack Valheim if you do not already have it.

2. Extract the zip.

3. Copy files into:

   Valheim\BepInEx\plugins\ModdedWolf-ModConfigs\

   The folder should contain ModConfigs.dll, manifest.json, icon.png, and README.md.

   Prefer the Thunderstore / Gale package folder name (ModdedWolf-ModConfigs) so enable/disable in the mod manager controls the install. A bare plugins\ModdedWolfsConfigs\ folder is invisible to Gale and will always load.

4. Launch Valheim.

Configuration

After first launch, settings are saved here:

BepInEx\config\ModdedWolf.ModConfigs.cfg

OK and Cancel

Changes take effect in game right away so you can try them out.

• OK closes Mod Configs and keeps your changes.
• Cancel (or Escape) closes it and puts every mod's settings back to how they were when you opened it. Presets you saved meanwhile are kept.

Controller

Mod Configs works with a gamepad:

• The mod picker is selected when the panel opens. Use the D-pad or left stick to move, and the list scrolls to follow the selection.
• Right leaves the All Mods presets for the control at the same height. Left from the left edge of the panel returns to them.
• Buttons on the same row (preset slots, minus and plus) move left and right. Cancel and OK sit under the list: Down from the last setting or the last All Mods button reaches them, and they move between each other.
• Left and Right move a slider. A on a slider opens its number so you can type a value. B leaves that number and highlights the slider again.
• A presses buttons, toggles, and opens dropdowns. In a dropdown, move to an option and press A; B closes it without changing anything.
• Text and number fields start editing only when you press A on them. Highlighting a box does not start typing.
• LB / RB switch to the previous or next mod, like switching tabs in the game's Settings. Their button prompts show beside the mod picker.
• Y on a preset slot or global preset tab opens the rename box.
• Rebind accepts keyboard keys, mouse buttons, or controller buttons (shown as Pad A, Pad RB, etc.). B or Escape cancels.
• B while you are typing in a text box leaves that edit. B while typing in the settings search clears the search and stays there. B otherwise works like Cancel. Cancel keeps its B prompt, and X works like OK, the same as in Settings.

Presets

There are two kinds of presets. Hover the i icon in-game for a quick guide.

Global presets are the 5 tabs down the left side of the panel. Each one stores the settings of every mod.

• Click a tab to load it for all mods. Grey tabs are empty; clicking one just makes it active. Click the active tab again to unselect it.
• Save (under Preset 5) stores every mod's current settings in the active tab and writes all config files. The panel stays open.
• Delete (under Save) clears the active tab's stored preset, including its name and description (click it twice to confirm). Your current settings are not changed. Turn on KeepGlobalPresetLabel to keep the name and description.
• A * on the active tab means something changed since it was saved.
• Right-click a tab to give it a name (20 characters) and a short description (shown when you hover it).

Mod presets are the 5 slots in the row under the mod picker. They store only the selected mod. Right-click a slot to name and describe it.

• Click a number to load that preset. It becomes the active preset (gold frame).
• Changes apply right away but are not stored in the preset until you press Save. A * on the active slot means unsaved changes.
• Grey numbers are empty. Clicking one makes it active without changing anything; press Save to fill it.
• Click the active preset again to unselect it. Your current settings stay as they are.
• Delete clears the active preset. Click it twice to confirm (it shows Confirm? for 3 seconds).

Mod presets are stored in BepInEx\config\ModdedWolf.ModConfigs.Presets\<mod GUID>.txt and global presets in _Global.txt in the same folder. Read-only / server-locked settings are skipped on save and load.

Compatible with BepInEx Configuration Manager attributes (Browsable, IsAdvanced, ReadOnly, IsAdminOnly, etc.). ServerSync-driven ReadOnly locks are respected in the UI.

Notes

Mod Configs does not sync settings by itself. It edits local .cfg files. Mods that use ServerSync (or similar) push server values into those entries; when a setting is marked read-only, this UI displays it but will not save local overrides.

Support

Questions or bugs? Discord    Ko-fi

Changelog

1.1.1

• Opening or reopening Mod Configs on a large config no longer freezes the game
• Cancel, presets, and Reset load a large config over a few frames instead of all at once
• Search stays responsive while a large config is still loading

1.1.0

• Search bars have an X button to clear the text
• Fixed stuttering while typing in search
• Click a selected preset again to unselect it
• Right-click a preset to rename it on the game's wood background
• Controller support. The D-pad moves through the list, LB/RB switch mods, B is Cancel, and X is OK
• Y renames the selected preset, and that button icon shows on the preset
• Keybinds can be set to controller buttons. B cancels a rebind
• A edits a text box or a slider's number. Left and Right move a slider
• Switching mods on large configs no longer lags
• Settings use more of the panel's width

1.0.9

• Preset tabs stay on screen when the GUI scale is maxed
• Removed the Edit button; right-click a preset to rename it
• Global preset Save and Delete now sit under the tabs (Delete asks for a second click to confirm)
• Back is replaced by Cancel and OK, centered at the bottom: OK keeps your changes, Cancel (or Escape) undoes every change made since opening Mod Configs
• Preset names are capped at 20 characters
• Deleting a global preset also clears its name and description (new KeepGlobalPresetLabel setting keeps them)

1.0.8

• Added presets: every mod gets its own 5 preset slots with Save and Delete, a gold frame on the active preset, and a * when you have unsaved changes (hover the "i" icon for help)
• Added global presets: 5 tabs down the left side of Mod Configs that store every mod's settings at once
• The OK button is now Save: it stores every mod's settings in the active global preset and keeps the panel open
• Presets can be renamed and given a short description (right-click a preset, or use Edit under the tabs)
• Mod preset row now reads Delete, then Save
• Smaller title bar and Back/Save footer, giving the options list more room
• Advanced settings are now shown by default (new installs)
• Mouse wheel scrolls a steady step, including while the cursor is over a slider, button, or text field
• Fixed Atze's Build Camera (and similar mods that keep their .cfg in a helper class) not showing up; changes apply right away without a restart

1.0.7

• Now finds mods that save settings to their own custom .cfg file (e.g. Atze's Build Camera)
• Mod Configs opens faster, especially when reopening it
• More room for the options list (smaller header, less empty space at the bottom)

1.0.6

• Added search for mods and for preset / option dropdowns
• Fixed the look of dropdown boxes
• Improved scrolling

1.0.5

• Fixed empty Mod Configs panel when connected to a multiplayer / dedicated server (should be the final update)

1.0.4

• Added a scrollbar to the main settings panel when a mod has a bunch of options (also can grab anywhere and drag up and down)
• Opening Mod Configs no longer resets in-game GUI scale to 100%

1.0.3

• Fixed enum / preset dropdowns so you can scroll and select options below the fold

1.0.2

• Fixed pause-menu Mod Configs for Valheim 1.0

1.0.1

• Updated mod description to emphasize changing client-side mod configs (.cfg) in-game, no server install needed
• New mod icon

1.0.0

• Client-only in-game config UI matching Valheim Settings
• Dynamic discovery of BepInEx plugin configs
• Mod picker, toggles, sliders/steppers, keybind rebind, Reset to Defaults per mod
• CFG description text above options; left-aligned layout