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.