TesseraUI

Write Minecraft GUI screens in HTML and CSS. TesseraUI parses them at runtime and renders native NeoForge widgets — no JavaScript, no browser engine, 100% Java.

Minecraft 1.21.1  ·  NeoForge 21.1.x  ·  Java 21  ·  LGPL-3.0   |   GitHub  ·  Wiki  ·  Bug Reports

Everything painful in NeoForge GUI is handled for you: flexbox layout, hover transitions, @keyframes animations, drag & drop, item pickers, virtual lists, i18n. Use HTML templates or the full programmatic Java API — your choice.

✦ Features

⚡ Quick Start

assets/yourmod/ui/my_screen.html

<col>
  <h2 data-i18n="ui.yourmod.title">Settings</h2>
  <p>Hello, {{ player.name }}!</p>
  <row>
    <button onclick="save">Save</button>
    <button onclick="cancel">Cancel</button>
  </row>
</col>

MyScreen.java

public class MyScreen extends TesseraScreen {
    private TesseraPanel root;

    @Override
    protected void init() {
        TesseraModel model = TesseraModel.of(Map.of(
            "player.name", player.getName().getString()
        ));
        root = TesseraTemplateRenderer.build(
            TesseraTemplate.load("yourmod:ui/my_screen"),
            model, handlers, x, y, width, height
        );
    }

    @Override protected TesseraPanel tesseraRoot() { return root; }
}

🏷 Supported Tags

<col> <row> <grid> <div> <section> <nav> <h1>–<h6> <p> <span> <label> <button> <input> <textarea> <checkbox> <slider> <select> <badge> <icon> <tabs> <virtual-list> <item-slot> <table> <ul> <img>

📄 License

LGPL-3.0 — usable in any mod, open-source or closed-source, free or paid, without restrictions. Only modifications to TesseraUI itself must be published under LGPL-3.0.