WebGUI

Ваше веб-приложение, работающее внутри Minecraft.

WebGUI открывает настоящую веб-страницу в игре — как полноэкранный интерфейс или как прозрачный оверлей поверх геймплея. Не перерисованный инвентарь, не очередной UI-фреймворк, который надо учить: настоящие HTML, CSS и JavaScript, отрендеренные настоящим Chromium.

Если вы умеете делать сайты, вы умеете делать интерфейсы для Minecraft.

▶YouTube · плеер загрузится по нажатию

Что с этим делают

• Магазины на сервере, выглядящие как интернет-магазин — с картинками, поиском и корзиной
• Журналы квестов и кодексы с настоящей типографикой и вёрсткой
• Живые карты — Leaflet или свой canvas, следящие за игроком в пути
• HUD-оверлеи — счёт команд, таймеры, полоски здоровья, миникарта, нарисованные поверх мира
• Админ-панели для персонала — тот же дашборд, что вы уже гоняете в браузере
• Кастомные экраны смерти, которые говорят, кто вас убил, и дают возродиться
• Меню запуска и экраны лобби с брендингом вашего сервера
• Целые внутриигровые приложения — всё, что вы иначе делали бы как веб-приложение

Почему это ощущается иначе

Всё, чем вы уже пользуетесь, продолжает работать. React, Vue, Svelte или чистый JavaScript. Tailwind. Ваша библиотека компонентов. Ваши анимации, ваш API, ваш WebSocket. Вы разрабатываете в браузере с горячей перезагрузкой, потом направляете мод на страницу — и в игре всё выглядит точно так же.

И страница — не декорация. Она знает, кто на неё смотрит и что происходит вокруг — имя игрока, здоровье, еда, позиция, куда он смотрит, какой блок или моб под прицелом — и обновляется по мере движения. И она умеет отвечать: клик на странице становится событием на сервере, так что магазин реально продаёт, а кнопка реально выполняет команду.

// Это вся интеграция
window.webgui.on('client', player => {
  document.title = `${player.username} — ${player.health} HP`;
});

window.webgui.postToGame({ channel: 'shop:buy', item: 'diamond' });

Для React, Vue и Svelte есть один пакет с готовыми хуками и сторами:

npm i @webgui/client

Веб-хостинг даже не нужен

Положите файлы в папку на сервере и направьте на них мод. Они уходят по тому же соединению, на котором игрок уже сидит — никакого домена, никаких счетов за хостинг, никаких портов, работает за NAT. Отредактируйте файл, выполните одну команду — и открытая у игрока страница обновится прямо у него на глазах.

Предпочитаете свой хостинг? Ничего не меняется: адрес https:// работает точно так же, как всегда, и эти два способа свободно смешиваются.

Для владельцев серверов

Открыть страницу — одна команда:

/webgui gui @a https://your-site.example/shop
/webgui hud @a webgui:/hud.html

Страницы также можно привязать к сущности, так что ПКМ по жителю открывает ваш магазин с контекстом этого жителя. Каждый URL, который открывает мод, несёт подписанный токен, так что ваш бэкенд знает, какой игрок спрашивает, без экрана входа. Игрокам без мода сообщают, что они теряют, вместо того чтобы они молча ничего не видели.

Совместимость

Minecraft 26 пока только на NeoForge — Fabric ждёт Yarn-маппинги для 26.x.

Установка: на Fabric нужен Fabric API, и всё — браузер идёт внутри jar. На NeoForge добавьте рядом Rinku; лаунчеры подхватят его автоматически. Chromium (~150 МБ) скачивается сам при первом запуске. Java 21, или Java 25 для Minecraft 26.

Ссылки

• Документация — https://webgui.space — руководства, полный API и примеры, которые можно скопировать
• GitHub — https://github.com/mc-webgui/webgui — задачи и исходный код
• npm — https://www.npmjs.com/package/@webgui/client