Spell Renderer

✨ Spell Renderer

Modern 2D UI rendering for Fabric mods: rounded panels, liquid glass, crisp text and draggable HUDs, all from one fluent API.

Building a good-looking interface in Minecraft usually means fighting with GuiGraphics or writing raw OpenGL yourself. Spell Renderer gives you a small, chainable builder instead. You describe a shape and call .submit(), and the library takes care of shaders, batching, scaling and clipping.

📦 This is a library mod. On its own it adds nothing to the game. Install it if another mod needs it, or use it to build your own UI.

🎨 What you can draw

🧊 New: liquid glass

Glass panels have been rebuilt from the ground up. Each panel has its own settings:

• Blur. From barely there to heavily frosted, and every radius costs the same, so heavy blur doesn't slow your UI down.
• Refraction. Edges bend the background like a lens, for the liquid-glass look. Set it to 0 for flat frosted glass.
• Chromatic split. A subtle RGB fringe along the edges.
• Saturation. Make the background behind the glass more vivid, or turn it grayscale.

• Highlight. A thin rim of light along the edge.

  Builder.glass()
        .pos(20, 20)
        .size(200, 120)
        .radius(16)
        .blur(16)
        .refraction(0.9f)
        .chromatic(4)
        .saturation(1.4f)
        .highlight(0.3f)
        .submit();

  Glass now looks the same at every UI scale, and stacking glass on glass works as you'd expect.

  ⚡ Features

• 🔗 Fluent builder. Position, size, color, round and fade a shape in one readable chain.
• 🖱️ Draggable shapes. Add .draggable("id") to a shape and players can move it with the mouse. Its children move with it, it can't leave the screen, and its position can be saved and restored.
• 👪 Parenting. Attach shapes to a parent and they follow its position, depth and opacity.
• 🚀 Batched rendering. Shapes of the same type are drawn together in one draw call.
• 🔤 MSDF text. Text stays sharp at any scale and any GUI size.
• ✂️ Scissors. Clip drawing to a region, which is handy for scroll lists and masked panels.
• 🔍 Scaling. Scale your whole UI independently of Minecraft's GUI scale.

• 🧭 Render contexts. Draw on the HUD during gameplay or on the GUI layer above every screen. (World rendering is in development.)

  🧑‍💻 How it looks in code

  SpellRenderer.on(RenderContext.HUD, () -> {
    var panel = Builder.rect()
            .pos(20, 20)
            .size(220, 80)
            .radius(12)
            .color(new Color(30, 30, 40))
            .draggable("my-panel");   // players can move it while chat is open
    panel.submit();
  
    Builder.text("Hello, Spell!")
            .pos(12, 12)
            .size(24)
            .parent(panel)            // moves together with the panel
            .submit();
  });

  📥 Getting started

  Add it from the Modrinth Maven:

  repositories {
    maven { url = "https://api.modrinth.com/maven" }
  }
  
  dependencies {
    modImplementation "maven.modrinth:spell-renderer:<version>"
    include "maven.modrinth:spell-renderer:<version>" // optional: bundle it inside your mod
  }

  Maven setup, adding fonts and icons, and the full API are in the documentation on GitHub.

  📋 Requirements

• Minecraft 1.21.8
• Fabric Loader 0.18.5+
• Fabric API

• Java 21

  ---

  💬 Found a bug or have an idea?

  Open an issue on GitHub. Feedback and contributions are welcome!