Быстрый запуск

Что такое WebGUI?

WebGUI — это Fabric-мод для Minecraft, который встраивает настоящий браузер Chromium (через MCEF) прямо в игровой клиент. Операторы серверов могут отображать любую веб-страницу — React, Vue, чистый HTML — как прозрачный HUD-оверлей для игроков, а также задать страницу главного меню, открываемую по нажатию клавиши.

Требования

Компонент	Версия
Minecraft	1.20.1, 1.21.1, 1.21.11
Fabric Loader	≥ 0.16.0
Fabric API	любая
Java	21

Установка

1. Скачайте последний webgui-*.jar из Releases.
2. Поместите его в папку .minecraft/mods/ вместе с Fabric API.
3. Запустите игру — Chromium загрузится автоматически при первом запуске (~150 МБ).

Избавьте игроков от загрузки

Чтобы Chromium был уже включён в сборку (без загрузки при первом запуске), добавьте MCEF в ваш модпак вместе с WebGUI. Без него мод скачает Chromium автоматически — MCEF опционален.

Как работает мод

В WebGUI нет игровых команд. Всё настраивается через config/webgui/server.json на сервере. При входе игрока сервер может:

• Автоматически открыть HUD-оверлей (autoHudOnJoin)
• Отправить URL главного меню, который игрок откроет нажатием F6 (mainMenuUrl)

Все доступные параметры описаны в конфиге server.json.

Авто-открытие HUD при входе

Самая распространённая настройка — показывать веб-оверлей сразу после подключения:

// config/webgui/server.json
{
  "autoHudOnJoin": true,
  "autoHudUrl": "https://ваш-hud.example.com"
}

Перезапустите сервер и войдите — оверлей откроется автоматически.

Главное меню по F6

Отправьте игрокам URL, который они смогут открыть в любой момент нажатием F6:

{
  "mainMenuUrl": "https://ваш-menu.example.com"
}

Следующие шаги

• Конфиг server.json — все параметры конфигурации
• Горячие клавиши — управление HUD на стороне клиента
• Примеры — готовые конфиги для вставки
• React-библиотека — создайте SPA с типобезопасными хуками