Dnz配置

Dnz配置

Dnz Hud的Dnz配置库

# DNZ Config

简洁、现代的 Fabric 模组设置界面。只需几行代码即可构建完整的配置菜单,并获得深色玻璃设计风格的开关、滑块、下拉菜单、颜色色块和文本框,在任何 GUI 缩放下外观都保持一致。

DNZ Config 是一个库:单独使用时,它只会在 Mod Menu 中添加一个示例界面。如果你使用的某个模组需要它,请安装它。

面向玩家

  • 平滑的圆角菜单,带有柔和阴影和动画
    - 左侧为页面,右侧为双列设置项
    - 鼠标悬停在设置项上时显示帮助文本
    - 设置会以可读的 JSON 格式保存到 config 文件夹

面向模组开发者

ConfigFile<MySettings> file = ConfigFile.of("mymod", MySettings.class);
MySettings s = file.get();

Screen screen = DnzConfig.builder("My Mod")
    .accent(0x4FA3FF)
    .category("General", page -> {
        page.toggle("Enabled", () -> s.enabled, v -> s.enabled = v).note("Turns the mod on or off");
        page.slider("Size", 0, 100, 5, () -> s.size, v -> s.size = v, v -> v + "%");
        page.choice("Mode", List.of("Simple", "Detailed"), () -> s.mode, v -> s.mode = v);
    })
    .category("Look", page -> {
        page.color("Color", () -> s.color, v -> s.color = v);
        page.text("Label", "Type here", 24, () -> s.label, v -> s.label = v);
    })
    .onSave(file::save)
    .build(parent);

行类型:header、toggle、slider、choice(列表或枚举)、color、text、button,或使用 custom 自定义行。每一行都可以添加 .note(...)、.tooltip(...) 或 .wide()。

ConfigFile 可将任意普通 Java 类保存为 config/<name>.json。新字段会获得其默认值,并且保存时会先写入临时文件,因此崩溃绝不会留下损坏的文件。

你可以将 DNZ Config 嵌套到你的模组 jar 中(jar-in-jar),或要求玩家自行安装它。

详细信息