
Modrinth · Minecraft mod
YetAnotherConfigEnhancement (YACE)
Library for YACL which adds new ways to customize a config menu for developers
Quick answer
Which YetAnotherConfigEnhancement (YACE) release should I use?
YetAnotherConfigEnhancement (YACE) 1.0.1 targets 1.21.1, 1.21 with Fabric, Quilt. It must be installed on the client. Do not install it on the dedicated server. All 2 required mods have matching files.
Where it goes
Is YetAnotherConfigEnhancement (YACE) required on the client, server, or both?
It must be installed on the client. Do not install it on the dedicated server.
This file is marked client-only.
What else does YetAnotherConfigEnhancement (YACE) 1.0.1 need?
1.0.1. Change the file and its required mods may change too.
Install YetAnotherConfigLib (YACL), Fabric API first. We found matching files for this game-version and loader setup.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add YetAnotherConfigEnhancement (YACE) without breaking your instance.
Built for YetAnotherConfigEnhancement (YACE) 1.0.1. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 1.0.1. It targets 1.21.1, 1.21 with Fabric, Quilt; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install YetAnotherConfigLib (YACL), Fabric API first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
It must be installed on the client. Do not install it on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside 1.0.1. It opens that exact file at the source.
About this project
What does YetAnotherConfigEnhancement (YACE) add?
This mod adds new ways to further customize a yacl config menu. It is mainly thought for developers wanting to use these enhancements in their own mods.
Ports to versions 1.20-26.3 will be coming soon
Feature Overview
- Widget and option group icons (items, 3d entities, statuseffects, identifier paths)
- Adjusting values by scrolling
- Centering option values
- New tickCrossFormatter for BooleanController
- New YaceStringSelectionDropdownController
How does it work?
Getting started
Add the newest version of this mod to your build.gradle. You can find out how by clicking on the specific version on modrinth and scrolling down to the code section for developers.
Migrating to the new builder
Every controller got a new class that adds these new features. To use them simply replace the original yacl builder class from your mod menu integration with the one of this mod. Every Builder is exactly named the same in addition to the Yace prefix. Here's an example:
- .controller(opt -> DoubleFieldControllerBuilder.create(opt))
+ .controller(opt -> YaceDoubleFieldControllerBuilder.create(opt))
Use the features
You can now simply use all of the features by adding them to your builder method chain just like in yacl. Here's an example:
.controller(opt -> YaceDoubleFieldControllerBuilder.create(opt)
.icon(Items.DIAMOND.getDefaultStack())
.adjustableByScrolling(0.01)
.min(0.0)
.max(Double.MAX_VALUE))
Detailed Description
These are detailed descriptions of each new feature (with images)
.icon()
Constructor options
.icon(Itemstack itemIcon)
.icon(Itemstack itemIcon, int pxWidth, int pxHeight)
.icon(Entitytype<? extends LivingEntity> entityIcon)
.icon(Entitytype<? extends LivingEntity> entityIcon, int pxScale)
.icon(Entitytype<? extends LivingEntity> entityIcon, boolean isBabyEntityIcon)
.icon(Entitytype<? extends LivingEntity> entityIcon, boolean isBabyEntityIcon, int pxScale)
.icon(RegistryEntry<StatusEffect> statusEffectIcon)
.icon(RegistryEntry<StatusEffect> statusEffectIcon, int pxWidth, in pxHeight)
.icon(Identifier identifierIcon)
.icon(Identifier identifierIcon, int pxWidth, int pxHeight, int textureOffsetX, int textureOffsetY)
What does it do?
Lets you add an visual icon left to the name of the controller widget / option group. You can either set the icon texture to an item, a 3d entity model, an status effect or any other texture by using the identifierIcon.
When using the 3d entity model keep in mind that it only renders a 3d entity model while being in a world. When opening the menu on the title screen the entity models will get replaced with their respective spawn eggs.
pxWidth and pxHeight control how big the icon should be rendered. When don't setting it to anything the default of 16x16 will be used for everything.
Note that pxScale affects both the 3d entity model and the spawn egg icon fallback.
textureOffSetX and textureOffsetY are useful when you want to have a specific texture of a sprite sheet. If that isn't the case set both of these values to 0.

.adjustableByScrolling()
Constructor options
.adjustableByScrolling()
.adjustableByScrolling(double stepSize)
What does it do?
Lets you adjust values of number fields and sliders by scrolling. Stepsize controls how much each scroll should increase / decrease.
In order to adjust values by scrolling for fields you have to click on the option widget first. For sliders you can simply hover over the slider itself and adjust the value without clicking the option widget first.
When don't setting stepsize to anything the default of 1 for integer and long controller and the default of 0.1 for float and double controller will be used.
.centeredWithoutName()
Constructor options
.centeredWithoutName()
What does it do?
Lets you center the value text and remove the option name.
When adding an icon by utilising .icon() the icon will be centered as well.
This is still very experimental as there are a lot of different cases that could potentielly visually break things. If you find anything please report it so I can fix it.

.tickCrossFormatter()
Constructor options
.tickCrossFormatter()
What does it do?
Replaces true or false with ✔ and ❌


YaceStringSelectionDropdownController
What does it do?
This controller is really similiar to the DropdownStringController. The only difference being that you can't write into it. You need to directly select an option from the dropdown without being able to filter through them or type them in manually.
Controller / OptionGroup Compatibility Table
| Controller / OptionGroup | .icon() | .centeredWithoutName() | .adjustableByScrolling() | .tickCrossFormatter() |
|---|---|---|---|---|
| IntegerFieldController | ✅ | ✅ | ✅ | ❌ |
| LongFieldController | ✅ | ✅ | ✅ | ❌ |
| FloatFieldController | ✅ | ✅ | ✅ | ❌ |
| DoubleFieldController | ✅ | ✅ | ✅ | ❌ |
| IntegerSliderController | ✅ | ❌ | ✅ | ❌ |
| LongSliderController | ✅ | ❌ | ✅ | ❌ |
| FloatSliderController | ✅ | ❌ | ✅ | ❌ |
| DoubleSliderController | ✅ | ❌ | ✅ | ❌ |
| StringController | ✅ | ✅ | ❌ | ❌ |
| BooleanController | ✅ | ❌ | ❌ | ✅ |
| TickBoxController | ✅ | ❌ | ❌ | ❌ |
| ColorController | ✅ | ❌ | ❌ | ❌ |
| CyclingListController | ✅ | ✅ | ❌ | ❌ |
| DropdownStringController | ✅ | ✅ | ❌ | ❌ |
| EnumController | ✅ | ✅ | ❌ | ❌ |
| EnumDropdownController | ✅ | ✅ | ❌ | ❌ |
| ItemController | ✅ | ✅ | ❌ | ❌ |
| YaceStringSelectionDropdownController | ✅ | ✅ | ❌ | ❌ |
| OptionGroup | ✅ | ❌ | ❌ | ❌ |
Support
If you have questions, encounter problems, find bugs or have suggestions you can join my discord server:
Project description from Modrinth.
Pick your setup
YetAnotherConfigEnhancement (YACE) by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.21.1
2 loader builds1.21
2 loader buildsCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
YetAnotherConfigEnhancement (YACE) versions and loaders
1.0.1
yet-another-config-enhancement-1.21-1.0.1.jar
14 Nov 2026
1.0.0
yet-another-config-enhancement-1.21-1.0.0.jar
12 Nov 2026
Looking for an older file? The official Modrinth project page is in Resources.
