Unruled API — расширенные игровые правила в Minecraft

Unruled API для Minecraft позволяет создавать игровые правила с плавающими, строковыми и enum-значениями. Узнайте, как установить и использовать мод.

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 делает библиотеку универсальным выбором для современных сборок.