# 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](https://modrinth.com/mod/cloth-config)**: **It's stale.** The developer of cloth has clarified that they are likely not going to add any more features.
- **[SpruceUI](https://github.com/LambdAurora/SpruceUI)**: **It isn't designed for configuration.** The design feels cluttered.
- **[OwoLib](https://modrinth.com/mod/owo-lib)**: **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](https://modrinth.com/mod/sodium) 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](https://github.com/isXander/YetAnotherConfigLib/wiki/Usage) contains a full documentation on how to use YACL.

## Screenshots

## License

This mod is under the [GNU Lesser General Public License, v3.0](https://orcalauncher.com/mods/LICENSE).

## 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](https://cdn.modrinth.com/data/1eAoo2KR/versions/xLcBtLUV/yet_another_config_lib_v3-3.8.2%2B26.1.0-fabric.jar)

Minecraft: 26.1-snapshot-2

Loaders: fabric

## Links

[View Source](https://github.com/isXander/YetAnotherConfigLib) [Modrinth](https://modrinth.com/mod/mr-yacl)

## Tags

fabricforgeneoforgequilt1.21.71.21.81.21.91.21.101.21.11