EpheroLib

Мод EpheroLib для Minecraft — абстракция кода между загрузчиками

EpheroLib — это библиотека-мод, созданная для упрощения разработки и совместимости проектов между загрузчиками Fabric и Forge. Она предоставляет набор инструментов, позволяющих разработчикам писать код один раз, а затем использовать его на разных платформах без необходимости дублирования логики. Проект включает в себя абстракцию для сетевых пакетов, систему конфигураций и механизмы локализации.

Цель и архитектура библиотеки

Основная задача EpheroLib заключается в создании общего фундамента для модов, работающих на Fabric и Forge. Автор проекта, TheThonk, собрал за три года опыта разработки решения, которое скрывает технические различия между этими платформами. Это позволяет создавать плагины и моды, не зависящие от конкретного загрузчика, что значительно упрощает поддержку и распространение контента.

Инструменты для конфигурации

Для управления настройками модов библиотека включает компонент configurate. Этот модуль обеспечивает единую систему конфигураций, доступную как для Fabric, так и для Forge. Разработчикам не нужно писать отдельные логики для чтения и сохранения файлов конфигурации под каждую платформу — EpheroLib берет на себя эту задачу, предоставляя стандартный интерфейс для взаимодействия с настройками.

Абстракция сетевого взаимодействия

Одной из ключевых особенностей библиотеки является метод абстракции сетевого взаимодействия. В Minecraft реализация пакетов (packets) сильно отличается между Fabric и Forge. EpheroLib скрывает эти различия, предоставляя разработчикам единый API для отправки и получения данных между клиентами и сервером. Это избавляет от необходимости поддерживать две разные версии сетевого кода для одного и того же функционала.

Локализация и хранение данных

Библиотека предлагает продвинутые решения для локализации и сохранения информации. Для текстовых переводов используется механизм на базе GSON, который обрабатывает переводы на стороне сервера. Это означает, что файлы локализации не нужно распространять на клиенте; достаточно передать их на сервер, и клиент автоматически получит перевод на языке, который он отправил. Также предусмотрен абстракционный слой для хранения данных, привязанных к конкретному миру (per-world storage), что удобно для модов, сохраняющих прогресс или настройки в мире.

Связанные материалы

• Fabric API — похожий мод
• Cloth Config API — похожий мод
• YetAnotherConfigLib (YACL) — похожий мод
• Fabric Language Kotlin — похожий мод
• Architectury API — похожий мод
• Just Enough Items (JEI) — похожий мод

Автор: TheThonk · Лицензия: LGPL-3.0-only