Мод #CarrasconLib 1.20.1-0.1 +1.21.1-0.1

#CarrasconLib — библиотечный мод для Minecraft, предназначенный для модов ECarrascon. Согласно официальному описанию, проект создаётся как развивающаяся общая библиотека, объединяющая инструменты, которые автор регулярно использует в собственных разработках. Основная задача мода заключается не в добавлении игрового контента, а в предоставлении общей технической основы.

Для выбранных файлов подтверждены Minecraft 1.20.1 и 1.21.1, загрузчик Fabric, лицензия MIT и обязательная зависимость Architectury API. Мод требуется как на клиентской, так и на серверной стороне. Проект находится в активной разработке, поэтому оценивать его возможности следует только по подтверждённым сведениям конкретных версий.

Назначение​

Главное назначение #CarrasconLib — служить библиотекой для модов ECarrascon. Официальное описание говорит о централизации и упрощении повторного использования инструментов, применяемых автором в разных проектах.

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

Практически библиотека используется следующим образом:

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

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

Принцип работы на высоком уровне​

Официальное описание характеризует #CarrasconLib как развивающуюся библиотеку, предназначенную для объединения часто используемых компонентов. Это позволяет избежать дублирования одинаковых инструментов между несколькими модами автора.

Подробная архитектура библиотеки в предоставленной информации отсутствует. Не раскрываются:

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

Поэтому любые технические детали сверх официального описания были бы предположением.

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

Совместимость​

Для выбранных файлов подтверждены только следующие версии Minecraft:

• 1.20.1;
• 1.21.1.

Поддерживаемой платформой является Fabric.

Другие загрузчики, включая Forge, NeoForge или Quilt, в предоставленной фактической основе отсутствуют. Следовательно, распространять совместимость на них нельзя.

Стороны проекта определены следующим образом:

• client = required;
• server = required.

Это означает, что библиотека рассчитана на использование как на клиенте, так и на сервере.

Зависимости​

Метаданные обеих подтверждённых версий содержат одну обязательную зависимость:

• Architectury API (lhGA9TYQ).

Другие обязательные либо необязательные зависимости в выбранных файлах не перечислены.

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

Установка​

Подтверждённый способ установки — размещение файла мода в папке mods при использовании точно совместимого загрузчика.

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

• Проверить используемую версию Minecraft.
• Подготовить профиль Fabric.
• Установить Architectury API.
• Выбрать файл #CarrasconLib для той же версии игры.
• Поместить JAR-файл в папку mods.
• Запустить клиент и сервер с одинаково совместимыми компонентами.

Другие способы установки, автоматические установщики или специальные каталоги в фактической основе не описаны.

Настройка​

Подтверждённых сведений о:

• конфигурационных файлах;
• пользовательских параметрах;
• игровых командах;
• графическом меню настроек

не представлено.

Также отсутствует информация о необходимости изменять какие-либо параметры после установки.

Практическая проверка сводится к тому, чтобы убедиться в использовании совместимых версий Minecraft, Fabric, Architectury API и самой библиотеки.

Версии и файлы​

Для Minecraft 1.20.1 подтверждён файл:

carrasconlib-fabric-1.20.1-0.1.jar

Подтверждённые характеристики:

• версия — 1.20.1-0.1;
• размер — 88876 байт;
• SHA-512 — 3aa494233ddf1da72e49052e2de6bdda136ce906791e6e135992e451ba61d7d8b80d347ba48a79255f62889ba013702b37b73754bb088e11bdebd55c760a1464;
• SHA-1 — 8e39960dac7f80100196602e785d4b85fcf4c3a6.

Для Minecraft 1.21.1 подтверждён файл:

carrasconlib-fabric-1.21.1-0.1.jar

Подтверждённые характеристики:

• версия — 1.21.1-0.1;
• размер — 88881 байт;
• SHA-512 — 88b83e8dbf17febc22a73e4ea2a8431f5a7d377103b3b67f14a5a0aa560d49e138c54c59ae4dd7b4c379fd369c87e0082198abbca43946083f6f26ad770a80c3;
• SHA-1 — 471faf9ebc0b7b99b1e8e7e6e75de67d7b27b6f1.

Эти сведения позволяют проверить соответствие полученного файла выбранной версии.

Документация и развитие проекта​

Официальное описание сообщает, что библиотека находится в активной разработке.

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

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

Ограничения​

Предоставленная фактическая основа не подтверждает:

• наличие самостоятельного игрового контента;
• поддержку загрузчиков кроме Fabric;
• дополнительные зависимости;
• конфигурационные файлы;
• команды;
• встроенный пользовательский интерфейс;
• изменение производительности;
• поддержку других версий Minecraft;
• перечень API библиотеки.

Во всех этих случаях следует ограничиваться официально подтверждёнными сведениями.

Лицензия​

Проект распространяется по лицензии MIT.

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

Безопасность​

Выбранные файлы не запускались.

Файлы этой карточки загружены с официального HTTPS-источника; размеры и опубликованные SHA-1/SHA-512 сверены, целостность и безопасные пути внутри архивов проверены статически. Файлы не запускались, поэтому динамическое поведение не заявляется как протестированное.

Это не означает проведение динамического тестирования библиотеки.

Практическая проверка включает:

• выбор совместимой версии Minecraft;
• использование Fabric;
• установку Architectury API;
• сверку имени файла;
• проверку SHA-512 либо SHA-1.

FAQ​

Для чего предназначен #CarrasconLib?​

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

Является ли библиотека самостоятельным игровым модом?​

Подтверждённые сведения описывают её как библиотеку. Информация о собственном игровом содержании отсутствует.

Какие версии Minecraft поддерживаются?​

Подтверждены только Minecraft 1.20.1 и Minecraft 1.21.1.

Какой загрузчик требуется?​

Для выбранных файлов подтверждён Fabric.

Какая зависимость обязательна?​

Обязательной зависимостью является Architectury API.

Требуется ли библиотека на сервере?​

Да. Для проекта указаны client = required и server = required.

Есть ли официальная документация по возможностям библиотеки?​

Официальное описание сообщает только о планах подготовить подробную документацию в будущем.

Выполнялось ли динамическое тестирование файлов?​

Нет. Подтверждены только будущая сверка контрольных сумм и статическая проверка архивов.