FramingLib

Framing Lib

Лёгкая клиентская библиотека экранов конфигурации для создания интерактивных экранов с перетаскиваемыми элементами HUD!

📖 Что это за мод?

Это клиентская библиотека экранов конфигурации для создания экранов с перетаскиваемыми элементами HUD. Она позволяет разработчикам создавать экраны конфигурации с интерактивными перетаскиваемыми элементами, чтобы игроку было проще располагать свои элементы HUD/GUI.
Это не полноценный API конфигурации, а всего лишь инструмент для создания экранов конфигурации. По сути, он нужен другим модам, которые на него опираются. Вот несколько визуальных примеров, показывающих, что он умеет: Более практичный пример — перемещение чата:

✅ Возможности

• Поддержка нескольких загрузчиков: полная совместимость с Fabric, Quilt, Forge и NeoForge
• Понятно игрокам: позволяет перемещать элементы HUD/GUI, просто перетаскивая их мышью
• Удобный API для разработчиков: использует простой паттерн builder, что упрощает интеграцию в любой мод с HUD/GUI
• Динамическое выравнивание: автоматически привязывает элементы HUD/GUI к девяти позициям экрана, с опциональной привязкой
• Умный пересчёт: пересчитывает расположение элементов HUD/GUI при изменении масштаба GUI или размера окна
• Лёгкий и производительный: кэширует и пересчитывает позиции только при необходимости, экономя кадры
• Только на клиенте: устанавливается только на клиент, не требует установки на сервере и не оставляет следа на серверной стороне
• Широкие возможности настройки: поддерживает собственные цвета, иконки и даже собственные функции рендеринга

⚠️ Чтобы сохранить гибкость, эта библиотека не сохраняет и не загружает данные о расположении на диск автоматически. Разработчики сами отвечают за сериализацию объекта расположения (в JSON/YAML/INI/любой удобный формат конфигурации) и его десериализацию при запуске игры.

📖 Использование

📖 Для игроков

⚠️️ Это библиотечный мод, сам по себе он ничего не делает. Поместите jar-файл в папку mods — и всё готово! Для версий [Fabric] и [Quilt], скорее всего, также потребуется положить в папку mods [ModMenu].

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

Документация для разработчиков доступна здесь

🚀 Поддерживаемые версии

Minecraft	Fabric	Quilt	Forge	NeoForge
26.2	⏳	⏳	⏳	⏳
26.1.2	⏳	⏳	⏳	⏳
26.1.1	⏳	⏳	⏳	⏳
26.1	⏳	⏳	⏳	⏳
1.21.11	⏳	⏳	⏳	⏳
1.21.10	⏳	⏳	⏳	⏳
1.21.9	⏳	⏳	⏳	⏳
1.21.8	⏳	⏳	⏳	⏳
1.21.7	⏳	⏳	⏳	⏳
1.21.6	⏳	⏳	⏳	⏳
1.21.5	⏳	⏳	⏳	⏳
1.21.4	⏳	⏳	⏳	⏳
1.21.3	⏳	⏳	⏳	⏳
1.21.2	⏳	⏳	⏳	⏳
1.21.1	⏳	⏳	⏳	⏳
1.21	⏳	⏳	⏳	⏳
1.20.6	⏳	⏳	⏳	⏳
1.20.5	⏳	⏳	⏳	⏳
1.20.4	⏳	⏳	⏳	⏳
1.20.3	❌	❌	❌	❌
1.20.2	⏳	⏳	⏳	⏳
1.20.1	⏳	⏳	⏳	⏳
1.20	⏳	⏳	⏳	❌
1.19.4	✅(1.0.15)	✅(1.0.15)	✅(1.0.15)	❌
1.19.3	✅(1.0.14)	✅(1.0.14)	✅(1.0.14)	❌
1.19.2	✅(1.0.13)	✅(1.0.13)	✅(1.0.13)	❌
1.19.1	✅(1.0.12)	✅(1.0.12)	✅(1.0.12)	❌
1.19	✅(1.0.11)	✅(1.0.11)	✅(1.0.11)	❌
1.18.2	✅(1.0.10)	✅(1.0.10)	✅(1.0.10)	❌
1.18.1	✅(1.0.9)	✅(1.0.9)	✅(1.0.9)	❌
1.18	✅(1.0.8)	✅(1.0.8)	✅(1.0.8)	❌
1.17.1	✅(1.0.7)	✅(1.0.7)	✅(1.0.7)	❌
1.17	❌	❌	❌	❌
1.16.5	✅(1.0.2)	✅(1.0.2)	✅(1.0.2)	❌

✅ — поддерживается ⏳ — запланировано ⏳ — не поддерживается Примечания:

• Последняя версия мода указана в скобках