![\"ModernConfig](\"https:\/\/raw.githubusercontent.com\/QWERTZexe\/ModernConfig\/refs\/heads\/main\/src\/main\/resources\/assets\/modernconfig\/icon.png\"){kind=icon}
<\/p>\n**A beautiful, modern configuration library for Minecraft mods**<\/p>\n
\n
\n
\n<\/p>\n<\/div>\n
## \ud83c\udf1f Overview<\/p>\n
ModernConfig is a sleek configuration library for Minecraft Fabric mods that makes managing settings easy. No more config commands – ModernConfig has animations, a modern style, and its really easy to implement in your mods.<\/p>\n
## \u2728 Features<\/p>\n
<\/p>\n
### \ud83e\udde9 **Configuration Options**
\n– **\ud83d\udd18 Toggles**: Boolean switches – on or off
\n– **\ud83d\udcdd Text Fields**: String inputs
\n– **\ud83c\udf9a\ufe0f Sliders**: Numeric inputs with customizable ranges and precision
\n– **\ud83d\udccb Lists**: Dynamic string lists with add\/remove functionality
\n– **\ud83c\udfa8 Color Pickers**: HSV color selection with hex input support
\n– **\ud83d\udccb Dropdowns**: Selection menus
\n– **\ud83d\udcc1 Categories**: Organized sections with nested configurations<\/p>\n
### \ud83d\ude80 **Easy to Develop with**
\n– **Simple API**: Easy to use Builder
\n– **Listeners for config updates**: Register a listener to fire when the config changes<\/p>\n
### \ud83d\udd27 **Other Features**
\n– **Global Config Screen**: One place to access all mods configs
\n– **Integrated Keybind**: Right Shift opens the config (configurable)
\n– **Performance Optimized**: Non FPS draining animations<\/p>\n
## \ud83d\udcf8 Screenshots<\/p>\n
### Main Interface
\n
\n*Main interface with animations and modern design*<\/p>\n
### Configuration Options
\n
\n*Rich variety of input types: toggles, sliders, text fields, and more*<\/p>\n
### Color Picker
\n
\n*HSV color picker with real-time preview*<\/p>\n
## \ud83d\ude80 Installation<\/p>\n
### For Players<\/p>\n
1. **Download and Install Fabric**
\n – Get Fabric Loader
\n – Install Fabric API<\/p>\n
2. **Download ModernConfig**
\n – Download from Modrinth<\/p>\n
3. **Install the Mod**
\n – Place the `.jar` file in your `mods` folder
\n – Launch Minecraft with the Fabric profile<\/p>\n
### For Developers<\/p>\n
Add ModernConfig to your `build.gradle`:<\/p>\n
“`gradle
\nrepositories {
\n maven {
\n name = ‘QWERTZ-Repo’
\n url = ‘https:\/\/repo.qwertz.app\/’
\n }
\n}<\/p>\n
dependencies {
\n modImplementation ‘app.qwertz:modernconfig:1.3’
\n}
\n“`<\/p>\n
## \ud83c\udfae Usage<\/p>\n
### Opening the Configuration<\/p>\n
– **In-Game**: Press `Right Shift` (you can change this keybind)<\/p>\n
### Navigation<\/p>\n
– **Main Screen**: Shows all mods that use ModernConfig
\n– **Click a Mod**: Opens that mod’s settings
\n– **Back Button**: Goes back to the previous screen<\/p>\n
## \ud83d\udd27 Developer Guide<\/p>\n
### Quick Start<\/p>\n
Here is how easy it is to set up a config:<\/p>\n
“`java
\npublic class YourMod implements ClientModInitializer {<\/p>\n
@Override
\n public void onInitializeClient() {
\n ModernConfig config = ConfigBuilder.create(“YourMod”, “Your Mod Configuration”)
\n .toggle(“enabled”, “Enable Mod”, true)
\n .slider(“power”, “Power Level”, 50, 0, 100, 1)
\n .text(“username”, “Player Name”, “Steve”)
\n .color(“theme_color”, “Theme Color”, 0x4A90E2)
\n .list(“whitelist”, “Player Whitelist”, “Player Name”)
\n .dropdown(“difficulty”, “Difficulty”, Arrays.asList(“Easy”, “Normal”, “Hard”), “Normal”)
\n .build();
\n }
\n}
\n“`<\/p>\n
### Using Categories<\/p>\n
When you have lots of settings, organize them into categories:<\/p>\n
“`java
\nModernConfig config = ConfigBuilder.create(“AdvancedMod”, “Advanced Mod Settings”)
\n .category(“general”, “General Settings”, “Main configuration options”, category -> category
\n .toggle(“enabled”, “Enable Mod”, true)
\n .slider(“update_interval”, “Update Interval”, 20, 1, 100, 1)
\n .text(“server_url”, “Server URL”, “https:\/\/api.example.com”)
\n )
\n .category(“ui”, “User Interface”, “Customize the user interface”, category -> category
\n .color(“primary_color”, “Primary Color”, 0x4A90E2)
\n .color(“secondary_color”, “Secondary Color”, 0x2ECC71)
\n .dropdown(“theme”, “Theme”, Arrays.asList(“Dark”, “Light”, “Auto”), “Dark”)
\n .slider(“ui_scale”, “UI Scale”, 1.0f, 0.5f, 2.0f, 0.1f)
\n )
\n .category(“advanced”, “Advanced Settings”, “Advanced configuration options”, category -> category
\n .toggle(“debug_mode”, “Debug Mode”, false)
\n .list(“blocked_items”, “Blocked Items”, “Item ID”)
\n .list(“whitelist”, “Whitelisted Servers”, “IP”)
\n .text(“api_key”, “API Key”, “”)
\n )
\n .build();
\n“`<\/p>\n
### Accessing Configuration Values<\/p>\n
“`java
\n\/\/ Get configuration options by category path
\nConfigOption enabledOption = config.getOption(“general”, “enabled”);
\nConfigOption updateOption = config.getOption(“general”, “update_interval”);
\nConfigOption whitelistOption = config.getOption(“advanced”, “whitelist”);<\/p>\n
\/\/ Get the actual values ## \ud83c\udfa8 Configuration Options<\/p>\n ### Toggle (Boolean) ### Text Field (String) ### Slider (Numeric) ### Color Picker (Integer) ### List (String Array) ### Dropdown (String Selection) ### Categories (Organization) ## \ud83e\udd1d Contributing 1. Fork the repository ## \ud83d\ude4f Credits<\/p>\n ### Development Team ## \ud83d\udcde Support<\/p>\n – **Discord**: Join our server<\/p>\n ## \ud83c\udf1f Star History<\/p>\n <\/p>\n —<\/p>\n **Made with \u2764\ufe0f and many tears \ud83e\udd72**<\/p>\n [\u2b06 Back to Top](#modernconfig)<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":" ModernConfig is a Configuration Library for Modern Fabric Mods<\/p>\n","protected":false},"featured_media":104372,"template":"","meta":{"_minecraft_slug":"modernconfig","_minecraft_project_id":"vkjAUQHO","_minecraft_author":"QWERTZexe","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":20359,"_minecraft_follows":1,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"modernconfig.zip","_minecraft_size_bytes":2730159,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-16T23:32:30.434433Z","_minecraft_date_created":"2025-07-19T01:20:09.735606Z","_minecraft_date_modified":"2026-03-24T21:35:14.818157Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/modernconfig","_minecraft_icon_attachment_id":104372,"_minecraft_imported_at":"2026-06-06T00:15:35+00:00","_minecraft_import_hash":"9781dd74542fb195a6d5c812dbe08b4e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,873,126,92],"mod_loader":[99],"minecraft_version":[40,41,79,80,81,82,83,167,163],"class_list":["post-104371","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-library","mod_category-management","mod_category-utility","mod_loader-fabric","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\nboolean isEnabled = (Boolean) enabledOption.getValue();
\nint updateInterval = (Integer) updateOption.getValue();
\nList
\n“`<\/p>\n
\n“`java
\n.toggle(“toggle_id”, “Display Name”, defaultValue)
\n“`
\n– **Purpose**: On\/off switches
\n– **Examples**: Feature flags, enable\/disable options<\/p>\n
\n“`java
\n.text(“text_id”, “Display Name”, “default_value”)
\n.text(“text_id”, “Display Name”, “default_value”, maxLength)
\n“`
\n– **Purpose**: Text input fields
\n– **Examples**: Player names, server URLs, file paths, API keys<\/p>\n
\n“`java
\n.slider(“slider_id”, “Display Name”, defaultValue, minValue, maxValue, step)
\n“`
\n– **Purpose**: Numeric input with range constraints
\n– **Examples**: Percentages, scales, intervals, counts, delays<\/p>\n
\n“`java
\n.color(“color_option_id”, “Display Name”, 0xRRGGBB)
\n“`
\n– **Purpose**: Color selection with color picker
\n– **Examples**: Theme colors, highlighting, UI customization<\/p>\n
\n“`java
\n.list(“list_id”, “Display Name”, “Item Display Name”)
\n“`
\n– **Purpose**: Lists of text entries
\n– **Examples**: Player whitelists, blocked items, keywords<\/p>\n
\n“`java
\n.dropdown(“dropdown_id”, “Display Name”, Arrays.asList(“Option1”, “Option2”), “Default”)
\n“`
\n– **Purpose**: Pick one option from a list
\n– **Examples**: Difficulty levels, themes, render modes, language selection<\/p>\n
\n“`java
\n.category(“category_id”, “Category Name”, “Description”, category -> category
\n \/\/ Add options here
\n)
\n“`
\n– **Purpose**: Organize related options
\n– **Examples**: Group related settings logically<\/p>\n
\n### Pull Request Process<\/p>\n
\n3. Make your changes
\n4. Test it
\n5. Submit a pull request<\/p>\n
\n– **QWERTZ** – *Lead Developer* – @QWERTZexe<\/p>\n