Config Overhauled

By
JohnSmith474

A powerful config library for lazy mod developers.

Banner

Tired of wrestling with boilerplate code just to add a single config toggle? Config Overhauled is a next-generation, schema-driven configuration framework built to make modding fun again.

Discover how Config Overhauled eliminates the grunt work of config management, network syncing, and GUI building so you can focus on making your mod great.

Developer Tools

Zero-Boilerplate Developer Tools

Say goodbye to mapping properties manually, writing verbose JSON parsers, and wiring up bloated registries. Config Overhauled uses a sleek, fluent interface builder that lets you construct properties in one continuous, intuitive chain.

Whether you need a simple boolean, a bounded double, an RGB color integer, a list of strings, or direct references to Items and Blocks, the framework provides an arsenal of pre-defined types ready to deploy.

To speed up your workflow even further, the framework completely automates the tedious peripheries of modding:

Instant Localization: Stop hunting for translation keys. Run /config_lang_gen <mod_id> in-game to instantly generate a complete language file template for all your defined categories, groups, properties, and even tooltips.
Diagnostics on Demand: Need to debug? Use the /config_dump <mod_id> command to export a pristine JSON snapshot of your active configuration state.

User Interface

Auto-Generated, Vanilla-Aligned GUI

Building config screens is notoriously tedious. So we automated it.

Config Overhauled reads your property chains and dynamically generates a beautiful, Vanilla-aligned GUI - without requiring a single line of frontend code from you.

It provides rich, interactive widgets out of the box. Color properties get dedicated hex boxes with visual color previews, bounded numbers enforce regex validation, and Item/Block configurations spawn beautiful, searchable registry selection screens. It even supports real-time exposition of Data-Pack values, allowing players to manipulate complex data directly through the UI.

Network Sync

True Multiplayer Harmony

A beautiful interface relies on the client and server perfectly agreeing on the underlying data. Rather than writing custom network packets and manual synchronization routines, you can rely on automatic state reconciliation.

Config Overhauled silently bridges the host and the client:

Live Remote Editing: Authorized server admins can edit the live server configuration directly from their local client GUI. The client dispatches a secure update request, the server mutates the state, and seamlessly broadcasts the sync to everyone online.
Client State Preservation: When a player joins a multiplayer server, their local personal config is safely archived and replaced with the server's authoritative settings. The moment they disconnect, their custom local settings are flawlessly restored.

System Config

Strict System Scoping

To manage this automated synchronization effectively, a robust library needs clear rules. Not all data is created equal. Config Overhauled enforces strict execution boundaries, classifying every property into one of three scopes:

CLIENT: Isolated, local execution for visual settings or client-side UI toggles. Rejects server overrides.
GLOBAL: Universal behavior that applies universally across the environment instance. The server assumes control and synchronizes these properties to all connected clients. Client state is restored upon ending the session.
LEVEL: World-specific data strictly bound to the active save file. The server holds total authority and strictly synchronizes these properties to all connected clients.

Because the framework inherently understands these scopes, it routes the data intelligently. It knows that a client-side visual toggle requires entirely different network handling than a world-specific dynamic datapack parameter.

Acknowledgements This project contains or relies on third-party software components.

NightConfig

Author: TheElectronWill
Source: https://github.com/TheElectronWill/night-config
License: GNU Lesser General Public License v3.0 (LGPL-3.0)
Modifications: None

This project bundles NightConfig. Under the terms of the LGPL-3.0, the complete GNU GPL and GNU LGPL license texts are distributed alongside this software.