Home

Lumina UI — библиотека для красивых, быстрых и гибких интерфейсов в модах Minecraft. Forge 1.20.1 и NeoForge 1.21.1, один API для обеих версий.

🇬🇧 English version: English

С чего начать

1. Установка — подключить библиотеку к моду (5 минут).
2. Первый экран — открыть свой первый экран.
3. Каталог виджетов — посмотреть, что есть готового.

Живая витрина всех возможностей — тестовый мод luminatest: клавиша K в мире или команда /luminatest.

Я хочу…

Задача	Страница
Сделать экран настроек своего мода	[[Экран настроек
Свой сундук или машину с окном	Окна-контейнеры
Полоски и уведомления поверх игры	HUD
Сверстать экран на HTML и CSS	[[HTML и CSS
Перекрасить интерфейс под свой стиль	[[Стили и темы
Плавно анимировать кнопку или панель	Анимации
Показать моба, предмет или постройку в 3D	[[Мобы, предметы и 3D
Перевести интерфейс на другие языки	Языки
Написать свой виджет	Расширение

Все разделы

Начало работы

• Установка — как подключить Lumina UI к своему моду на Forge 1.20.1 или NeoForge 1.21.1.
• Первый экран — пишем первый экран и разбираемся, из чего состоит интерфейс.

Основы

• Раскладка — как расставить элементы: flexbox, слои, сетка, размеры, адаптивность.
• Стили и темы — стили виджетов, состояния, темы и токены.
• Цвета и градиенты — цвета в разных пространствах, градиенты и кисти.
• Анимации — анимации свойств, ключевые кадры, таймлайны, кривые и пружины.
• Данные и сигналы — как связать данные с интерфейсом, чтобы он обновлялся сам.
• События и ввод — мышь, клавиатура, фокус и геймпад.

Виджеты

• Каталог виджетов — все виджеты по группам и самые ходовые компоненты.
• Всплывающие окна — выпадающие списки, подсказки, контекстное и радиальное меню, календарь.
• Формы — проверка ввода, формы и мастер настройки.
• Markdown и книги — многострочный текст в Markdown, книги и подсветка кода.

Игра

• Инвентарь и слоты — стопки, слоты, сетки и перетаскивание предметов.
• Окна-контейнеры — свои сундуки и машины с окном на Lumina, которые синхронизирует сервер.
• Мобы, предметы и 3D — сущности, предметы и постройки в 3D, карты из блоков и превью мира.
• HUD — интерфейс поверх игры и живые данные игрока.
• Карты — мини-карта и карта мира.

Оформление

• Эффекты — огонь, взрывы, TNT, погода и частицы прямо в интерфейсе.
• Размытие, обрезка и GIF — размытие фона, точная скруглённая обрезка и анимированные картинки.

HTML и CSS

• HTML и CSS — экраны на разметке и стилях: быстрый старт, теги и CSS.

Возможности

• Языки — смена языка на лету и переводы.
• Экран настроек — готовый экран настроек по простому описанию.
• Доступность и звуки — дальтонизм, высокий контраст, масштаб текста и звуки интерфейса.

Для продвинутых

• Расширение — свои виджеты, свойства, события, раскладки и теги.
• Отладка и советы — инспектор интерфейса, производительность и частые ошибки.
• Архитектура — как Lumina UI устроена внутри.

Лицензия

GNU LGPL 3.0: библиотеку можно использовать в любых модах, в том числе с закрытым кодом. Исходники: github.com/ssbaxys/lumina-ui.