YetAnotherConfigLib (YACL)

A builder-based configuration library for Minecraft!

72.5M downloads

Created Apr 9, 2026

by isxander

About

YetAnotherConfigLib

Yet Another Config Lib, like, what were you expecting?

Why does this mod even exist?

This mod was made to fill a hole in this area of Fabric modding. The existing main config libraries don't achieve what I want from them:

  • Cloth Config API: It's stale. The developer of cloth has clarified that they are likely not going to add any more features.
  • SpruceUI: It isn't designed for configuration. The design feels cluttered.
  • OwoLib: It's content focused. Adds to the size with other features.

As you can see, there's sadly a drawback with all of them and this is where YetAnotherConfigLib comes in.

How is YACL better?

YACL has the favour of hindsight. While developing this fresh library, I can make sure that it does everything right:

  • Easy API. YACL takes inspiration from Sodium's internal configuration library.
  • It's styled to fit in Minecraft. YACL's GUI is designed to fit right in.

Features

YACL has a ton of configuration features:

  • Custom control widgets
    • Create your own unique "controller" if the default set does not suit your needs
  • Rich descriptions
    • Clickable & hoverable text, powered by vanilla's Text component system
    • WebP (including animated) image previews
    • Custom rich-renderable section to replace image
  • Multiple controllers for the same type:
    • Sliders or fields for numbers
    • Dropdowns, cyclers, or raw text fields for strings
    • Tickboxes or ON/OFF text display for booleans
    • ...and more!
  • Fully-featured color picker
  • Accessible with full compatibility for keyboard control (optimised for Controlify usage)
  • High organisation with tabs (categories) and collapsable groups
  • Built-in serialization/deserialization techniques so you can skip the error-prone config code
  • Full alternative Kotlin DSL

Usage

The wiki contains a full documentation on how to use YACL.

Screenshots

License

This mod is under the GNU Lesser General Public License, v3.0.

Versions

v3.8.2+26.1.0-fabricLatest

26.1-snapshot-2•fabric•Jan 9, 2026

3.8.2 targets

Fabric NeoForge Forge
26.1 (Snapshots) ✅ ❌ ❌
1.21.11 ✅ ✅ ❌
1.21.10 ✅ ✅ ❌
1.21.9 ✅ 1.21.10 ✅ 1.21.10 ❌
1.21.8 ✅ 1.21.6 ✅ 1.21.6 ❌
1.21.7 ✅ 1.21.6 ✅ 1.21.6 ❌
1.21.6 ✅ ✅ ❌
1.21.5 ✅ ✅ ❌
1.21.4 ✅ ✅ ❌
1.21.3 ✅ ✅ ❌
1.21.2 ✅ 1.21.3 ✅ 1.21.3 ❌
1.21.1 ✅ ✅ ❌
1.20.6 ❌ ❌ ❌
1.20.4 ❌ ❌ ❌
1.20.1 ❌ ❌ ❌

Changes

  • Add targets for 26.1 snapshots.
  • Remove some excessive validation from search field.

Download

Download v3.8.2+26.1.0-fabric

Minecraft: 26.1-snapshot-2

Loaders: fabric

Links

View Source Modrinth

Tags

fabricforgeneoforgequilt1.21.71.21.81.21.91.21.101.21.11