Ryanlt-ConfigurationManager icon

ConfigurationManager

Unofficial Holdfast repackage of BepInEx ConfigurationManager 19.0. Press F5 in game to change any mod's settings. Includes a small patcher that sets the F5 hotkey and keeps HideManagerGameObject on.

Last updated 6 days ago
Total downloads 7
Total rating 1 
Categories Tools
Dependency string Ryanlt-ConfigurationManager-19.0.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

HoldfastModding-BepInExPack_Holdfast-5.4.2305 icon
HoldfastModding-BepInExPack_Holdfast

BepInEx pack for Holdfast: Nations At War. Preconfigured and ready to use.

Preferred version: 5.4.2305

README

ConfigurationManager for Holdfast

An unofficial Holdfast: Nations At War repackage of BepInEx ConfigurationManager 19.0 by the BepInEx team. The plugin files are the upstream BepInEx 5 release, unchanged. The package adds a small patcher that sets the hotkey and checks one BepInEx setting.

ConfigurationManager lists the settings of every installed BepInEx mod in one window, where you can change them in game.

Use

Press F5 in game to open or close the window. Settings are grouped by mod. Hover over a setting name to see its description. A change is written to that mod's file in BepInEx\config\. Some mods only read a setting when the game starts.

Install

Install through r2modman or Thunderstore Mod Manager. It is client side. Remove any copy of ConfigurationManager you added by hand first.

Holdfast changes

The package adds a BepInEx patcher, ConfigurationManager.Holdfast.dll, in BepInEx\patchers\ConfigurationManager\. It runs before any mod loads and checks two settings.

Setting File Change
HideManagerGameObject under [Chainloader] BepInEx\config\BepInEx.cfg Set back to true on any launch where it is false. The Holdfast BepInEx pack ships true. BepInEx's own default is false, which a deleted or rebuilt BepInEx.cfg falls back to. With false, Holdfast removes ConfigurationManager at the first scene load and the hotkey does nothing.
Show config manager under [General] BepInEx\config\com.bepis.bepinex.configurationmanager.cfg Set to F5 when the file does not exist yet. The upstream default is F1, which is the Holdfast console.

HideManagerGameObject applies to the BepInEx object that holds every mod's plugin component, so it keeps all of them loaded for the whole session.

On the first launch BepInEx\LogOutput.log shows:

[Info   :ConfigurationManager.Holdfast] HideManagerGameObject is already true.
[Info   :ConfigurationManager.Holdfast] Wrote com.bepis.bepinex.configurationmanager.cfg with the F5 hotkey.

Later launches show only the first line. When the patcher had to turn the setting back on, the first line reads Set HideManagerGameObject = true in BepInEx.cfg so ConfigurationManager survives the first scene load.

Change the hotkey

Open the window, find Configuration Manager in the list and change Show config manager. The patcher only writes the hotkey when the file is missing, so your choice stays through updates. Holdfast already uses F1, F2 and F4.

Mod authors

ConfigurationManager shows the description, range and list of values passed to Config.Bind. The ConfigurationManager.xml and ConfigurationManagerAttributes.cs files in the plugin folder are for reference while coding. The upstream README covers sliders, drop-downs, keyboard shortcuts and the attributes.

Problems

Report problems with this package to Ryanlt. Report a problem upstream only if it also happens with the upstream release.

License and source

ConfigurationManager is licensed under the LGPL-3.0, included as LICENSE. The source for this version is tag v19.0. The Holdfast patcher is released under the same license.