Core Lib API
Если вы когда-нибудь заглядывали в исходники модов от sakuraryoko, то наверняка замечали, что многие из них опираются на общую базу. Эта база — Core Lib API, библиотечное ядро, которое автор вынес из своего мода AfkPlus, чтобы не дублировать код в каждом новом проекте. Проще говоря, это фундамент, на котором строятся все текущие и будущие моды разработчика.
Сразу проясним важный момент: Core Lib API не имеет отношения к MaLiLib. Это самостоятельная библиотека, созданная исключительно для модов sakuraryoko. Она почти не использует Fabric API — единственное исключение связано с получением рабочей директории игры и определением статуса «Running in IDE». Всё остальное реализовано собственными средствами.
Что умеет Core Lib API
Библиотека задумана в первую очередь как серверная. Это значит, что графического интерфейса в ней нет и не планируется — не ждите GUI-элементов. Зато набор инструментов для бэкенда мода внушительный. Вот основные возможности:
- Стандартизация инициализации модов через Mod Init Dispatcher;
- Управление конфигурационными файлами с помощью Config Dispatcher;
- События клиента, игрока и сервера;
- Интерфейс серверных команд;
- Управление потоками (thread management);
- Сетевой интерфейс — пока в разработке, но уже рабочий;
- Форматирование текста через стандартную утилиту;
- Форматирование времени, даты и длительности;
- Менеджер переводов i18n;
- Работа с CSV-файлами через csvtool.
Для разработчиков это означает меньше рутины: вместо того чтобы писать одну и ту же обвязку для конфигов или команд в каждом моде, вы подключаете Core Lib API и сосредотачиваетесь на логике. Автор рекомендует начинать с создания Mod Init Dispatcher и Config Dispatcher — примеры лежат прямо в исходном коде библиотеки.
Поддерживаемые версии и загрузчик
Core Lib API для Minecraft распространяется как Fabric-мод. Это логично: sakuraryoko работает именно с Fabric, и все его проекты ориентированы на этот загрузчик. Библиотека не является самостоятельным игровым контентом — она нужна как зависимость для других модов, поэтому в списке модов она будет работать в фоне, не добавляя новых предметов или блоков.
Что касается версий Minecraft, здесь действует простое правило: используйте ту сборку библиотеки, которая соответствует вашей версии игры. Артефакты публикуются через Maven-репозиторий sakuraryoko, а формат версии выглядит как core_lib_version-mcminecraft_version. То есть номер версии Core Lib API идёт первым, а через дефис указывается версия Minecraft, для которой собран билд. Такой подход позволяет держать несколько веток под разные релизы игры одновременно.
Как установить Core Lib API
Установка не отличается от других Fabric-модов. Сначала убедитесь, что у вас стоит Fabric Loader подходящей версии и сам Fabric API. Затем поместите файл библиотеки в папку mods вашего профиля. Если Core Lib API нужен как зависимость для другого мода, просто добавьте его рядом — порядок загрузки игра разрулит сама.
Тем, кто предпочитает не возиться с ручным копированием файлов, стоит присмотреться к лаунчеру foxygame.net: там Core Lib API добавляется в сборку буквально в один клик, а каталог дополнений сам подбирает совместимую версию под ваш профиль. Это заметно экономит время, когда нужно быстро собрать рабочую связку модов.
Разработчикам, которые хотят подключить библиотеку к своему проекту, нужно прописать зависимость в build-файле. Координаты выглядят так: com.sakuraryoko.core-lib-api. Не забудьте указать корректную версию с привязкой к Minecraft, иначе Gradle не сможет разрешить артефакт.
Стоит ли скачивать Core Lib API
Если вы обычный игрок, который ставит моды от sakuraryoko, — да, скачать Core Lib API придётся, иначе зависимые моды просто не запустятся или выдадут ошибку при загрузке. Библиотека не конфликтует с другими модами и не требует настройки: поставили в mods и забыли.
Если вы разработчик, библиотека даёт готовый набор утилит, который избавляет от написания типового кода. Серверная направленность, отсутствие GUI и независимость от Fabric API делают её удобной для проектов, где важна лёгкость и контроль над зависимостями.
В любом случае перед установкой проверьте совместимость версии Core Lib API с вашей версией Minecraft и загрузчиком Fabric — это главное условие стабильной работы. Дальше всё просто: копируете файл, запускаете игру и наслаждаетесь модами, которые без этой библиотеки попросту не заработают.