Eunomia

Eunomia - это библиотека для Minecraft Java, а не самостоятельный контентный мод. Она предназначена разработчикам модов и серверных плагинов, которым нужно наладить связь между клиентом и сервером, передавать сетевые пакеты, синхронизировать настройки и собирать интерфейсы без большого количества повторяющегося кода.

Проект поддерживает разные платформы и загрузчики: Fabric, Quilt, NeoForge, Paper, Bukkit и Folia. За счет этого Eunomia подходит для разработки решений, которые должны работать в нескольких окружениях Minecraft, а не только в одном конкретном загрузчике.

Зачем нужна Eunomia

В обычном проекте разработчику приходится отдельно продумывать сетевое взаимодействие, формат сериализации данных, передачу конфигураций и обработку сообщений между сторонами. Для небольшого мода это быстро превращается в лишний технический слой: игровой функции еще нет, а клиент и сервер уже требуют немало связующего кода.

Eunomia берет эту рутину на себя. Библиотека предоставляет основу для communication framework, то есть единого слоя общения между клиентом и сервером. Благодаря этому разработчик может сосредоточиться на механике мода или логике плагина, а не на повторной реализации сетевой инфраструктуры.

На стороне игрока это обычно не выглядит как отдельная новая механика. В Minecraft не появляются новые биомы, предметы или мобы. Зато проекты, использующие Eunomia, могут надежнее передавать данные, быстрее синхронизировать параметры и удобнее показывать настройки через интерфейс, похожий на стандартный интерфейс игры.

Что предоставляет библиотека

• Сетевое взаимодействие между клиентом и сервером
• Работу с пакетами для передачи данных внутри проекта
• Сериализацию объектов и значений перед отправкой по сети
• Синхронизацию конфигураций с удобными настройками по умолчанию
• Инструменты для коммуникации между разными сторонами игры
• API для клиентских toast-уведомлений, которые появляются в интерфейсе Minecraft
• Fluent API конфигураций, позволяющий описывать параметры более удобным и читаемым способом
• Средства создания нативно выглядящих интерфейсов, чтобы экраны мода не выбивались из привычного оформления игры

Где используется Eunomia

Eunomia распространяется как набор компонентов eunomia-core, eunomia-common и Paper-плагин. Такой подход позволяет использовать общую основу в разных типах проектов, сохраняя разделение между универсальной логикой и кодом конкретной платформы.

Поддерживаются следующие варианты:

• Fabric - Minecraft 1.20.1 и новее, включая актуальные версии 26.x
• Quilt - для проектов, рассчитанных на этот загрузчик
• NeoForge - Minecraft 1.21.1 и новее, включая версии 26.x
• Forge - Minecraft 1.20.1
• Paper, Bukkit и Purpur - Minecraft 1.20.1 и новее, включая версии 26.x
• Folia - для серверных проектов, которым нужна совместимость с этой платформой

Точный артефакт зависит от того, где запускается проект: библиотека для Fabric-мода и серверный плагин для Paper не являются одной и той же установкой. Перед подключением стоит проверить версию Minecraft и нужную платформу, особенно если проект собирается сразу под несколько загрузчиков.

Что изменится у игрока

Сам по себе Eunomia почти не меняет игровой процесс. Это техническая зависимость, которая работает в фоне. Игрок заметит ее только через функции другого мода или плагина: например, через более удобное меню настроек, синхронизацию параметров между клиентом и сервером или небольшое уведомление в виде стандартного toast-сообщения.

Поэтому Eunomia не стоит рассматривать как контентный мод для выживания, PvP или строительства. Это скорее фундамент для других проектов. Если библиотека указана в зависимостях, удалить ее без проверки нельзя: мод или плагин, который использует ее сетевые классы и API конфигураций, может перестать запускаться.

Важный нюанс для разработчиков

Eunomia рассчитана на проекты без жесткой привязки к одному загрузчику. Это удобно при переносе общей логики между Fabric, NeoForge и серверными платформами, но платформенный код все равно нужно проверять отдельно. Наличие общей библиотеки не означает, что любой мод автоматически станет совместимым со всеми загрузчиками.

Еще один практический момент касается версий. Fabric-проект для Minecraft 1.20.1, NeoForge-сборка для 1.21.1 и Paper-плагин используют разные окружения, поэтому при обновлении игры важно подобрать соответствующий компонент Eunomia. Несовпадение версии Minecraft, загрузчика или серверного ядра может проявиться еще до входа в мир, на этапе загрузки зависимостей.

Для автора мода это полезный выбор, когда нужны пакеты, сериализация, сетевые сообщения и конфигурации в одном общем решении. Для администратора сервера Eunomia имеет смысл только как зависимость конкретного плагина, а не как отдельная игровая функция.

Итог

Eunomia - небольшая open-source библиотека с лицензией MIT для разработчиков модов и плагинов Minecraft Java. Она закрывает техническую часть проекта: связь клиента и сервера, сетевые пакеты, сериализацию, синхронизацию настроек, toast-уведомления и создание интерфейсов в стиле Minecraft.

Проект не добавляет самостоятельный контент и не предназначен для изменения выживания. Его ценность в другом: разработчик подключает готовую основу и тратит меньше времени на инфраструктуру, которая обычно повторяется из проекта в проект.