Back to mods
YetAnotherConfigEnhancement (YACE) project artwork

Modrinth · Minecraft mod

YetAnotherConfigEnhancement (YACE)

Library for YACL which adds new ways to customize a config menu for developers

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which YetAnotherConfigEnhancement (YACE) release should I use?

Updated yesterday
Latest stable file 1.0.1
Game version 1.21.1, 1.21
Loader Fabric, Quilt

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.

Client Required
Dedicated server Not supported
Loader for this release Fabric, Quilt
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

All 2 required mods have matching files

Install YetAnotherConfigLib (YACL), Fabric API first. We found matching files for this game-version and loader setup.

YetAnotherConfigLib (YACL) Needed by YetAnotherConfigEnhancement (YACE) 1.0.1
required
Matching file found Matched file: 3.8.2+1.21.1-fabric
Fabric API Needed by YetAnotherConfigEnhancement (YACE) 1.0.1
required
Matching file found Matched file: 0.116.18+1.21.1

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.

  1. 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.

  2. 02

    Bring the mods it needs

    Install YetAnotherConfigLib (YACL), Fabric API first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    It must be installed on the client. Do not install it on the dedicated server.

  4. 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.

icons

.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.

.centeredWithoutName()

.tickCrossFormatter()

Constructor options

.tickCrossFormatter()

What does it do?

Replaces true or false with ✔ and ❌

tickCrossFormatter false
tickCrossFormatter true

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:

Fneifnox's Mods 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.

4 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

YetAnotherConfigEnhancement (YACE) versions and loaders

2 of 2 releases match

Looking for an older file? The official Modrinth project page is in Resources.