Refraction

Refraction - это библиотека (API), созданная для того, чтобы разработчики модов не писали одну и ту же логику с нуля в каждом проекте. Если вы когда-нибудь задумывались, как добавить в свой мод катсцены, гибкие конфиги, синхронизацию данных между клиентом и сервером или систему квестов - Refraction уже всё это умеет. Просто подключаете и используете.

Разработана проект ZeusIGN и ConnorTron110 и заточена под мультизагрузчик (Fabric, Forge, NeoForge и другие), так что работает везде, где вам нужно.

Что Refraction даёт разработчику

• ReConfig - система конфигов с автосинхронизацией. Игроки меняют настройки - они сразу применяются на сервере.
• Atda - постоянное хранение данных (не теряются при перезапуске).
• Syncables - автоматическая синхронизация классов с сервера на клиент.
• Channels - кастомные каналы данных между сервером и клиентом с поддержкой заголовков. Удобно для своей сетевой логики.
• NamedAPI - расширение Channels для именованных API-схем.
• Runnabler - обработчик отложенных и тиковых задач на клиенте и сервере.
• RefractionEvents - собственная система событий, работающая на любом загрузчике.
• VoxelUtils - утилиты для генерации вокселей (полезно для кастомных структур).
• Particler - обёртка над частицами с управлением рендером и тиками.
• RAABB - невыровненные по осям коллизии (AABB), которые нужны для наклонных блоков или сложных форм.
• Cutscenes - катсцены, настраиваемые через код. В будущем появится поддержка команд.
• Кастомные дебаггеры - похожи на стандартную систему отладки Майнкрафт, но расширенные.
• Interactions - обработчик взаимодействий с NPC.
• Quests - система квестов (без стекования по умолчанию, но это могут изменить).
• Server Screens - полный контроль над экранами на стороне сервера: открытие, закрытие, обмен данными без лишних пакетов.
• Регистрируемые отслеживаемые звуки - тикающие звуки, которые можно зарегистрировать на клиенте и вызывать с сервера.
• Flood Filler - гибкий заливщик областей (например, для заполнения резервуаров жидкостью).
• Camera shake - интерфейс для тряски камеры (эффекты взрывов, землетрясений).
• SyncConfig - автоматическая синхронизация конфига при входе игрока.
• Vec3Helper - множество утилит для работы с векторами.

И это далеко не всё - основная часть функционала спрятана в директориях @helper и @feature. Проект реально большой, и если вы пишете мод со сложной механикой - Refraction сэкономит вам кучу времени. Скачайте библиотеку и подключите к своему проекту - всё заведётся из коробки.

Refraction работает на Minecraft 1.19+ (актуальные версии уточняйте на странице загрузки) и поддерживает все популярные загрузчики. Идеально подходит для мододелов, которые хотят сосредоточиться на геймплее, а не на инфраструктуре.