VoxelUI

模组

· 作者 AlexandreGRZ1

适用于 Minecraft NeoForge 的现代 UI 框架,支持 XML 布局、MCSS 样式、可复用组件、主题系统以及开发者工具。

0 本站下载 0 关注 更新于 6 个月前

最新 0.3.0 · 1.21.1 · NeoForge

一键开服(送7天)

VoxelUI

VoxelUI 是一个面向 Minecraft NeoForge 1.21.1 的现代 UI 框架。

它专为模组开发者打造,旨在无需依赖大型基于 PNG 的 UI 图集的情况下,创建丰富且易于维护的原生 Minecraft 界面。

测试版发布说明

VoxelUI 目前处于公开测试阶段。

本次发布旨在:

  • 在实际模组开发用例中验证该框架
  • 收集错误报告
  • 识别 API 和组件系统中的薄弱环节
  • 在未来稳定版本发布前稳定引擎

您可能会遇到以下情况:

  • 存在 Bug
  • 部分组件的功能不完整或表现粗糙
  • Beta 版本之间的 API 变更
  • 在极端情况下出现布局或渲染回归问题

如果您测试 VoxelUI 并报告问题,将对推动项目达到稳定版本起到极大的帮助作用。

VoxelUI 提供的内容

  • 基于 XML 的屏幕布局
  • 支持级联的 MCSS 样式系统
  • 可复用的 UI 组件
  • 集中式的主题管理
  • 现代布局容器
  • 针对 Minecraft 优化的 UI 组件
  • 用于检查和迭代的开发者工具

核心功能

布局与组合

  • Panel(面板)
  • Grid(网格)
  • Stack(堆栈)
  • Tabs(标签页)
  • ScrollPanel(滚动面板)
  • ListView(列表视图)

交互式组件

  • Button(按钮)
  • TextInput(文本输入框)
  • Checkbox(复选框)
  • Slider(滑块)
  • Dropdown(下拉菜单)

面向 Minecraft 的组件

  • ItemStackView(物品堆叠视图)
  • InventoryGrid(背包网格)
  • ItemSlot(物品槽)

样式与工具

  • XML UI 加载器
  • 内联及外部 MCSS 样式表
  • 带有计算样式的样式级联
  • UI 检查器
  • 开发环境中的热重载
  • 安全的 XML 错误回退面板
  • 动画 UI 过渡效果,如悬停效果和平滑滚动

使用场景

VoxelUI 专为构建以下类型的界面而设计:

  • 配置屏幕
  • 任务日志
  • 自定义背包
  • 商店
  • 管理员面板
  • HUD 覆盖层
  • 数据驱动的 UI 屏幕

设计理念

VoxelUI 并不试图在 Minecraft 内部嵌入浏览器。

相反,它将更现代的 UI 工作流带入原生 Minecraft 渲染管线:

  • 声明式
  • 模块化
  • 可主题化
  • 可复用
  • 渲染器原生集成

当前状态

VoxelUI 是一个框架/库模组,而非独立的内容模组。

发布版默认禁用内部展示内容和调试工具。开发版则保留这些功能,以便于迭代和检查。

该项目尚未完全稳定。此测试阶段的目标是通过真实世界的反馈来强化框架,从而锁定更稳定的 API 接口。

兼容性

  • Minecraft: 1.21.1
  • 加载器: NeoForge
  • Java: 21

给开发者

VoxelUI 旨在作为其他需要结构化 UI 系统的模组的基础进行使用。

它包含:

  • measure -> layout -> render(测量 -> 布局 -> 渲染)管线
  • 基于 XML 的屏幕构建
  • 可复用的运行时绑定
  • MCSS 样式系统
  • 原生 Minecraft 渲染集成

寻求反馈

如果您正在使用此测试版,最有价值的反馈包括:

  • 可复现的 Bug
  • 破损的布局
  • 渲染问题
  • 不清晰或令人沮丧的 API 设计
  • 阻碍实际使用的缺失功能
  • XML、MCSS 和运行时绑定之间出现的不预期行为

许可证

Apache License 2.0

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源