MasuGUI — гибкая GUI-библиотека для серверов Minecraft

MasuGUI — data-driven GUI-библиотека для Minecraft на Forge 1.18.2: кастомные интерфейсы с фолбэком на ванильные меню. Удобная установка и поддержка серверов.

MasuGUI: продвинутые интерфейсы для серверов Minecraft

Если вы держите сервер на Minecraft и хотите, чтобы магазины, меню настроек и профили игроков выглядели современно, а не как стандартный сундук, обратите внимание на MasuGUI. Это data-driven библиотека для Forge 1.18.2, которая позволяет другим модам и плагинам описывать интерфейсы один раз, а отображать их по-разному в зависимости от клиента. Звучит сложно, но на практике всё куда проще, чем кажется.

Что такое MasuGUI и зачем она нужна

MasuGUI — это не мод с контентом, а библиотека. Сама по себе она не добавляет предметов, блоков или квестов. Её задача — дать разработчикам API для создания богатых кастомных экранов. Ключевая фишка — маршрутизация рендеринга. Если у игрока установлен MasuGUI, он видит красивый экран с градиентами, анимациями и прокруткой. Если мода нет, тот же интерфейс прозрачно превращается в ванильный контейнер — сундук, воронку, наковальню, торговца и так далее. Один JAR, один API, два визуальных опыта из одного описания.

Такой подход особенно ценен для серверов: вы не заставляете всех игроков ставить мод, но те, кто это сделал, получают заметно более приятный интерфейс. При этом интерактивность сохраняется — слоты в фолбэк-режиме остаются настоящими, с drag-and-drop.

Ключевые возможности библиотеки

Набор элементов впечатляет: 14 типов, среди которых Panel, Label, Button, TextField, ItemGrid, ItemDisplay, Divider, ProgressBar, Image, ScrollPanel, Checkbox, Slider, TabBar, Dropdown и PlayerHead. Макеты описываются в JSON-файлах в папке конфигурации, а команда /masugui reload перезагружает шаблоны без перезапуска сервера — горячая перезагрузка экономит уйму времени.

  • Анимации: 6 функций плавности, 8 анимируемых свойств и 3 режима воспроизведения, всё задаётся в JSON.
  • Удалённые текстуры: любое поле текстуры принимает URL, изображение скачивается асинхронно и кэшируется на диск.
  • 18 типов ванильных контейнеров для фолбэка: сундуки разных размеров, воронка, раздатчик, наковальня, кузнечный стол, печь, варочная стойка, торговец, маяк и другие.
  • Система курсора: подбор и размещение предметов в расширенном режиме.
  • GUI Effects API: серверные анимации ячеек (PULSE, FLASH, BOUNCE, FADE_OUT, SCALE_UP), клиентские звуки и полноэкранные награды.
  • Защита совместимости с Quark через mixin, блокирующий нежелательные переносы инвентаря.
  • Автозакрытие по расстоянию, смене измерения или смерти игрока.

Для разработчиков есть два пути описания интерфейса: Java builder API и JSON-шаблоны с переменными, провайдерами данных и именованными обработчиками действий. Команда /masugui test открывает шесть демо-экранов — магазины, настройки, профили, прокрутка, торговцы и подтверждения, так что оценить возможности можно прямо в игре.

Версии, загрузчик и требования

MasuGUI для Minecraft работает на Forge 1.18.2, минимальная версия — 40.3.11 или новее, требуется Java 17. Quark подключается опционально и только на этапе компиляции для миксина защиты инвентаря. Учтите: это персональный релиз. Автор публикует мод прежде всего для собственных проектов, поэтому официальной поддержки, трекера ошибок и приёма запросов на фичи нет. Используете на свой страх и риск — если всё работает, отлично, если нет, придётся разбираться самостоятельно. Лицензия All Rights Reserved разрешает применение в модпаках и на серверах, но запрещает перераспространение, декомпиляцию и перезалив JAR без разрешения.

Как установить MasuGUI

Процесс простой. Установите Forge 1.18.2, затем поместите JAR-файл в папку mods/. Мод ставится и на сервер, и на клиенты. Клиенты без библиотеки продолжат работать, но увидят фолбэк-интерфейсы на основе сундуков вместо расширенного рендера. Если хотите скачать MasuGUI без лишней возни, обратите внимание на лаунчер foxygame.net: там MasuGUI добавляется в сборку в один клик вместе с проверенной версией Forge, и не нужно вручную сверять совместимость файлов.

Полезные команды

После установки пригодятся несколько команд: /masugui test открывает демо-хаб, /masugui fallback включает принудительный фолбэк для предпросмотра сундучного рендера, /masugui reload [modId] перезагружает JSON-шаблоны (уровень OP 2), /masugui editor <modId> <guiName> запускает визуальный редактор прямо в игре, а /masugui status показывает обнаружение клиентского мода и флаг фолбэка.

Итог

MasuGUI — узкоспециализированный, но очень аккуратный инструмент для тех, кто делает серверные интерфейсы на Forge 1.18.2. Двойной режим рендеринга, JSON-шаблоны с горячей перезагрузкой и солидный набор элементов делают её отличным выбором для магазинов, меню и наград. Главное — помнить о статусе персонального релиза и тестировать всё на своём сервере, прежде чем выкатывать игрокам.