NarutoUI

NarutoUI

一个用于Minecraft客户端模组的现代化UI配置界面库。

NarutoUI

由 Kasualix 与 DeepSeek-V4.1-Flash-1017 开发的、面向 Minecraft 客户端模组的现代 UI 配置界面库。

NarutoUI 不是内容模组。它是一个客户端 UI 库,基于 Modern UI 为模组开发者提供完整的配置界面骨架。你只需声明页面、分区和字段;NarutoUI 负责处理布局、导航栏、卡片、行、分隔线、主题、背景、本地化、微光效果、文件/颜色选择器和图像裁剪。

功能特性

  • 声明式页面 / 分区 / 字段 DSL
  • 可滚动、居中、限宽的页面
  • 自动生成的分区卡片、行布局与分隔线
  • 开关、滑块、值行、按钮、文本及自定义字段
  • 可配置的主题、圆角、间距与内容宽度
  • 透明、黑色、纯色、单图及幻灯片背景
  • 可直接将翻译键用作标签
  • 独立的微光系统,支持按界面配置档案
  • 颜色选择器浮层、图像裁剪浮层、原生文件/文件夹选择器
  • 按界面配置控件工厂与微光档案
  • 进程内界面恢复与稳定的配方注册

NarutoUI 是一个 UI 库。它不保存配置。字段回调仅修改你的配置对象;持久化由调用方负责。

快速开始

Screen screen = MuiSettingsScreen.builder("Example Mod")
        .subtitle("Client settings")
        .page("General", page -> page
                .section("Rendering", section -> section
                        .toggle("Enable HUD",
                                MyConfig::enabled,
                                MyConfig::setEnabled)
                        .slider("Scale", 50, 200,
                                MyConfig::scale,
                                MyConfig::setScale,
                                value -> value + "%")))
        .create(parent);

页面标题、卡片、字段行、分隔线及控件样式均由该 API 生成。

环境要求

  • Modern UI 是硬性依赖。
  • 仅限客户端。 无法在专用服务器上创建配置界面。

文档

完整的 README 与详细的 API 教程可在 GitHub 仓库根目录获取:

https://github.com/Kasualix/NarutoUI

教程涵盖高层 DSL、底层组合、主题、背景、本地化、微光、选择器、界面恢复及常见限制。