A simple settings manager library, which implements YACL to easily generate config screens for Mod Menu.<\/p>\n
If you would like to use this mod to generate config menus for your own mod, I recommend contacting me, as I may not keep this page updated as the mod updates.<\/p>\n
**NOTE: This mod does nothing by itself. It is a library for other mods.**<\/big><\/p>\n
# Features:
\n– Easy and quick setup
\n– Easy implementation
\n– Easy access to settings
\n– Built-in config file generation to save settings between client restarts
\n– Built-in chroma manager to sync chroma features across files
\n– Supports nearly all YACL fields<\/p>\n
# Setup:
\n### Add the mod as a dependency:
\nin `build.gradle`
\n“`groovy
\nrepositories {
\n maven { url = “https:\/\/api.modrinth.com\/maven” }
\n maven {
\n name = “Terraformers”
\n url = “https:\/\/maven.terraformersmc.com\/”}
\n maven {
\n name ‘Xander Maven’
\n url ‘https:\/\/maven.isxander.dev\/releases’}
\n}<\/p>\n
dependencies {
\n modImplementation(“maven.modrinth:settingsmanagerlib:${project.modmenu_version}”)
\n modImplementation(“com.terraformersmc:modmenu:${project.modmenu_version}”)
\n modImplementation “dev.isxander:yet-another-config-lib:${project.yacl_version}”
\n}
\n“`
\nin `gradle.properties`
\n“`properties
\nsettingsmanagerlib_version=LATEST_VERSION_NUMBER (e.g. 1.0.0+1.21.11)
\nmodmenu_version=LATEST_VERSION_NUMBER (e.g. 15.0.0)
\nyacl_version=LATEST_VERSION_NUMBER (e.g. 3.7.1+1.21.6-fabric)<\/p>\n
“`
\nin `fabric.mod.json`
\n“`json
\n“entrypoints”: {
\n“modmenu”: [ “com.example.mod.ModMenuAPI” ]
\n}
\n“`
\nThen create a new class `ModMenuAPI`
\n“`java
\npublic class ModMenuAPI implements ModMenuApi {
\n\t @Override
\n\t public ConfigScreenFactory getModConfigScreenFactory() {
\n\t\t\treturn parentScreen -> ExampleModClient.settings.getConfig(parentScreen);
\n\t }
\n}
\n“`<\/p>\n
### Set up the mod:
\nin `ExampleModClient`
\n“`java
\npublic static Settings settings;<\/p>\n
@Override
\npublic void onInitializeClient() {
\n\t settings = new Settings().setup(“Example Mod”, “examplemod”);
\n\t settings.loadFromFile();
\n}
\n“`<\/p>\n
### To add a setting: in `ExampleModClient` \t settings.add(“guiName”, “Visual Settings”, “Overlay”, “Default Gui Name”, “Gui Scale”, “This text will appear as a tooltip when you click on the option.”); in `ExampleModClient` \t settings.add(“guiScale”, “Visual Settings”, “Overlay”, 1.0f, “Gui Scale”, “This text will appear as a tooltip when you click on the option.”, 0.5f, 5.0f, 0.1f); in `ExampleModClient` \t settings.add(“doRenderGui”, “Visual Settings”, “Overlay”, true, “Render Gui”, “This text will appear as a tooltip when you click on the option.”, BooleanFormat.ONOFF); in `ExampleModClient` \t settings.addColor(“guiBackgroundColor”, “Visual Settings”, “Overlay”, net.minecraft.util.Colors.GRAY, “Gui Background Color”, “This text will appear as a tooltip when you click on the option.”); Documentation coming soon. Contact for details Note that the value of settings automatically persist after restarting the client, however, you still need to add them to the config menu, which can be accomplished by creating the config menu inside `onInitializeClient()`<\/p>\n # Accessing Values: ExampleModClient.settings.get(“doRenderGui”, true); \/\/to return a boolean ### Setting the Value of a Setting: ExampleModClient.settings.set(“doRenderGui”, false); \/\/example with a boolean # Pages\/Groups: # Dependencies: A simple, easy-to-set-up config library using YACL and Mod Menu to create simple or complex config menus<\/p>\n","protected":false},"featured_media":137806,"template":"","meta":{"_minecraft_slug":"settingsmanagerlib","_minecraft_project_id":"1dU3bHt8","_minecraft_author":"wildbeast42","_minecraft_license":"LGPL-3.0-only","_minecraft_downloads":45556,"_minecraft_follows":4,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"settingsmanagerlib.zip","_minecraft_size_bytes":594148,"_minecraft_version_count":32,"_minecraft_updated_at":"2026-05-16T10:40:32.397576Z","_minecraft_date_created":"2025-09-16T03:19:56.871281Z","_minecraft_date_modified":"2026-03-26T05:06:32.373874Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/settingsmanagerlib","_minecraft_icon_attachment_id":137806,"_minecraft_imported_at":"2026-06-08T03:36:29+00:00","_minecraft_import_hash":"c118d13b83c28786aeed01a6d61e1438","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,873,90,92],"mod_loader":[99],"minecraft_version":[40,41,74,38,78,79,80,81,82,83],"class_list":["post-137805","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-library","mod_category-optimization","mod_category-utility","mod_loader-fabric","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1"],"yoast_head":"\n
\nNote: supports Strings, Booleans, Integers, Floats, Colors, and custom Enums.<\/p>\nStandard Strings\/Integers\/Floats<\/summary>\n
\n“`java
\n@Override
\npublic void onInitializeClient() {
\n\t settings.add(String settingId, String page, String group, String\/int\/float defaultValue, String settingName, String description)<\/p>\n
\n}
\n“`
\n<\/details>\nInteger\/Float Sliders<\/summary>\n
\n“`java
\n@Override
\npublic void onInitializeClient() {
\n\t settings.addSlider(String settingId, String page, String group, int\/float defaultValue, String settingName, String description, int\/float min, int\/float max, int\/float step)<\/p>\n
\n}
\n“`
\n<\/details>\nBooleans<\/summary>\n
\n“`java
\n@Override
\npublic void onInitializeClient() {
\n\t settings.addSlider(String settingId, String page, String group, boolean defaultValue, String settingName, String description, BooleanFormat valueFormat)<\/p>\n
\n}
\n“`
\n`BooleanFormat` – the displayed value of the boolean:
\n– `BooleanFormat.ONOFF` – “On” or “Off”
\n– `BooleanFormat.TRUEFALSE` – “True” or “False”
\n– `BooleanFormat.YESNO` – “Yes” or “No”
\n– `BooleanFormat.TICKBOX` – A box that is either checked or unchecked
\n<\/details>\nColors<\/summary>\n
\n“`java
\n@Override
\npublic void onInitializeClient() {
\n\t settings.addColor(String settingId, String page, String group, int defaultValue, String settingName, String description)<\/p>\n
\n}
\n“`
\n<\/details>\nCustom Enum<\/summary>\n
\n<\/details>\n
\n### Getting The Value of a Setting:
\nTo get the value of a setting, use the following where typeInstance is a value with the same type as the value of the setting you are getting. Refer to the examples below for implementations. Note that the second parameter of settings.get() is irrelevant; only its type needs to be the same as the return type.
\n“`java
\nExampleModClient.settings.get(“settingId”, typeInstance);<\/p>\n
\nExampleModClient.settings.get(“guiBackgroundColor”, net.minecraft.util.Colors.GRAY); \/\/to return a color
\nExampleModClient.settings.get(“guiScale”, 1.0f); \/\/to return a float
\nExampleModClient.settings.get(“guiName”, “Default Gui Name”); \/\/to return a string
\nExampleModClient.settings.get(“guiSliderMin”, 1); \/\/to return an integer
\n“`<\/p>\n
\nBy default, the value of a setting is set to its default value, unless the user changes it. To manually set the value of a setting, use the following.
\n“`java
\nExampleModClient.settings.set(“settingId”, newValue);<\/p>\n
\n“`<\/p>\n
\nSettings are organized by pages and groups. Refer to the image below for an example. The page is the bar at the top, and you can open one page at a time. A group is a collapsible collection of settings. You can have unlimited groups and unlimited settings on each page. Each setting must have a page, but does not require a group. To create a setting without a group as shown in the image below, set the group to “” or “none”.
\n<\/p>\n
\nThis mod requires multiple other mods in order to function.
\n– YACL
\n– Mod Menu
\n– Fabric API<\/p>\n","protected":false},"excerpt":{"rendered":"