ApricityUI

ApricityUI — это высокофункциональный фреймворк, позволяющий создавать интерфейсы в Minecraft с помощью связки HTML, CSS и JavaScript. Он обеспечивает низкий порог вхождения для авторов сборок и расширенные возможности для разработчиков модов.

ApricityUI построен вокруг идеи создания удобного и функционального фреймворка для интерфейсов. Использование классического трио HTML, CSS и JS позволяет авторам создавать любые UI-элементы с минимальными усилиями. Благодаря популярности веб-технологий, современные ИИ-инструменты отлично справляются с генерацией кода для этого мода, что значительно ускоряет процесс разработки.

Для авторов сборок наличие KubeJS (необязательно) позволяет создавать интерфейсы с крайне низким порогом обучения. Разработчики модов также могут использовать ApricityUI для создания высокорасширяемых интерфейсов, где возможности JS и Java API практически эквивалентны.

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

Синтаксис ApricityUI остается стабильным и максимально приближенным к веб-стандартам, что гарантирует совместимость между версиями игры и упрощает обновление проектов.

Начиная с версии 1.2.5, мод может использовать встроенный в операционную систему WebView. Это позволяет встраивать полноценные веб-страницы внутрь игры, которые принимают аппаратный ввод (включая воспроизведение видео).

ApricityUI полностью интегрирован в систему рендеринга Minecraft, позволяя выводить элементы в любое место игры.

• Интеграция с подсказками предметов и радиальными меню (через KubeJS).
• Поддержка Canvas для создания графиков, рисования SVG, сложных вложенных эффектов и досок для рисования.
• World windows: возможность рендеринга HTML-контента внутри мира с настройкой угла обзора, прохождения сквозь блоки, дистанции взаимодействия и слежения камеры.
• Нативные элементы Minecraft: управление слотами контейнеров, предметами, жидкостями, текстурами, моделями и анимациями спрайтов через HTML-подход.
• Редактор насыщенного текста (Rich text editor), создаваемый на основе данных.
• Поддержка масштабирования в стиле браузера: удерживайте CTRL и используйте колесико мыши для изменения масштаба страницы.

Для обеспечения независимости интерфейсов разных модов ApricityUI использует многодокументную архитектуру. Тег iframe в системе используется исключительно для встраивания WebView, который отрисовывается вне экрана в область фрейма.

WebView поддерживает только аппаратный ввод и не подходит для оверлеев или окон в мире из-за высокого потребления памяти. На некоторых системах (например, Linux) WebView может отсутствовать, но мод никогда не будет пытаться встроить его принудительно.

WebView компенсирует недостающее покрытие браузерных стандартов, позволяя отображать сложные страницы, не связанные с игрой напрямую (например, живую документацию, изменения или обучающие видео), а также создавать внутриигровые кинотеатры.

Использование ApricityUI не требует знания исходного кода мода. Все документы и навыки встроены в файл модуля, что позволяет использовать ИИ для генерации интерфейсов по текстовому описанию.

repositories {
    maven {
        url "https://maven.sighs.cc/repository/maven-public/"
    }
}
dependencies {
    implementation 'com.sighs:ApricityUI-forge-1.20.1:1.2.7'
}

В ресурс-менеджере можно импортировать и предварительно просматривать статические шаблоны, изображения, аудио и шрифты. Для предотвращения конфликтов клавиш горячие клавиши ресурс-менеджера по умолчанию не назначены.

Мод включает встроенные инструменты отладки, аналогичные инструментам разработчика в браузере. С их помощью можно выбирать элементы страницы, редактировать стили и содержимое напрямую с поддержкой отмены действий (Undo/Redo). Журналы ошибок и не поддерживаемые функции выводятся в консоль DevTools.

Поддерживаются форматы HTML, CSS, JavaScript, шрифты TTF/OTF и большинство форматов изображений, включая GIF. Ресурсы могут храниться в папке apricity в экземпляре версии или в ресурс-паках.

Для разработчиков сборок рекомендуется использовать папку apricity, так как она обеспечивает быструю горячую перезагрузку (по умолчанию клавиша END), занимающую менее секунды. Для модов, использующих ApricityUI как зависимость, лучше использовать ресурс-паки, так как они имеют приоритет в путях загрузки.

Мод также поддерживает асинхронную загрузку сетевых ресурсов (например, с хостингов) и предлагает возможность управления клиентским интерфейсом полностью со стороны сервера через отправку HTML.

• Без Chrome runtime: мод полностью написан на Java и не скачивает дополнительные компоненты.
• Производительность: в нормальных условиях узких мест нет, на версиях 26.1 и выше нагрузка минимальна.
• Зависимости: KubeJS необходим для работы JavaScript внутри HTML и доступа к консоли. Для разработчиков модов, работающих через Java API, это не обязательно.
• Горячая перезагрузка: поддерживает обновление документов почти мгновенно (менее секунды).