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