KonfyLib
Elegant config library for Fabric Minecraft mods. Type-safe, JSON-backed, animated GUI with zero boilerplate.
Features
- Zero boilerplate — one interface, full config GUI
- 10+ widget types — toggles, sliders, text, enums, colors, pixel grids, keybinds
- Animated colors — rainbow and pulse on color pickers
- Fuzzy search — typo-tolerant option search
- ModMenu integration — automatic out of the box
- JSON serialization — pretty-printed with custom type adapters
- Extension system — custom widgets and types via addon API
Showcase
| Mods Hub | Config Widgets |
|---|---|
 |
 |
| Color Picker | Popups |
 |
 |
Quick Start
// 1. Entrypoint
public class MyModEntrypoint implements KonfyLibApi {
@Override
public ModConfig getConfig() { return MyModConfig.create(); }
}
// 2. Config
Option<Boolean> toggle = BooleanOption.createBuilder(
"Enable Feature", () -> enabled, true, val -> enabled = val
).build();
OptionGroup group = OptionGroup.createBuilder("General").addOption(toggle).build();
Category cat = new Category("My Mod", List.of(group), List.of());
return new ModConfig(Paths.get("config/mymod.json"), List.of(cat), () -> {});
// 3. fabric.mod.json
{ "entrypoints": { "konfy": ["com.example.MyModEntrypoint"] } }
Example
See example/ for a working mod demonstrating all widget types.
Install
Download the latest jar from Releases and add it to your mods/ folder.
Ownership
Fork of WalksyLib, redesigned for elegance.
