Unruled API: расширенные игровые правила в Minecraft
Стандартные игровые правила Minecraft давно перестали быть гибким инструментом: разработчик ограничен целыми числами и булевыми значениями. Если вы пишете мод и хотите дать игрокам или серверу более тонкую настройку, на помощь приходит Unruled API — библиотека, которая снимает эти ограничения и позволяет создавать собственные типы правил. Разберёмся, что она умеет, как её установить и как встроить в свой проект.
Что такое Unruled API и зачем он нужен
Unruled API — это мод-библиотека для Minecraft, ориентированная в первую очередь на разработчиков модов, хотя пригодится она и тем, кто собирает сложные сборки с тонкой настройкой поведения мира. В ванильной игре игровые правила (gamerules) умеют хранить только целые числа и булевы значения. Этого мало, когда нужно задать, например, множитель скорости, строковый префикс чата или режим из фиксированного набора вариантов.
Мод позволяет регистрировать новые правила с типами float, long, double, string, text и enum. При этом сами правила не регистрируются автоматически — вы создаёте их вручную через генеративные статические методы класса mc.recraftors.unruled_api.UnruledApi. Для единообразия добавлены и методы для инстанцирования ванильных правил, чтобы код оставался консистентным.
Простой пример регистрации выглядит так: вы вызываете registerGamerule и передаёте в него результат UnruledApi.createFloat(1.5), UnruledApi.createString("some text") или UnruledApi.createBoolean(false, callback) — последний вариант поддерживает обработчик изменения значения. Читать значения удобно через интерфейс IGameRulesProvider, например unruled_getString или unruled_getFloat.
Поддерживаемые версии и загрузчики
Unruled API для Minecraft распространяется как кроссплатформенная библиотека и собирается под современные версии игры с загрузчиками Fabric и Forge. Благодаря этому мод подходит и для лёгких Fabric-сборок, и для классических Forge-профилей. Перед установкой обязательно сверьте поддерживаемую версию Minecraft и загрузчика на странице проекта — библиотеки такого рода чувствительны к мажорным обновлениям игры.
Если вы собираете сборку вручную, удобно держать все дополнения в одном месте: в лаунчере foxygame.net каталог дополнений позволяет подобрать совместимую версию Unruled API под конкретный профиль игры без ручного поиска jar-файлов.
Как установить Unruled API
Установка не отличается от типичного мод-процесса. Скачать Unruled API можно со страницы проекта на Modrinth или CurseForge — там же лежит официальная документация. Порядок действий такой:
- Убедитесь, что у вас установлен Fabric Loader или Forge нужной версии.
- Скачайте jar-файл библиотеки, соответствующий вашей версии Minecraft.
- Поместите файл в папку
modsв директории игры. - Если мод используется как зависимость другого мода, проверьте, что версии совпадают.
- Запустите игру и убедитесь, что библиотека загрузилась без конфликтов.
Отдельно стоит помнить: Unruled API — это именно библиотека. Сама по себе она не добавляет видимого контента в игру, её эффект проявляется только через моды, которые её используют.
Использование в разработке модов
Подключение через Maven
Чтобы встроить библиотеку в свой проект, добавьте репозиторий Modrinth в блок repositories и укажите зависимость в dependencies. Для Loom используется modApi "maven.modrinth:unruled-api:${project.unruled_version}", для ForgeGradle — implementation с тем же артефактом. Такой подход позволяет вашим зависимым проектам тоже подтягивать библиотеку автоматически.
Ограничения и правила распространения
Автор прямо просит не включать мод внутрь собственных сборок через jar-in-a-jar, shadow и подобные механизмы — это запрещено по причинам авторских прав. Вместо этого указывайте Unruled API как внешнюю зависимость. Если возникнут вопросы, поддержка доступна в официальном Discord-сообществе проекта.
Кому стоит обратить внимание
Рядовому игроку библиотека вряд ли интересна напрямую, зато разработчикам модов она экономит часы работы: вместо самописной системы настроек достаточно нескольких статических вызовов. Администраторам серверов она полезна косвенно — через моды, которые дают более гибкую конфигурацию мира. Если вы ищете способ вывести настройки своего мода за пределы ванильных ограничений, Unruled API станет аккуратным и предсказуемым фундаментом.
В итоге Unruled API закрывает узкую, но болезненную нишу: расширяет систему игровых правил Minecraft до полноценных типизированных настроек. Установка простая, интеграция в проект — через Maven, а совместимость с Fabric и Forge делает библиотеку универсальным выбором для современных сборок.