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
VoxelUI
VoxelUI is a modern UI framework for Minecraft NeoForge 1.21.1.
It is built for mod developers who want to create rich, maintainable, native Minecraft interfaces without relying on large PNG-based UI sheets.
Beta release notice
VoxelUI is currently in public beta.
This release is meant to:
- validate the framework in real modding use cases
- collect bug reports
- identify weak spots in the API and component system
- stabilize the engine before a future stable release
You should expect:
- bugs
- incomplete or rough behavior in some components
- API changes between beta versions
- layout or rendering regressions in edge cases
If you test VoxelUI and report issues, that is extremely useful for getting the project to a stable release.
What VoxelUI provides
- XML-based screen layouts
- MCSS styling system with cascade support
- reusable UI components
- centralized theming
- modern layout containers
- Minecraft-specific UI components
- developer tooling for inspection and iteration
Core features
Layout and composition
Panel
Grid
Stack
Tabs
ScrollPanel
ListView
Interactive components
Button
TextInput
Checkbox
Slider
Dropdown
Minecraft-oriented components
ItemStackView
InventoryGrid
ItemSlot
Styling and tooling
- XML UI loader
- inline and external MCSS stylesheets
- style cascade with computed styles
- UI inspector
- hot reload in development environment
- safe XML error fallback panels
- animated UI transitions such as hover and smooth scrolling
Use cases
VoxelUI is designed for building interfaces such as:
- configuration screens
- quest logs
- custom inventories
- shops
- admin panels
- HUD overlays
- data-driven UI screens
Philosophy
VoxelUI does not try to embed a browser inside Minecraft.
Instead, it brings a more modern UI workflow to native Minecraft rendering:
- declarative
- modular
- themeable
- reusable
- renderer-native
Current status
VoxelUI is a framework/library mod, not a standalone content mod.
Release builds disable internal showcase and debug tooling by default. Development builds keep them available for iteration and inspection.
This project is not presented as fully stable yet. The goal of this beta phase is to harden the framework through real-world feedback before locking down a more stable API surface.
Compatibility
- Minecraft: 1.21.1
- Loader: NeoForge
- Java: 21
For developers
VoxelUI is intended to be used as a base for other mods that need structured UI systems.
It includes:
- a
measure -> layout -> render pipeline
- XML-driven screen construction
- reusable runtime bindings
- MCSS styling
- native Minecraft rendering integration
Feedback wanted
If you use this beta, the most useful feedback is:
- reproducible bugs
- broken layouts
- rendering issues
- unclear or frustrating API design
- missing features that block real usage
- unexpected behavior between XML, MCSS, and runtime bindings
License
Apache License 2.0
评论 0
登录后参与评分
还没有评论,来抢沙发吧