# VoxelUI<\/p>\n
VoxelUI is a modern UI framework for **Minecraft NeoForge 1.21.1**.<\/p>\n
It is built for mod developers who want to create rich, maintainable, native Minecraft interfaces without relying on large PNG-based UI sheets.<\/p>\n
## Beta release notice<\/p>\n
**VoxelUI is currently in public beta.**<\/p>\n
This release is meant to:<\/p>\n
– validate the framework in real modding use cases
\n– collect bug reports
\n– identify weak spots in the API and component system
\n– stabilize the engine before a future stable release<\/p>\n
You should expect:<\/p>\n
– bugs
\n– incomplete or rough behavior in some components
\n– API changes between beta versions
\n– layout or rendering regressions in edge cases<\/p>\n
If you test VoxelUI and report issues, that is extremely useful for getting the project to a stable release.<\/p>\n
## What VoxelUI provides<\/p>\n
– XML-based screen layouts
\n– MCSS styling system with cascade support
\n– reusable UI components
\n– centralized theming
\n– modern layout containers
\n– Minecraft-specific UI components
\n– developer tooling for inspection and iteration<\/p>\n
## Core features<\/p>\n
### Layout and composition<\/p>\n
– `Panel`
\n– `Grid`
\n– `Stack`
\n– `Tabs`
\n– `ScrollPanel`
\n– `ListView`<\/p>\n
### Interactive components<\/p>\n
– `Button`
\n– `TextInput`
\n– `Checkbox`
\n– `Slider`
\n– `Dropdown`<\/p>\n
### Minecraft-oriented components<\/p>\n
– `ItemStackView`
\n– `InventoryGrid`
\n– `ItemSlot`<\/p>\n
### Styling and tooling<\/p>\n
– XML UI loader
\n– inline and external MCSS stylesheets
\n– style cascade with computed styles
\n– UI inspector
\n– hot reload in development environment
\n– safe XML error fallback panels
\n– animated UI transitions such as hover and smooth scrolling<\/p>\n
## Use cases<\/p>\n
VoxelUI is designed for building interfaces such as:<\/p>\n
– configuration screens
\n– quest logs
\n– custom inventories
\n– shops
\n– admin panels
\n– HUD overlays
\n– data-driven UI screens<\/p>\n
## Philosophy<\/p>\n
VoxelUI does **not** try to embed a browser inside Minecraft.<\/p>\n
Instead, it brings a more modern UI workflow to native Minecraft rendering:<\/p>\n
– declarative
\n– modular
\n– themeable
\n– reusable
\n– renderer-native<\/p>\n
## Current status<\/p>\n
VoxelUI is a **framework\/library mod**, not a standalone content mod.<\/p>\n
Release builds disable internal showcase and debug tooling by default. Development builds keep them available for iteration and inspection.<\/p>\n
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.<\/p>\n
## Compatibility<\/p>\n
– **Minecraft:** 1.21.1
\n– **Loader:** NeoForge
\n– **Java:** 21<\/p>\n
## For developers<\/p>\n
VoxelUI is intended to be used as a base for other mods that need structured UI systems.<\/p>\n
It includes:<\/p>\n
– a `measure -> layout -> render` pipeline
\n– XML-driven screen construction
\n– reusable runtime bindings
\n– MCSS styling
\n– native Minecraft rendering integration<\/p>\n
## Feedback wanted<\/p>\n
If you use this beta, the most useful feedback is:<\/p>\n
– reproducible bugs
\n– broken layouts
\n– rendering issues
\n– unclear or frustrating API design
\n– missing features that block real usage
\n– unexpected behavior between XML, MCSS, and runtime bindings<\/p>\n
## License
\nApache License 2.0<\/p>\n","protected":false},"excerpt":{"rendered":"
Modern UI framework for Minecraft NeoForge with XML layouts, MCSS styling, reusable components, theming, and developer tooling.<\/p>\n","protected":false},"featured_media":167783,"template":"","meta":{"_minecraft_slug":"voxelui-framework","_minecraft_project_id":"G9IleGGI","_minecraft_author":"AlexandreGRZ1","_minecraft_license":"Apache-2.0","_minecraft_downloads":7,"_minecraft_follows":0,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"voxelui-framework.zip","_minecraft_size_bytes":1467047,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T12:34:36.511468Z","_minecraft_date_created":"2026-05-12T04:16:44.217325Z","_minecraft_date_modified":"2026-04-30T08:33:18.756559Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/voxelui-framework","_minecraft_icon_attachment_id":167783,"_minecraft_imported_at":"2026-06-09T19:16:57+00:00","_minecraft_import_hash":"35478bb0d8c96d29c900f43232c48e48","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[873,158,123,92],"mod_loader":[160],"minecraft_version":[37],"class_list":["post-167782","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-library","mod_category-neoforge","mod_category-technology","mod_category-utility","mod_loader-neoforge","minecraft_version-1-21-1"],"yoast_head":"\n