OneConfig
by Polyfrost
OneConfig is a configuration library that gives mod developers a config API and gives players a single screen for the settings of every mod built on it.
What it does
Mods that use the library expose their options through one shared settings screen, so players change settings without opening separate menus for each mod. Developers call the config API instead of building their own settings interface. Profiles keep a separate copy of mod settings, and a HUD editor moves, scales and restyles the HUD elements of supporting mods.
OneConfig requires Compose Multiplatform and Fabric Language Kotlin. On Fabric it also needs Fabric API, and on Ornithe it needs OSL, the Ornithe Standard Libraries. Builds cover Minecraft 1.8.9 on Ornithe and 1.21.1 – 26.3 on Fabric, with 66 other mods requiring the library. It is installed on the player's side alone, so servers need nothing.
Key features
Shared settings screen
Options from every supporting mod appear in one place, so players do not have to hunt through separate menus.
HUD editor
Positions, scale and style of HUD elements from supporting mods can be adjusted from one editor.
Profiles
Each profile keeps its own copy of mod settings, so one setup can be swapped for another.
Developer settings integration
Mod authors add their options to the shared screen through the library's API instead of building a settings interface.
Gallery
Compatibility
Latest build for each game version and loader.
26.x5 of 5 versions with builds
1.21.x6 of 6 versions with builds
1.12.x1 of 1 version with builds
1.8.x1 of 1 version with builds
This mod also publishes snapshot builds. Snapshots are not shown in the matrix.
Requirements
Dependencies declared by the latest file for each loader.
Required 3
Required by 66 mods
Use cases
Players using several config-driven mods
A player with many mods that support OneConfig adjusts all of them from a single screen instead of separate menus.
Mod developers
Developers who want a consistent settings screen for their mods can build on the library's API.
Who it’s for: Players who run HUD and quality-of-life mods that support the library, and mod developers who want a shared settings interface. Players on servers do not need to install it, since it is client-side only.
Questions
Does OneConfig need Fabric API?
Which loader should be used for OneConfig?
Is OneConfig under a custom license?
In the catalog
OneConfig is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 8,071 mods support Minecraft 26.3.
More from Polyfrost
Similar mods
What the author says
OneConfig is a free, open source configuration library by Polyfrost. It gives developers a config API, and it gives players one screen where they change the settings of every mod that uses it. OneConfig needs Compose Multiplatform and Fabric Language Kotlin. It also needs Fabric API on Fabric and OSL on Ornithe.
Official listing
- Modrinth page
- modrinth.com/mod/oneconfig
- Owner
- Polyfrost
- Published
- 2022-11-17
- Updated on Modrinth
- 2026-10-14
- Facts verified
- 2026-10-15