Мод Deltabox Lib 3.0.1 +2.2.0

Deltabox Lib — технический мод-библиотека для Minecraft с повторно используемыми компонентами для проектов Deltabox. Он написан на Kotlin и нужен прежде всего как зависимость: самостоятельного игрового режима его описание не обещает. Проект распространяется по лицензии MIT; в публичной команде указан danbrown.

Подтверждённая платформа — Fabric. Заявлены Minecraft 1.20.1, 1.21.1 и 1.21.2. Библиотека обязательна и на клиенте, и на сервере; вместе с ней требуются Fabric Language Kotlin и Architectury API.

Назначение библиотеки​

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

• регистрация блоков, предметов, творческих вкладок и жидкостей;
• заготовки пользовательских типов блоков;
• создание наборов деревьев;
• регистрация сделок жителей и странствующего торговца;
• генераторы рецептов и таблиц добычи;
• генераторы шума на основе FastNoise;
• средства отображения пользовательской брони;
• вспомогательные элементы генерации мира.

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

Скриншоты и внешний вид​

Для кого предназначен мод​

Обычному игроку Deltabox Lib нужна, когда её требует выбранный мод или сборка. В исходном описании среди зависимых проектов названы Brazilian Delight, Music Box и Pale Garden Backport; ещё два проекта не раскрыты. Администратору важны одинаковые версии на клиенте и сервере, а сборщику модпака — вся цепочка зависимостей. Для разработчика совместимость программных интерфейсов определяется конкретным выпуском.

Совместимость с версиями Minecraft​

Подтверждены Minecraft 1.20.1, 1.21.1 и 1.21.2, загрузчик Fabric и категории library, game-mechanics, worldgen. Категории не означают совместимость с любым модом.

Один JAR нельзя считать универсальным для всех веток. В предоставленных данных есть версия Deltabox Lib 3.0.1 для Minecraft 1.21.1 и версия 2.2.0 для Minecraft 1.20.1. Совместимость проекта с 1.21.2 заявлена, однако отдельный файл для неё здесь не указан. Для такой установки нужен выпуск, в метаданных которого прямо обозначена 1.21.2; подменять его файлом для 1.21.1 без подтверждения не следует.

Обязательные зависимости​

Для Fabric требуются:

• Fabric Language Kotlin — среда выполнения Kotlin-кода;
• Architectury API — программный слой, используемый библиотекой.

Обе зависимости должны подходить к той же версии Minecraft. Несовместимая ветка может остановить загрузку или вызвать ошибку инициализации. Компонент для другого загрузчика не заменяет Fabric-вариант.

Поскольку Deltabox Lib обязательна на обеих сторонах, её помещают в клиентскую и серверную папку mods. Зависимости также согласуют по их метаданным.

Выбор подходящего файла​

Ориентироваться нужно на версию Minecraft и требования зависимого мода:

• deltaboxlib-fabric-3.0.1+1.21.1.jar — Deltabox Lib 3.0.1 для Minecraft 1.21.1, 914186 байт;
• deltaboxlib-fabric-2.2.0+1.20.1.jar — Deltabox Lib 2.2.0 для Minecraft 1.20.1, 852126 байт.

Практический порядок:

• определить точную версию Minecraft на клиенте и сервере;
• убедиться, что сборка использует Fabric;
• проверить, какой выпуск библиотеки требует основной мод;
• подобрать совместимые Fabric Language Kotlin и Architectury API;
• исключить второй экземпляр Deltabox Lib другой версии.

Более высокий номер не гарантирует взаимозаменяемость: произвольное обновление библиотеки может нарушить запуск мода, рассчитанного на другую ветку API.

Установка на клиент и сервер​

JAR помещают в папку mods совместимой установки. Сначала сохраняют рабочий набор модов и копию серверного мира.

Последовательность установки:

• полностью закрыть клиент и остановить сервер;
• добавить выбранный JAR Deltabox Lib;
• добавить совместимые обязательные зависимости;
• проверить отсутствие дубликатов;
• повторить согласованный набор на обеих сторонах;
• запустить отдельный тестовый профиль;
• проверить журнал загрузки и функции зависимого мода.

JAR не распаковывают и не переименовывают ради исправления несовместимости: решающее значение имеют метаданные выпуска и версия среды.

Проверка результата​

У библиотеки может не быть собственного интерфейса. Главный признак установки — успешная загрузка зависимого проекта. Проверяют:

• запуск до главного меню без аварийного завершения;
• создание тестового мира или подключение к тестовому серверу;
• проверку функций конкретного зависимого мода;
• просмотр журнала на ошибки Deltabox Lib, Kotlin и Architectury;
• сравнение клиентского и серверного списка файлов.

Предоставленные JAR получены по официальному HTTPS, локально сверены по опубликованным хешам и прошли статическую проверку структуры и путей. Динамический запуск не выполнялся, поэтому работа в конкретной сборке не подтверждена.

Хеши и контроль целостности​

Для версии 3.0.1:

• SHA-512: 41758f9c9736962731b2881ada64e11a70d91cd2ced7e4360acb99b529793ccd5afd48b29e2e93f42b13b172f186bc3058a9f2500a1888aeda8a37da01d6babc;
• SHA-1: 3b9a6338a7e482ad926665277bd6b020d12880a7.

Для версии 2.2.0:

• SHA-512: 28eebafdaa648696267d7fe9127d5b0ea172519a3b646fedd95f6db1cf0ad3421bf006458441cbf7b3614eb1c15bd48ba17e4e7a32951cd34942334a353bf923;
• SHA-1: c708db41117782ae11dea52e3002f94b4e6348b7.

Совпадение хеша подтверждает соответствие опубликованному артефакту, но не совместимость с другими модами.

Обновление и откат​

Для безопасности библиотеку желательно обновлять вместе с зависимым модом, если его выпуск требует новую версию. Перед заменой сохраняют прежний JAR, связанные зависимости, список модов и копию мира. Новую связку сначала запускают в копии сборки, не совмещая проверку с одновременной сменой загрузчика и множеством крупных компонентов.

Для отката сервер останавливают и возвращают сохранённый комплект Deltabox Lib, Fabric Language Kotlin, Architectury API и зависимого мода. Если тестовый запуск затронул мир с контентом или генерацией, надёжнее восстановить резервную копию, созданную до обновления, а не ограничиваться заменой JAR.

Ограничения и диагностика​

Deltabox Lib не гарантирует работу любого проекта Deltabox и не устраняет конфликты сторонних модов. Типичные причины сбоя — неверная версия Minecraft, отсутствующая зависимость, дубликат библиотеки, различие наборов клиента и сервера или несовместимый выпуск основного мода.

Порядок диагностики:

• сверить имя и целевую версию JAR;
• оставить один экземпляр библиотеки;
• проверить две обязательные зависимости;
• найти первое содержательное сообщение в журнале;
• запустить минимальную связку из загрузчика, библиотеки, зависимостей и одного основного мода;
• возвращать остальные моды небольшими группами.

Так отделяют ошибку основной связки от конфликта полной сборки.

Лицензия и авторство​

Лицензия проекта — MIT, канонический идентификатор SPDX — MIT. Участник публичной команды: danbrown. При разрешённом лицензией распространении следует сохранять требуемые уведомления об авторстве и лицензии. Пояснения и выводы этой статьи являются редакционными и не приписываются автору проекта.

FAQ​

Добавляет ли Deltabox Lib самостоятельный контент?​

Её основная роль — обслуживать другие моды. Видимые предметы, механики и элементы мира определяются зависимым проектом.

Можно ли поставить библиотеку только на сервер?​

Нет. В предоставленных метаданных она обязательна и для клиента, и для сервера.

Подойдёт ли файл 1.21.1 для Minecraft 1.21.2?​

Это не подтверждено. Для 1.21.2 нужен выпуск с прямым указанием этой версии в метаданных.

Что проверять при ошибке зависимости?​

Наличие совместимых Fabric Language Kotlin и Architectury API, версию Minecraft, отсутствие дубликатов и требования основного мода. Причину лучше искать по первому значимому сообщению журнала.

Доказывает ли совпадение SHA-512 полную работоспособность?​

Нет. Хеш подтверждает целостность файла относительно опубликованного значения, но не совместимость всей модифицированной среды.