
真正惊人的配置屏幕
一个用于Fabric和NeoForge模组的设置界面库:标签页、可折叠分区、平滑滚动以及一张用图片解释每项设置的卡片。
![]()
一个玩家真正乐意使用的 Fabric 或 NeoForge 模组设置界面。
只需描述一次你的设置,就能获得标签页、平滑滚动,以及一张展示每项设置作用的卡片。

✨ 特性
- 标签页与分区:标签页宽度随标题而定(数量多时会滚动),子分区可以折叠。
- 预览卡片:将指针悬停在某项设置上,即可看到它的名称、描述以及改变效果的图片。在窄窗口中,描述会变为提示框。
- 各种类型的行:开关、带单位或步进的滑块、带箭头的选项、用于一个设置各个部分的复选框、带可搜索列表的开关、可打开你自己窗口的按钮。
- 处处平滑:无阶梯滚动、行在边缘淡出、每个被更改的设置旁都有重置图标。
- 你的外观:直角或圆角、自定义颜色和背景,在任何屏幕上保持可读尺寸。
- 为他人留出空间:一个标签页,其他模组可以在其中添加自己的设置。
- 在 Mod Menu 和 NeoForge 的模组列表中内置设置按钮,已为你配置好。
📥 安装
| Minecraft | 加载器 | 你还需要 |
|---|---|---|
| 1.21.1, 26.1.2, 26.2, 26.3 | Fabric | 无(不需要 Fabric API) |
| 1.21.1, 26.1.2, 26.2, 26.3 | NeoForge | 无 |
将它与你需要它的模组一起安装,例如 Teyvat Cartographia:把适用于你的游戏和加载器的文件放入 mods/(Prism Launcher、Modrinth App 和 CurseForge App 会随此类模组自动提供它)。模组也可能将它内置在自己的文件中;那样你无需安装任何东西。它仅在客户端生效。
🔌 Sinytra Connector
在 NeoForge 上,请使用 NeoForge 文件。Fabric 文件也可以通过 Sinytra Connector 配合 Forgified Fabric API 运行(已在 1.21.1、26.1.2 和 26.2 上用 Teyvat Cartographia 验证);Connector Extras 会将设置按钮添加到 NeoForge 的模组列表中。
🛠️ 面向模组作者
将它嵌入你的 JAR 中,这样你的玩家无需安装任何东西。它位于 Modrinth Maven:
repositories { maven { url = 'https://api.modrinth.com/maven' } }dependencies {
// Fabric(在 26.x 上:使用 implementation 代替 modImplementation)
include(modImplementation('maven.modrinth:actually-amazing-config-screen:1.4.1+mc1.21.1-fabric'))
// NeoForge
jarJar(implementation('maven.modrinth:actually-amazing-config-screen:1.4.1+mc1.21.1-neoforge'))
}
或者省略 include 和 jarJar,将模组 aacs 作为必需依赖引入,就像 Teyvat Cartographia 自 1.4.0 起所做的那样:你的玩家将它与其模组一起安装,并立即获得它的每个更新版本。
先描述设置,再描述界面:
ConfigFile.Builder b = ConfigFile.builder();
BoolValue grid = b.bool("grid", true);
IntValue opacity = b.integer("opacity", 80, 0, 100);
ConfigFile file = b.build();
file.load(configDir.resolve("mymod-client.json"));AacsScreen screen = AacsScreen.builder("mymod", file)
.tab("mymod.config.tab.display", t -> t
.toggle(grid)
.slider(opacity, s -> s.unit("%")))
.build();
Minecraft.getInstance().setScreen(screen.open(parent));
名称和描述来自你的语言文件(mymod.config.<key> 和 mymod.config.<key>.tooltip)。
❓ 常见问题
为什么我从未安装它,它却出现在我的模组列表中?
你玩的某个模组需要它,或者将它内置在了自己的文件中。该模组的设置按钮会打开它的界面。
我的两个模组带有不同版本。这会有问题吗?
不会。加载器会保留最新的副本,并且 net.tapacywka.aacs.api 中的 API 自 1.0.0 起保持稳定:它只会增加内容,旧的调用仍然可用。
🔗 链接
- 报告错误或提出想法(请附上
logs/latest.log) - 更新日志
- 源代码:
./gradlew build(1.21.1 使用分支main,26.x 使用mc26);./gradlew :fabric:runClient会打开一个包含各种类型行的测试模组
MIT 许可证。图标来自 Nieobie 的 Game Icon Pack(CC0)。为 Teyvat Cartographia 制作,任何模组均可免费使用。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。