YetAnotherConfigEnhancement (YACE)

模组

· 作者 Fneifnox

YACL 的库,为开发者提供自定义配置菜单的新方式

0 本站下载 0 关注 更新于 3 天前

需要前置:另一个配置库 (YACL)、Fabric API

最新 1.0.1 · 1.21.1 · Fabric / Quilt

一键开服(送7天)

此模组提供了新的方式来进一步自定义 yacl 配置菜单。它主要面向希望在自己的模组中使用这些增强功能的开发者。

1.20-26.3 版本的移植版本即将推出

功能概览

  • 组件和选项组的图标(物品、3D 实体、状态效果、标识符路径)
  • 通过滚动调整数值
  • 居中选项值
  • BooleanController 的新 tickCrossFormatter
  • 新的 YaceStringSelectionDropdownController

它是如何工作的?

开始使用

将此模组的最新版本添加到你的 build.gradle 中。你可以点击 Modrinth 上的特定版本并向下滚动到开发者代码部分来了解具体操作。

迁移到新构建器

每个控制器都有一个新增类以添加这些新功能。要使用它们,只需将你的模组菜单集成中原有的 yacl 构建器类替换为此模组的构建器类即可。除了添加 Yace 前缀外,每个 Builder 的名称都与原来完全相同。以下是一个示例:

- .controller(opt -> DoubleFieldControllerBuilder.create(opt))
+ .controller(opt -> YaceDoubleFieldControllerBuilder.create(opt))

使用这些功能

你现在可以通过在构建器方法链中添加这些功能来简单地使用所有新功能,就像在 yacl 中一样。以下是一个示例:

.controller(opt -> YaceDoubleFieldControllerBuilder.create(opt)
        .icon(Items.DIAMOND.getDefaultStack())
        .adjustableByScrolling(0.01)
        .min(0.0)
        .max(Double.MAX_VALUE))

详细描述

以下是每个新功能的详细描述(附带图片)

.icon()

构造函数选项

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

它的作用是什么?

允许你在控制器组件/选项组名称的左侧添加视觉图标。你可以将图标纹理设置为物品、3D 实体模型、状态效果或使用 identifierIcon 的任何其他纹理。

当使用 3D 实体模型时,请注意它仅在处于世界中时才渲染 3D 实体模型。当在主菜单屏幕上打开菜单时,实体模型将被相应的刷怪蛋替换。

pxWidth 和 pxHeight 控制图标的渲染大小。如果未设置任何值,则默认使用 16x16 的大小。

注意,pxScale 同时影响 3D 实体模型和刷怪蛋图标回退。

textureOffSetX 和 textureOffsetY 在你想要获取精灵表中的特定纹理时非常有用。如果不是这种情况,请将这两个值都设为 0。

icons

.adjustableByScrolling()

构造函数选项

.adjustableByScrolling()
.adjustableByScrolling(double stepSize)

它的作用是什么?

允许你通过滚动来调整数字字段和滑块的数值。Stepsize 控制每次滚动应增加/减少的量。

为了通过滚动调整字段的数值,你必须首先单击该选项组件。对于滑块,你可以直接将鼠标悬停在滑块本身上并调整数值,而无需先单击选项组件。

当未设置 stepsize 时,整数和长整型控制器将使用默认的 1,浮点数和双精度控制器将使用默认的 0.1。

.centeredWithoutName()

构造函数选项

.centeredWithoutName()

它的作用是什么?

允许你居中文本值并移除选项名称。

当通过 .icon() 添加图标时,图标也会被居中。

这仍然非常实验性,因为存在许多可能导致视觉破坏的不同情况。如果你发现任何问题,请报告给我以便修复。

.centeredWithoutName()

.tickCrossFormatter()

构造函数选项

.tickCrossFormatter()

它的作用是什么?

用 ✔ 和 ❌ 替换 true 或 false

tickCrossFormatter false tickCrossFormatter true

YaceStringSelectionDropdownController

它的作用是什么?

此控制器与 DropdownStringController 非常相似。唯一的区别是你不能在其中输入内容。你需要直接从下拉列表中选择一个选项,而无法通过过滤或手动输入来选择。

控制器 / 选项组兼容性表
控制器 / 选项组 .icon() .centeredWithoutName() .adjustableByScrolling() .tickCrossFormatter()
IntegerFieldController ✅ ✅ ✅ ❌
LongFieldController ✅ ✅ ✅ ❌
FloatFieldController ✅ ✅ ✅ ❌
DoubleFieldController ✅ ✅ ✅ ❌
IntegerSliderController ✅ ❌ ✅ ❌
LongSliderController ✅ ❌ ✅ ❌
FloatSliderController ✅ ❌ ✅ ❌
DoubleSliderController ✅ ❌ ✅ ❌
StringController ✅ ✅ ❌ ❌
BooleanController ✅ ❌ ❌ ✅
TickBoxController ✅ ❌ ❌ ❌
ColorController ✅ ❌ ❌ ❌
CyclingListController ✅ ✅ ❌ ❌
DropdownStringController ✅ ✅ ❌ ❌
EnumController ✅ ✅ ❌ ❌
EnumDropdownController ✅ ✅ ❌ ❌
ItemController ✅ ✅ ❌ ❌
YaceStringSelectionDropdownController ✅ ✅ ❌ ❌
OptionGroup ✅ ❌ ❌ ❌

支持

如果您有问题、遇到问题、发现错误或有任何建议,您可以加入我的 Discord 服务器:

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源