真正惊人的配置屏幕

真正惊人的配置屏幕

一个用于Fabric和NeoForge模组的设置界面库:标签页、可折叠分区、平滑滚动以及一张用图片解释每项设置的卡片。

Actually Amazing Config Screen

Modrinth 下载量 CurseForge 下载量 GitHub 下载量 客户端 MIT 许可证

一个玩家真正乐意使用的 Fabric 或 NeoForge 模组设置界面。
只需描述一次你的设置,就能获得标签页、平滑滚动,以及一张展示每项设置作用的卡片。

可在 Modrinth 获取 可在 CurseForge 获取 可在 GitHub 获取

带有标签页、多行复选框以及显示指针所指设置卡片的设置界面

✨ 特性

  • 标签页与分区:标签页宽度随标题而定(数量多时会滚动),子分区可以折叠。
  • 预览卡片:将指针悬停在某项设置上,即可看到它的名称、描述以及改变效果的图片。在窄窗口中,描述会变为提示框。
  • 各种类型的行:开关、带单位或步进的滑块、带箭头的选项、用于一个设置各个部分的复选框、带可搜索列表的开关、可打开你自己窗口的按钮。
  • 处处平滑:无阶梯滚动、行在边缘淡出、每个被更改的设置旁都有重置图标。
  • 你的外观:直角或圆角、自定义颜色和背景,在任何屏幕上保持可读尺寸。
  • 为他人留出空间:一个标签页,其他模组可以在其中添加自己的设置。
  • 在 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 起保持稳定:它只会增加内容,旧的调用仍然可用。

🔗 链接

MIT 许可证。图标来自 Nieobie 的 Game Icon Pack(CC0)。为 Teyvat Cartographia 制作,任何模组均可免费使用。