ImproperUI (Импропер УИ)

Мод для Майнкрафт на Fabric, предназначенный для разработчиков модов: он позволяет создавать игровые интерфейсы скриптами с синтаксисом, похожим на CSS. С его помощью можно делать интерактивные экраны с кнопками, полями ввода, прокруткой, перетаскиванием элементов и обработкой нажатий.

Возможности

• Элементы интерфейса: контейнеры, флажки, переключатели, кнопки, ссылки, ползунки, поля ввода, многострочные поля и текстовые заголовки.
• Настройка размеров, отступов, сетки, цветов, рамок, теней, фона, положения и порядка слоёв.
• Состояния наведения, выбора и фокуса; дочерние элементы, прокрутка и перетаскивание.
• Обработчики событий из скрипта: например, on-click: sendHelloWorld вызывает метод с тем же именем в классе, реализующем CallbackListener.
• API для разбора и запуска экранов: ImproperUIAPI.parse(), ImproperUIAPI.parseAndRunFile(), ImproperUIAPI.parseAndRunScript(), ImproperUIAPI.reload() и ImproperUIAPI.reInit().

Как пользоваться

Добавьте файл мода в зависимости своего проекта и в папку модов, затем инициализируйте API через ImproperUIAPI.init(). При инициализации указываются идентификатор мода, класс-инициализатор и пути к файлам интерфейса; скрипты принято хранить в src/main/resources/assets/<modId>/improperui/.

При запуске файла через ImproperUIAPI.parseAndRunFile() указывается имя файла, например testing.ui, а не путь, заданный при инициализации. Для экрана ImproperUIPanel зарегистрируйте обработчик через registerCallback().

Настройки

Значения ползунков, флажков и других элементов можно сохранять в конфиге. Ключ задаётся как modId:configFile:propertyName и добавляется классу элемента, например -yourModId:config.properties:testing-slider-value.

Требования и совместимость

Для создания интерфейсов нужны базовые знания Java, HTML и CSS. Мод рассчитан на использование как библиотека внутри другого мода для Fabric.