Almanac Lib

Общая библиотека для нескольких модов

Almanac Lib является технической зависимостью, в которой собран повторно используемый код автора. Вместо копирования одинаковых компонентов в каждый проект разработчик подключает одну библиотеку и поддерживает общую реализацию централизованно.

Основная часть кода не зависит от конкретного загрузчика. Благодаря этому моды на общей базе проще выпускать для Fabric, Quilt, Forge и NeoForge. Игроку библиотека обычно нужна потому, что её требует другой установленный проект, а не как самостоятельное расширение игрового процесса.

Что меняется в игре

Сама Almanac Lib почти не добавляет предметов, блоков или механик. Её заметная пользовательская функция исправляет ситуацию, при которой пустые NBT-теги мешают одинаковым предметам складываться в один стак. Такое различие может быть невидимо в интерфейсе, но игра считает предметы с разными данными непохожими.

Исправление убирает лишние пустые данные и помогает избежать неожиданного разделения стаков. Однако библиотеку не следует устанавливать как универсальный оптимизатор инвентаря: её главная роль остаётся внутренней, а необходимость определяется зависимостями конкретной сборки.

Установка и обновление

Файл Almanac Lib подбирают одновременно по версии Minecraft и загрузчику. Проект выпускается для нескольких платформ, но сборка для Forge не заменяет вариант для Fabric или NeoForge. На сервер и клиент библиотеку устанавливают в соответствии с требованиями модов, которые её используют.

При обновлении сначала проверяют совместимость зависимого мода, затем Almanac Lib и только после этого загрузчика. Если игра сообщает об отсутствующей или неподходящей зависимости, полезнее сверить номера файлов в журнале запуска, чем добавлять сразу несколько вариантов библиотеки. Одновременное присутствие несовместимых JAR создаёт новые конфликты.

Сравнение с другой платформой

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

Almanac Lib создана прежде всего для повторного использования кода в определённой группе модов и содержит точечное исправление пустых тегов. Architectury API выбирают разработчики как универсальную мультиплатформенную основу, а Almanac Lib устанавливают как конкретную зависимость. Эти библиотеки не взаимозаменяемы: наличие одной не удовлетворяет требование другой.