YetAnotherConfigLib 3.1.0 for 1.19.4
API Changes
ListOption
changes
A PR by Crendgrim - thanks a lot!
- Allow to specify size limits for option lists.
- This allows to set a minimum and maximum length for the option list with the
minimumNumberOfEntries
andmaximumNumberOfEntries
builder methods.
- This allows to set a minimum and maximum length for the option list with the
- Allow "reversed" lists that add new options at their end.
- List options until now always grew at the top. This patch allows you to manipulate this behaviour with the
insertEntriesAtEnd
builder method.
- List options until now always grew at the top. This patch allows you to manipulate this behaviour with the
ImageRenderer
changes
Added a tick()
method to image renderers that allows to update the image in a regular interval.
Bug Fixes
- Fixed a bug where image renderers were rendered twice per frame.
- Updated the ImageIO dependency to fix sometimes buggy animated WebP rendering.
- Fixed the name of the list being rendered on every entry of said list.
Language Updates
- Added Tatar translation (by Amirhan-Taipovjan-Greatest-I)
YetAnotherConfigLib v3
3.0 of YACL introduces a new UI layout, taking advantage of 1.19.4's new tab system!
Description Panel
The description panel takes the place of the old category buttons, you can now interact with the text by clicking or hovering and the description can contain an animated WebP file or a static image. This can help you as a developer to portray what your option does with an actual example. Like the old tooltip system, these descriptions can dynamically change based on the value of the option, including the image. After a few seconds of hovering, the description will start to auto-scroll if necessary so inputs such as controller can still use the UI.
.description(OptionDescription.createBuilder()
.text(Text.literal("Line 1"))
.text(Text.literal("Line 2"))
.webpImage(new Identifier("mymod", "config/screenshots/config_example.webp"))
.build())
the above is applicable to both groups and options
Tab System
YACL now uses a slightly modified version of 1.19.4's new create world screen, this adds tab overflow, so you can scroll through the tabs in case there are too many to fit on the screen.
Controller Builders
Controllers now use a builder system, rather than using constructors. This allows for more flexibility in the future.
You can still use your own controller implementations without creating a builder, using .customController()
.
For mod developers...
This update is for both 1.19.4 and 1.20, there is complete API parity. 1.20 is now the active branch, and 1.19.4 is now considered LTS and may receive features from 1.20 at a later date.
For users/modpack developers...
YACL 3.0 includes the old 2.x inside the new JAR. So you can safely upgrade to 3.0 without breaking mods that have not yet updated. However, the old UI will still be present for this outdated mods.
YetAnotherConfigLib 3.0.0-beta.2+1.19.4
This version adds no features, nor bug fixes, instead it implements a breaking change:
The YACL package has changed to dev.isxander.yacl3
and the YACL mod-id has changed to yet_another_config_lib_v3
.
This is to prevent conflicts with 2.0, so you can load both versions at the same time so older mods don't break.