Мод E-Utils - серверная библиотека и API для модов [1.21–1.21.4] [1.20.x] [1.19] [1.18]

EverlastingUtils для Minecraft Fabric: серверная библиотека и API для модов​

EverlastingUtils — это серверная utility-библиотека и API для экосистемы Fabric, созданная для того, чтобы упростить разработку модов и закрыть типовые, но сложные задачи готовыми системами. Для обычного игрока её польза проста: если скачанный мод требует EverlastingUtils, библиотеку достаточно положить в папку mods и не вникать в технические детали. Для разработчиков это уже полноценный инструментальный слой с конфигами, планировщиком задач, командами, GUI и вспомогательными утилитами, который помогает сосредоточиться на уникальном контенте мода, а не на повторной реализации базовой инфраструктуры.

---

Суть и польза​

EverlastingUtils нужен в первую очередь как библиотека для Fabric-модов, которая снимает с разработчика часть рутинной и при этом ответственной работы. Во многих проектах постоянно повторяются одни и те же задачи: нужно хранить конфиги, безопасно запускать отложенные действия на сервере, строить команды через Brigadier, делать инвентарные GUI и держать под рукой полезные утилиты для логирования и форматирования текста. Вместо того чтобы заново писать всё это в каждом проекте, можно использовать один общий фундамент.

Главная польза библиотеки в том, что она ориентирована не на абстрактную универсальность, а на реальные потребности Fabric-разработки. Речь идёт о готовых, качественных системах, которые закрывают повседневные сценарии и помогают ускорить создание серверной логики. Благодаря этому разработчик тратит меньше времени на инфраструктуру и больше — на механику, контент и особенности собственного мода.

При этом EverlastingUtils полезен и игрокам, хотя намного проще. Если какой-то мод требует эту библиотеку как зависимость, пользователю не нужно разбираться в ConfigManager, планировщике или GUI-фреймворке. Вся практическая задача сводится к установке библиотеки в папку mods. Отдельно указано, что для более старых версий модов, которые требуют эту библиотеку, нужно использовать EverlastingUtils 1.0.2. Это важный момент для совместимости, особенно если сборка строится вокруг прошлых релизов.

С технической стороны у библиотеки есть обязательные зависимости: Fabric API и Fabric Language Kotlin. Это сразу показывает её целевую среду: Fabric-инструментарий и Kotlin-ориентированная разработка. Если говорить о том, кому EverlastingUtils подходит лучше всего, то это в первую очередь авторы модов, которым нужна готовая серверная основа без лишней самописной инфраструктуры.

---

Основные характеристики и как это работает​

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

Одна из самых сильных частей — ConfigManager. Это продвинутая система управления конфигами с типобезопасным доступом через Kotlin data class, поддержкой JSONC, комментариями, разделением на несколько файлов, живой перезагрузкой и автоматической миграцией версий. Практический смысл здесь очень большой. Конфиг можно читать безопасно, без лишнего шаблонного кода. Если владелец сервера меняет файл на диске, библиотека умеет подхватывать изменения без перезапуска. Если структура конфига в новой версии мода изменилась, система сравнивает версии и автоматически переносит существующие пользовательские настройки в обновлённый формат. Это особенно полезно в больших проектах, где конфиги разрастаются и часто обновляются.

Вторая важная часть — SchedulerManager. Это серверно-ориентированный планировщик задач, созданный с учётом жизненного цикла Minecraft-сервера. Он корректно завершает работу при остановке сервера и заново создаёт пул потоков при следующем запуске, чтобы избежать утечек и ошибок. Также в нём чётко разделены синхронные и асинхронные задачи. Это критически важно в Fabric-разработке: обращения к Minecraft API обычно должны выполняться на основном серверном потоке, а тяжёлую работу вроде запросов к базе данных удобнее выносить в отдельный поток. SchedulerManager позволяет задать этот режим явно, отслеживает задачи по уникальному ID и даёт возможность отменить их позже.

Третья крупная система — CommandManager. Это fluent-builder для Brigadier-команд с автоматической обработкой разрешений. Он поддерживает как ванильные уровни OP, так и Fabric Permissions API, что особенно полезно для серверных модов с административными и пользовательскими командами. В результате команды создаются с меньшим количеством шаблонного кода и остаются более читаемыми.

Четвёртый блок — GUI Framework, то есть системы CustomGui и AnvilGuiManager. Они предназначены для интерактивных GUI на основе инвентаря. Библиотека позволяет быстро открывать стандартные и anvil-тип интерфейсов, использовать callback-логику, динамические обновления и поддержку MiniMessage для заголовков и описаний. Это важная возможность для тех модов, где пользовательские интерфейсы — не второстепенная деталь, а часть основного опыта.

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

---

Как выбрать: критерии и чек-подход​

Выбирать EverlastingUtils стоит не как «ещё одну библиотеку для Minecraft», а как готовый серверный фундамент для Fabric-модов. Поэтому первый вопрос перед использованием очень простой: вы действительно пишете мод, которому нужны конфиги, задачи по расписанию, команды, GUI или вспомогательные утилиты? Если ответ положительный, библиотека начинает выглядеть очень уместно. Если проект минималистичный и не использует ничего из этого, установка зависимости может быть избыточной.

Первый критерий выбора — среда разработки. EverlastingUtils создавалась для Fabric modding toolchain и использует зависимости Fabric API и Fabric Language Kotlin. Это означает, что библиотека логично вписывается именно в такую экосистему. Если проект не связан с Fabric или не использует Kotlin-ориентированный стек, она не будет естественным выбором.

Второй критерий — объём повторяющейся инфраструктуры в моде. Чем чаще в проекте возникает необходимость делать конфиги, планировщик, команды и GUI, тем сильнее раскрывается польза библиотеки. Если вы каждый раз пишете похожую серверную основу с нуля, EverlastingUtils позволяет заменить это готовыми системами. Если же мод очень узкий и почти не имеет инфраструктурной логики, выгода будет меньше.

Третий критерий — важность корректной серверной работы. Например, встроенный SchedulerManager ценен не просто тем, что умеет запускать задачи, а тем, что учитывает жизненный цикл сервера, различает sync и async, работает через общий управляемый пул потоков и избегает типичных проблем конкурентности. Если ваш мод вообще не выходит за рамки простейших обработчиков, это может быть не так важно. Если же проект растёт и становится сложнее, такая база начинает серьёзно экономить время и снижать риск ошибок.

Четвёртый критерий — требования игроков. Если вы не разрабатываете мод, а просто устанавливаете зависимость для сборки, всё ещё проще:

• мод прямо требует EverlastingUtils;
• у вас установлен Fabric API;
• у вас установлен Fabric Language Kotlin;
• при использовании старых версий зависимых модов вы учитываете необходимость EverlastingUtils 1.0.2.

Для разработчика быстрый чек-подход выглядит так:

• мод серверный или сильно завязан на серверную логику;
• нужны конфиги с живой перезагрузкой и миграцией;
• нужен безопасный планировщик задач;
• хочется меньше шаблонного кода для Brigadier-команд;
• требуются интерактивные inventory GUI;
• нужен единый utility-слой вместо разрозненного самописного кода.

Если этот список соответствует проекту, EverlastingUtils выглядит практичным и оправданным выбором.

---

Пошагово: как использовать библиотеку и что нужно для старта​

Для обычного игрока работа с EverlastingUtils начинается и заканчивается установкой. Если другой мод требует эту библиотеку, достаточно скачать её и положить в папку mods вместе с зависимостями. Важный нюанс — наличие Fabric API и Fabric Language Kotlin, потому что без них библиотека не соответствует заявленным требованиям. Если речь идёт о старых версиях модов, использующих EverlastingUtils, стоит брать версию 1.0.2, поскольку это отдельно указано как подходящий legacy-вариант.

Для разработчика старт уже более предметный. Сначала библиотеку нужно добавить в зависимости проекта. Для этого в build.gradle.kts подключается репозиторий Modrinth Maven, а затем добавляется зависимость вида modImplementation("maven.modrinth:e-utils:1.1.2") с заменой на нужную актуальную версию. После этого в fabric.mod.json нужно объявить зависимость через блок depends, указав минимально требуемую версию библиотеки.

Дальше сценарий зависит от того, какую систему вы хотите использовать. Если нужен конфиг, создаётся структура на Kotlin data class, реализующая ConfigData. Затем инициализируется ConfigManager, которому передаются текущая версия мода, defaultConfig, класс конфига и при желании метаданные с заголовками и описаниями полей. После этого конфиг можно безопасно читать в любом месте проекта через getCurrentConfig. Такой подход особенно полезен, когда нужно не просто хранить значения, а поддерживать комментарии, версии и многофайловую структуру.

Если требуется планировщик, работа начинается с получения экземпляра MinecraftServer, например внутри server lifecycle-события. Затем через SchedulerManager можно запустить повторяющуюся или отложенную задачу, указав её ID, сервер, начальную задержку, период, единицу времени и флаг runAsync. Здесь важно помнить: если задача взаимодействует с Minecraft API, запускать её нужно синхронно, то есть на основном серверном потоке.

Для команд используется CommandManager с указанием modId. Через fluent-builder описываются команда, подкоманды и требования к доступу, после чего команда регистрируется. Для GUI применяется CustomGui или AnvilGuiManager, где задаются layout, callback на взаимодействие и логика закрытия. В итоге библиотека позволяет подключать нужные подсистемы постепенно, а не заставляет использовать всё сразу.

Практически это выглядит так: сначала вы решаете, какие стандартные серверные задачи нужны модификации, потом подключаете EverlastingUtils как dependency, после чего берёте только те модули, которые реально нужны проекту. Именно за счёт этого библиотека удобна и в небольших модах, и в более крупных системах.

---

Частые ошибки и как их избежать​

Одна из самых распространённых ошибок — считать EverlastingUtils самостоятельным контент-модом для игроков. На самом деле это utility и API library, то есть инфраструктурная зависимость и инструмент для разработки. Если пользователь ожидает от неё новых предметов, механик или геймплея, он просто неверно понимает её назначение. Для игрока польза появляется только тогда, когда какой-то другой мод требует эту библиотеку.

Вторая ошибка — забывать про зависимости. В описании чётко указаны Fabric API и Fabric Language Kotlin. Если библиотека установлена без них, возникают проблемы совместимости или запуска. Это особенно важно в сборках, где часть зависимостей ставится автоматически, а часть — вручную. Проверять полный набор лучше сразу, а не после первых ошибок в загрузке.

Третья ошибка связана со старыми версиями модов. Для legacy-сборок отдельно указано, что нужно использовать EverlastingUtils 1.0.2. Если взять более новую версию «на всякий случай», можно получить не тот результат, которого ожидает старый зависимый мод. Это типичный случай, когда проблема кроется не в самой библиотеке, а в несовпадении версий.

Четвёртая ошибка уже относится к разработке: запускать тяжёлые задачи или обращения к Minecraft API без учёта sync/async-логики. SchedulerManager как раз и ценен тем, что помогает развести эти случаи корректно. Но если игнорировать смысл runAsync и использовать планировщик без понимания серверного потока, можно свести преимущество библиотеки на нет. Здесь важно помнить простое правило: Minecraft API — на основном потоке, тяжёлая внешняя работа — в отдельных.

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

---

FAQ​

Что такое EverlastingUtils в Minecraft Fabric?

EverlastingUtils — это серверная utility-библиотека и API для Fabric-модов. Она не добавляет контент сама по себе, а предоставляет разработчикам готовые системы для конфигов, планировщика задач, команд, GUI и разных вспомогательных утилит. Для обычного игрока это чаще всего просто зависимость, которую нужно установить, если другой мод её требует.

Нужна ли EverlastingUtils обычному игроку?

Да, но только как библиотека-зависимость. Если скачанный мод пишет, что ему нужна EverlastingUtils, игроку достаточно поставить её в папку mods. В технические детали вникать не нужно. Отдельно уточняется, что для старых версий модов, завязанных на эту библиотеку, следует использовать версию 1.0.2.

Какие зависимости требуются для EverlastingUtils?

В описании указаны две обязательные зависимости: Fabric API и Fabric Language Kotlin. Это значит, что библиотека рассчитана на Fabric-среду и Kotlin-ориентированный стек. Без этих компонентов установка не соответствует заявленным требованиям, поэтому их нужно учитывать заранее при сборке модпака или разработке собственного проекта.

Какие главные системы есть в EverlastingUtils?

Библиотека включает несколько базовых блоков: ConfigManager для работы с конфигами, SchedulerManager для серверного планирования задач, CommandManager для Brigadier-команд, CustomGui и AnvilGuiManager для GUI, а также набор утилит вроде MiniMessage-парсинга и переключаемого debug-логирования. Всё это предназначено для ускорения разработки серверных модов.

Чем полезен ConfigManager?

ConfigManager даёт типобезопасный доступ к конфигам через Kotlin data class, поддерживает JSONC, умеет автоматически перезагружать конфиги при изменении файлов на диске, работать с несколькими конфигурационными файлами и автоматически мигрировать пользовательские настройки при смене версии мода. Это делает конфигурацию более удобной и устойчивой к обновлениям.

Как работает SchedulerManager?

SchedulerManager привязан к жизненному циклу сервера. Он корректно завершает работу при остановке сервера и пересоздаёт потоковый пул при рестарте. Также он позволяет явно выбирать синхронное или асинхронное выполнение задачи. Это важно для безопасной работы с Minecraft API и тяжёлыми внешними операциями. У каждой задачи есть уникальный ID, поэтому её можно позже отменить.

Есть ли в библиотеке система команд и GUI?

Да. CommandManager помогает строить Brigadier-команды с меньшим количеством шаблонного кода и учитывает права доступа, включая ванильные OP-уровни и Fabric Permissions API. GUI-фреймворк позволяет создавать интерактивные инвентарные интерфейсы, в том числе anvil-варианты, с callback-логикой, динамическими обновлениями и поддержкой MiniMessage для заголовков и описаний.

Как подключить EverlastingUtils в свой мод?

Для разработчика процесс начинается с добавления Modrinth Maven-репозитория в build.gradle.kts, затем библиотека подключается как modImplementation с нужной версией. После этого в fabric.mod.json объявляется зависимость через блок depends. Дальше можно постепенно использовать отдельные модули библиотеки — конфиги, планировщик, команды или GUI — в зависимости от задач проекта.

---

Как установить EverlastingUtils​

1. Скачай и установи Minecraft Fabric
2. Скачай мод
3. Не распаковывая, скопируй в .minecraft\mods
4. Готово

---

Итог​

EverlastingUtils — это сильная серверная библиотека для Fabric-разработки, которая даёт готовый набор систем для конфигов, задач, команд, GUI и полезных утилит, тем самым заметно ускоряя создание модов и снижая объём повторяющегося кода. Для игроков она остаётся простой зависимостью, которую нужно установить, если того требует другой мод. Для разработчиков же это уже полноценный рабочий инструмент, особенно полезный в тех проектах, где важны типобезопасные конфиги, корректная серверная многопоточность и удобная инфраструктура вокруг Fabric. Если мод или сборка требует EverlastingUtils, её стоит рассматривать не как лишний довесок, а как основу, на которой держится часть логики.