@bedrock-core/ui

⚠️ Beta Status: Active development. Breaking changes may occur until 1.0.0. Pin exact versions for stability.

This is not ready for production use.

📦 This is a developer library, not a standalone addon. It does nothing on its own — it is meant to be used by addon developers to build UIs in their own projects.

Custom JSX-driven UI system for Minecraft Bedrock. Components serialize into compact strings decoded by a companion resource pack to render rich layouts beyond native @minecraft/server-ui limitations.

📘 Full documentation & guides: https://bedrock-core.drav.dev/

Preview

🗺 Development Roadmap

✅ Beta 0.1.0 - Core Foundation

✅ Serialization protocol with UTF-8 safety
✅ JSX runtime with custom component system
✅ Base components (Panel, Text, Image, Fragment)
✅ JSON UI resource pack decoder
✅ TypeScript library with proper exports

✅ Beta 0.2.0 - State & Button

✅ Component: Button with click events
✅ State management hooks
✅ Event system

✅ Beta 0.3.0

No features, just fixes to workflows and automated releases.

✅ Beta 0.4.0 - Styling

✅ Flex, margins, paddings, spacing…

✅ Beta 0.5.0 - Theming

✅ Component theming system → shipped via @bedrock-core/ore-styled

✅ Beta 0.6.0 - Navigation & Item Rendering

✅ Stack-based multi-screen navigation system
✅ Screen parameters and typed route state
✅ Navigation hooks: useNavigation(), useRoute()
✅ NavigationContainer, createStackNavigator, Screen
✅ ItemRenderer component — render item icons inside layouts
✅ useSetScreen hook — override screen layout per build
✅ Ore-Styled item components: ItemSlot, ItemContainer, EquipmentSlots

✅ Beta 0.7.0 - Interactive Components & Custom Natives

✅ Custom native component API — register your own native JSON UI components compatible with @bedrock-core/ui
✅ Modal-backed form primitives in @bedrock-core/ui: Input, Dropdown, Slider (v0)
✅ Ore-Styled form fields in @bedrock-core/ore-styled: Input, Dropdown, Slider
✅ Scroll fixes — corrected scroll sizing and removed the fixed screen layout

✅ Beta 0.8.0 - Multi-Scroll & Layout Polish

✅ <Scroll> component — declare up to 4 independent scroll regions per render (pool protocol v0007)

🚧 Beta 0.X.0 - Forms (Planned)

Form submission and validation helpers

🚧 Beta 0.X.0 - More core components (Planned)

Entity render(?)
Structure render(?)

👀 Beta 0.X.0 - REDACTED

🚀 Future Considerations

Compound components (tabs, menus, dialogs)
Animation support
Resource pack builder automation
Reactive data binding (if feasible)
Export feature for "non-form" JSON UI
Support for translations params (key:string, with: string[]) in SerializableString

🤝 Contributing

Let's talk in Discord https://bedrock-core.drav.dev/discord

For technical documentation and implementation details, see:

UI Runtime Package - Core framework internals
Flexbox - Layout engine
Ore-Styled Components - Optional prebuilt Ore-UI styled components
Resource Pack - Test addon and reference
CLI Tool - Project scaffolding

📖 Resources

What about ore-ui/DDUI?

ore-ui: When it releases in Number.MAX_SAFE_INTEGER years, will consider if it is worth to port for ore-ui. DDUI: It cannot be made compatible, DDUI does not use JSON UI so we cannot use the same methods.