WebGUI lets you render real web interfaces inside Minecraft using the technologies you already know.

Open any web page — React, Vue, Svelte, or plain HTML/CSS/JavaScript — as a full-screen GUI or transparent HUD overlay directly in-game. Powered by real Chromium via MCEF, so modern web features just work: CSS animations, WebSockets, fetch, WebGL, localStorage, realtime updates, and more.

Why WebGUI exists

I'm a fullstack developer. Most of my work is building web applications — React frontends, APIs, realtime systems, dashboards, all the usual web stack.

I've always loved Minecraft not only as a game, but as a creative platform. Servers, custom mechanics, communities, minigames, roleplay worlds — Minecraft gives people incredible freedom to build experiences together.

At some point I realized something:

Web developers already have amazing tools for building interfaces — but almost no good way to use them inside Minecraft.

Every day we build polished UIs with responsive layouts, animations, maps, shops, live dashboards, and realtime interaction. But bringing that same workflow into Minecraft has always been difficult, limited, or awkward.

So I asked a simple question:

What if Minecraft could just open a real web app?

Not a custom inventory GUI system. Not another proprietary UI framework. Not a new language to learn.

Just the web.

That's how WebGUI started.

Built for web developers

WebGUI is designed for developers who already know modern frontend development.

If you know:

HTML
CSS
JavaScript

—you already know how to build Minecraft interfaces with WebGUI.

Use React, Vue, Svelte, Tailwind, WebSockets, REST APIs, animations, state managers, component libraries — whatever you already use for normal web development.

Build:

server shops
HUD overlays
maps
menus
admin panels
quest systems
roleplay interfaces
realtime dashboards
entire in-game applications

Then load them directly inside Minecraft.

How it works

The server sends a URL to the client. The client opens it inside embedded Chromium. The page receives live player data automatically and can communicate back with the game in realtime.

Features

Full-screen GUI — replace Minecraft screens with your web app
HUD overlay — transparent browser layer rendered over gameplay
Real Chromium browser — powered by MCEF
Live player data — position, username, UUID, dimension, server
Realtime communication — browser ↔ Minecraft messaging
Signed player tokens — secure backend authentication without login screens
Auto HUD on join
Per-player main menu
Server-side Mod API
Works with any frontend stack

Commands

Command	Permission
`/webgui gui <targets> <url>`	`webgui.command.gui`
`/webgui hud <targets> <url>`	`webgui.command.hud`

JavaScript API

// Live player data
const {
  playerUuid,
  username,
  dimension,
  pos,
  server
} = window.webgui.client;

// Listen for updates
window.addEventListener('webgui:client', e => {
  console.log(e.detail);
});

// Send messages back to Minecraft
window.webgui.postToGame({
  channel: 'example',
  value: 42
});

// Close current GUI/HUD
window.webgui.closeGui();

React integration

npm i @webgui/react

import { useWebGUIClient } from '@webgui/react';

function App() {
  const client = useWebGUIClient();

  return (
    <div>
      Hello, {client?.username}
    </div>
  );
}

Server configuration

config/webgui/server.json

{
  "autoHudOnJoin": true,
  "autoHudUrl": "https://your-server.com/hud",
  "mainMenuUrl": "https://your-server.com/menu",
  "enableTokens": true,
  "tokenSecretBase64": "<base64 secret>",
  "tokenTtlSeconds": 300,
  "queryParamName": "webgui_token"
}

Requirements

Fabric Loader ≥ 0.18
Fabric API
Java 21

WebGUI

Compatibility

Minecraft: Java Edition

Platforms

Supported environments

Links

Tags

Creators

Details