Skip to content

Graphene

Graphene is a client-side UI library for Minecraft (Fabric) that lets mod developers build interfaces with web technologies.

Fabric
Loaders
Fabric
Downloads on Modrinth
1.4K
Followers on Modrinth
7
versions
25
Updated
August 31, 2026Aug 31
Published
in 2026
This is a library — other mods need it, and it adds nothing to the game by itself
Graphene Demo Screen · swipe

At a glance

A library: other mods need it
Runs on Fabric
For Minecraft 1.21.11, 26.1.2–26.2
Client only — no need to install it on the server
Latest version — 2.4.0 from August 31, 2026
Requires Fabric API
Where it's needed
In gamerequiredOn servernot needed

Install in the game only; not needed on the server

Game versions1.21.11, 26.1.2–26.2

Graphene

Modrinth GitHub Release Maven Central 26.2 Maven Central 26.1.2 Maven Central 1.21.11 License: MIT

Graphene is a client-side UI library for Minecraft that lets mod developers build interfaces with web technologies. It embeds Chromium through JCEF, so you can render HTML/CSS/JavaScript UIs in-game while keeping a clean Java API for mod integration.

A Three.js scene rendered by Graphene inside Minecraft

What is Graphene?

Graphene bridges Minecraft modding and modern web UI development. Instead of building every screen with Minecraft's rendering primitives, you can create interfaces with HTML, CSS, and JavaScript, then integrate them with your mod through a Java API.

Graphene provides:

  • interactive Chromium views that can be embedded in Minecraft screens;
  • packaged asset URLs and an optional development HTTP server;
  • two-way Java/JavaScript communication through an asynchronous bridge;
  • browser navigation, input, downloads, dialogs, context menus, and lifecycle controls;
  • off-screen browser sessions and surfaces for custom rendering integrations;
  • Chromium DevTools support for inspecting and debugging pages.

Check compatibility and installation for supported Minecraft and Loader versions.

Requirements

  • Java: 25 for Minecraft 26.2 and 26.1.2, 21 for Minecraft 1.21.11
  • GPU: NVIDIA GeForce GT 720 or better
  • For macOS users: macOS 12 (Monterey) or later

Supported Platforms

  • macOS: arm64, amd64
  • Linux: arm64, amd64
  • Windows: amd64, arm64

Tested Platforms

  • Windows 11 with AZERTY and QWERTY keyboard layouts
  • Linux (Wayland) with AZERTY and QWERTY keyboard layouts
  • macOS 26 with QWERTY keyboard layout

Installation

Graphene is published on Maven Central. Find the latest version on GitHub Releases, Modrinth, or the Minecraft-version-specific Maven Central artifacts, then add the artifact matching your target Minecraft version as a mod dependency:

repositories {
    mavenCentral()
}

dependencies {
    modImplementation("io.github.trethore:graphene-ui-26.2:<version>")
    // Or for Minecraft 26.1.2:
    // modImplementation("io.github.trethore:graphene-ui-26.1.2:<version>")
    // Or for Minecraft 1.21.11:
    // modImplementation("io.github.trethore:graphene-ui-1.21.11:<version>")
}

Declare Graphene as a runtime dependency in fabric.mod.json:

{
  "depends": {
    "grapheneui": ">=<version>"
  }
}

Register your mod from its client initializer and retain the returned context:

import io.github.trethore.graphene.api.Graphene;
import io.github.trethore.graphene.api.GrapheneContext;
import net.fabricmc.api.ClientModInitializer;

public final class ExampleModClient implements ClientModInitializer {
    private static GrapheneContext graphene;

    @Override
    public void onInitializeClient() {
        graphene = Graphene.register(ExampleModClient.class);
    }

    public static GrapheneContext graphene() {
        return graphene;
    }
}

See those documentation pages for more details:

Contributing

Contributions are welcome!

  • Read the contributor guide in CONTRIBUTING.md.
  • Report bugs or request features in Issues.
  • Open changes through Pull Requests.
  • All pull requests must be tested before being submitted.

Documentation

Start HERE!

License

Licensed under the MIT License by Titouan Réthoré.

FAQ

How to install Graphene?

Install Fabric for your Minecraft version, download Graphene for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does Graphene support?

Graphene has builds for Minecraft 1.21.11, 26.1.2–26.2.

Is Graphene needed on the server?

Client only — no need to install it on the server

License and source
MIT Licensefree to use and share with credit to the author
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More