ApricityUI: Build Minecraft UIs With HTML, CSS, and JS
If you have ever tried to design a custom interface for a Minecraft mod, you already know the pain. Layouts are rigid, styling options are limited, and even simple effects like rounded corners or smooth scrolling can take hundreds of lines of Java code. ApricityUI changes that entirely. This lightweight framework lets you build rich, modern interfaces using the classic web trio: HTML, CSS, and JavaScript. If you can build a webpage, you can build a Minecraft UI.
What Makes ApricityUI Different
The core idea behind ApricityUI is a low-barrier, convenient, and versatile UI framework. Instead of inventing a new syntax, it follows web standards as closely as possible. That decision has huge benefits. Web frameworks are universal, which means documentation is everywhere, tutorials are plentiful, and AI tools already understand them inside out. You can practically let an AI generate your entire interface, and the resulting code will still be readable and maintainable.
Unlike some UI libraries, ApricityUI does not bundle a Chrome or CEF kernel. It is built entirely from scratch in Java, keeping the file size under 1MB. There is no bloat, no heavy dependency chain, and no performance disaster waiting to happen. In stress tests, a complex UI dropped frame rates from 400 to 300 FPS, which is still far above the 240 FPS that the vanilla Creative inventory runs at.
Supported Versions and Loaders
ApricityUI is currently available for Minecraft 1.20.1 on the Forge loader. The development team is actively porting the framework to other versions, with Minecraft 1.21 slated to be supported first. Because the project follows fixed web standards, updating across game versions is far less painful than with traditional UI code. You can move forward with confidence instead of worrying about major compatibility breaks every time Mojang ships a patch.
JavaScript integration currently relies on KubeJS, though it is optional. Without KubeJS, you cannot parse JS inside HTML or use the developer console, but hardcoded mod UIs still work fine. For modpack creators who want to paint interfaces to their heart's content, KubeJS unlocks the full experience with an incredibly low learning curve.
Key Features and Capabilities
The feature list reads like a wishlist for Minecraft interface designers. Almost everything you would expect from a modern browser is here, translated into the game.
- Box model support with box-shadow, adjustable borders, and rounded corners at custom angles
- Standard Flexbox layout for responsive, flexible designs
- Up to four custom fonts loaded simultaneously, including the vanilla font
- Built-in overflow masking and nested clipping for complex shapes
- In-world rendering at specific coordinates and angles with occlusion support
- 9-slice scaling via the border-image property for flexible UI textures
- Full GIF support for animated images
- Custom CSS animations and transitions
- Customizable text input components
- Native Minecraft element integration, including custom containers and inventories
- Pre-built themes such as the AE2 (Applied Energistics) style
Extensibility is where ApricityUI truly shines. Features like frosted glass backgrounds, nested masks, and custom animations usually demand hundreds of lines of code. Here, they take just a few. If you need a CSS property that is not supported yet, you can open an issue on GitHub and the team will look into it.
For mod developers, ApricityUI works beautifully as a dependency. The JavaScript and Java implementations are largely equivalent, so you can create highly extensible interfaces without forcing players to learn a new system. If you want to skip the manual setup entirely, the foxygame.net launcher offers a one-click install for ApricityUI, dropping the add-on straight into your instance without any file juggling.
How to Install ApricityUI
Getting started is straightforward. First, download ApricityUI from the official source and place the mod file into your mods folder. You will also need KubeJS if you want full JavaScript support and access to the developer console. Once the game launches, assets are stored in the /apricity folder within your instance directory, or they can be delivered through resource packs.
For modpack developers, the /apricity folder is the recommended workflow. Press the END key to hot-reload, and changes usually take effect in under a second. Reloading a document with twenty avatars and three custom fonts takes about one second. Sharing your UI is just as easy: distribute it via a resource pack or a simple ZIP file. Since resource packs require a full game reload, ZIPs are often faster for testing.
Debugging and Developer Tools
ApricityUI includes a DevTools console similar to what you would find in a browser. Press F12 to open it. The console supports visual editing of attributes, innerText, and styles, as well as executing JavaScript statements. Almost everything supports instant hot-reloading, so you can iterate on your design without restarting the game. This makes the development loop feel closer to web development than modding, which is exactly the point.
Remote assets are supported too. ApricityUI can asynchronously load web resources such as image hosting or GitHub content. Use this responsibly, since it depends on external services. A server-to-client HTML solution is also in the works, promising that vintage server-side rendering feel in a future update.
Final Thoughts
ApricityUI is one of the most exciting UI frameworks to hit the Minecraft modding scene in years. It lowers the barrier to entry, respects web standards, stays lightweight, and plays nicely with AI-assisted workflows. Whether you are a modpack creator who wants beautiful menus or a mod developer who needs a flexible dependency, this framework delivers. Download ApricityUI for Minecraft, experiment with the examples in the documentation, and see how quickly you can build interfaces that once took weeks.
--- **Update Oct 6, 2026:** Added 8 files for version 26.1, 1.21.1, 1.20.1, 1.19.2, 1.18.2 (Fabric, NeoForge, Forge).