Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Tags
Creators
Details
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:



