The initial commit of this repo is an exact copy of the latest release (as of May 23rd, 2023) located here. The code has been modified to work with BepInEx Bleeding Edge, Version/Artifact 667. I updated the dlls to match those located here, added a simple build pipeline, and changed a few references here and there. The build output has been tested with BepInEx Bleeding Edge Version/Artifact 667, alongside a mod that makes use of it for the game Shadows of Doubt v33.19. It is not guaranteed to work outside of that context.
By sinai-dev.
In-game UI for managing BepInEx Configurations, for IL2CPP and Mono Unity games.
✨ Powered by UniverseLib
Download the latest IL2CPP.CoreCLR release from the Downloads page. Mono and non-Interop IL2CPP versions are not included, see the original repo for those versions.
plugins/BepInExConfigManager.{VERSION}.dll and the UniverseLib.{VERSION}.dll files in your BepInEx/plugins/ folder.patchers/BepInExConfigManager.{VERSION}.Patcher.dll file in your BepInEx/patchers/ folder.F5 to open the Menu.BepInExConfigManager category in the Menu, or by editing the file BepInEx/config/com.sinai.BepInExConfigManager.cfg.
Although this tool should work out of the box for most Unity games, in some cases you may need to tweak the settings for it to work properly.
To adjust the settings, open the config file: BepInEx\config\com.sinai.bepinexconfigmanager.cfg
Try adjusting the following settings and see if it fixes your issues:
Startup_Delay_Time - increase to 5-10 seconds (or more as needed), can fix issues with the UI being destroyed or corrupted during startup.Disable_EventSystem_Override - if input is not working properly, try setting this to true.If these fixes do not work, please create an issue in this repo and I'll do my best to look into it.
This config manager supports advanced settings, defined either with the ConfigurationManagerAttributes tag or with a simple "Advanced" tag.
Simple method ("Advanced" string tag):
Config.Bind("Section", "Hidden setting", true, new ConfigDescription("my description", null, "Advanced"));
Advanced method (official attributes class):
ConfigurationManagerAttributes class in your project as outlined hereConfig.Bind("Section", "Advanced setting", true, new ConfigDescription("my description", null,
new ConfigurationManagerAttributes() { IsAdvanced = true }));
The UI supports the following types by default:
boolint, float etc (any primitive number type)stringUnityEngine.KeyCode or UnityEngine.InputSystem.Keyenum or any setting with AcceptableValueListenum with [Flags] attributeUnityEngine.ColorUnityEngine.Vector3, UnityEngine.Quaternion, etcBepInEx.Configuration.TomlTypeConverter.To make a slider, use a number type and provide an AcceptableValueRange when creating the entry. For example:
Config.Bind("Section", "Int slider", 32, new ConfigDescription("You can use sliders for any number type",
new AcceptableValueRange<int>(0, 100)));
Dropdowns are used for enum types, as well as any setting with an AcceptableValueList provided.
If you use an AcceptableValueList it will override any other UI handler and force it to be a dropdown.
Config.Bind(new ConfigDefinition("Section", "Some list"), "One", new ConfigDescription("An example of a string list",
new AcceptableValueList<string>("One", "Two", "Three", "Four", "etc...")));
You can override the Toml input for a Type by registering your own InteractiveValue for it. Refer to existing classes for more concrete examples.
// Define an InteractiveValue class to handle 'Something'
public class InteractiveSomething : InteractiveValue
{
// declaring this ctor is required
public InteractiveSomething(object value, Type fallbackType) : base(value, fallbackType) { }
// you could also check "if type == typeof(Something)" to be more strict
public override bool SupportsType(Type type) => typeof(Something).IsAssignableFrom(type);
// override other methods as necessary
}
// Register your class in your BasePlugin.Load method:
public class MyMod : BepInEx.Unity.IL2CPP.BasePlugin
{
public override void Load()
{
InteractiveValue.RegisterIValueType<InteractiveSomething>();
}
}