VoxelUI

VoxelUI

VoxelUI — это современный UI-фреймворк для Minecraft NeoForge 1.21.1. Он создан для разработчиков модов, которые хотят создавать богатые, поддерживаемые, нативные интерфейсы Minecraft, не полагаясь на большие PNG-атласы UI.

Уведомление о бета-релизе

VoxelUI сейчас находится в публичной бете. Этот релиз предназначен для того, чтобы:

• проверить фреймворк в реальных сценариях моддинга
• собрать сообщения об ошибках
• выявить слабые места в API и системе компонентов
• стабилизировать движок перед будущим стабильным релизом Следует ожидать:
• баги
• незавершённое или сырое поведение некоторых компонентов
• изменения API между бета-версиями
• регрессии вёрстки или рендеринга в редких случаях Если вы протестируете VoxelUI и сообщите о проблемах, это чрезвычайно полезно для доведения проекта до стабильного релиза.

Что предоставляет VoxelUI

• XML-разметка экранов
• система стилей MCSS с поддержкой каскада
• переиспользуемые UI-компоненты
• централизованное тематическое оформление
• современные контейнеры вёрстки
• UI-компоненты, специфичные для Minecraft
• инструменты разработчика для инспекции и итераций

Основные возможности

Вёрстка и композиция

• Panel
• Grid
• Stack
• Tabs
• ScrollPanel
• ListView

Интерактивные компоненты

• Button
• TextInput
• Checkbox
• Slider
• Dropdown

Компоненты, ориентированные на Minecraft

• ItemStackView
• InventoryGrid
• ItemSlot

Стилизация и инструменты

• XML-загрузчик UI
• встроенные и внешние таблицы стилей MCSS
• каскад стилей с вычисляемыми стилями
• инспектор UI
• горячая перезагрузка в среде разработки
• безопасные панели-заглушки при ошибках XML
• анимированные переходы UI, такие как наведение и плавная прокрутка

Сценарии использования

VoxelUI предназначен для создания интерфейсов, таких как:

• экраны конфигурации
• журналы заданий
• пользовательские инвентари
• магазины
• админ-панели
• HUD-оверлеи
• экраны UI на основе данных

Философия

VoxelUI не пытается встроить браузер внутрь Minecraft. Вместо этого он привносит более современный подход к UI в нативный рендеринг Minecraft:

• декларативный
• модульный
• тематизируемый
• переиспользуемый
• нативный для рендерера

Текущий статус

VoxelUI — это фреймворк/библиотечный мод, а не самостоятельный контентный мод. В релизных сборках внутренние демонстрационные и отладочные инструменты отключены по умолчанию. В сборках для разработки они остаются доступными для итераций и инспекции. Этот проект пока не представлен как полностью стабильный. Цель этой бета-фазы — укрепить фреймворк через отзывы из реального использования, прежде чем зафиксировать более стабильную поверхность API.

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

• Minecraft: 1.21.1
• Загрузчик: NeoForge
• Java: 21

Для разработчиков

VoxelUI предназначен для использования в качестве основы для других модов, которым нужны структурированные UI-системы. Он включает:

• конвейер measure -> layout -> render
• построение экранов на основе XML
• переиспользуемые привязки времени выполнения
• стилизацию MCSS
• интеграцию с нативным рендерингом Minecraft

Отзывы приветствуются

Если вы используете эту бету, наиболее полезные отзывы:

• воспроизводимые баги
• сломанная вёрстка
• проблемы с рендерингом
• неясный или неудобный дизайн API
• отсутствующие функции, блокирующие реальное использование
• неожиданное поведение между XML, MCSS и привязками времени выполнения

Лицензия

Apache License 2.0