Lumaris

A lightweight Fabric rendering library for mod developers who want clean, reusable, and version-friendly UI/HUD rendering tools.

What Lumaris Does

Lumaris provides a canvas-style rendering API so you can draw overlays without writing repetitive low-level rendering code. It is designed as a library mod, not a gameplay/content mod.

Why You Might Want It

• Build custom HUDs and overlays faster.
• Keep rendering code readable and maintainable.
• Reuse one rendering foundation across supported Minecraft versions.
• Avoid scattered version checks by using Lumaris compatibility layers.

Core Features

• Layer-based rendering with CanvasRenderer.registerLayer(...)
• 2D quad drawing commands
• Text rendering with scaling and optional shadow
• MSDF-based text pipeline for better visual quality
• Render event hooks for underlay/overlay workflows
• Multi-version support through Stonecutter

Supported Minecraft Versions

• 1.21.11
• 1.21.8

Requirements

• Java 21
• Fabric Loader 0.18.4+
• Fabric API
• Fabric Language Kotlin 1.13.9+kotlin.2.3.10

Quick Usage Example

CanvasRenderer.registerLayer("example.hud", order = 100) { ctx ->
    ctx.quad(12f, 12f, 140f, 30f, 0x99000000.toInt())
    ctx.text("Hello Lumaris", 18f, 20f, 0xFFFFFFFF.toInt(), scale = 1f, shadow = true)
}

Important Before Downloading

• Lumaris is a dependency/library mod.
• End users should install it only when another mod requires it.
• Use the Lumaris file that matches your Minecraft version.