Blueprint

Blueprint - это не контентный мод, который добавляет в Minecraft новых мобов, биомы или структуры сам по себе. По сути это библиотека для модов Team Abnormals, которая держит общий каркас для проектов команды. Если вы ставите их моды и лаунчер пишет, что не хватает Blueprint, значит без него загрузка просто не пойдет. Поэтому чаще всего скачать Blueprint нужно не "ради фич", а чтобы нормально работали другие моды.

Что это такое и зачем он нужен

Blueprint решает очень простую проблему: в больших модах Team Abnormals много одинаковой внутренней логики. Вместо того чтобы копировать один и тот же код в каждый проект, разработчики вынесли его в отдельную библиотеку. Для игрока это выглядит как обычный файл-мод, который кладется в папку mods вместе с остальными. Для разработчика - как удобный набор инструментов и API.

По сути Blueprint нужен для таких вещей, как:

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

Именно поэтому Blueprint часто встречается в сборках модов как обязательная зависимость. Если вы собрали модпак на Forge или NeoForge и один из модов требует эту библиотеку, без нее игра может вообще не запуститься.

Что важно понимать обычному игроку

Blueprint почти не должен ощущаться как отдельный мод в геймплее. Это нормально. Его ценность не в том, что он сам добавляет кучу нового контента, а в том, что он помогает другим модам работать стабильнее и единообразнее. Особенно это заметно в проектах Team Abnormals, где у разных модов общая стилистика и общая техническая база.

Для игрока есть несколько практических моментов:

• ставьте Blueprint только той версии, которая совпадает с вашей версией Minecraft и загрузчиком;
• для Minecraft 1.21.1 встречается, в частности, версия под NeoForge 8.1.1;
• библиотека нужна и на клиенте, и на сервере, если мод зависит от нее;
• удалять ее нельзя, пока в сборке остались моды, которым она требуется.

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

На каких версиях бывает

По проверенным данным, проект встречается на широком диапазоне версий Minecraft Java Edition - от 1.15.2 до 1.21.1, с поддержкой Forge и NeoForge. То есть это не узкая вещь под одну новую версию, а взрослая библиотека, которая живет уже давно и используется как база для целой экосистемы модов.

Из интересного в свежих правках для линейки 1.21.1 упоминаются доработки по работе с биомами, более предсказуемый порядок некоторых внутренних операций, а также исправления конфликтов вроде проблем при создании мира с ModernFix и ошибок при перезагрузке ресурсов. Это как раз тот случай, когда библиотека влияет не на "вау-контент", а на стабильность сборки.

Стоит ли ставить Blueprint отдельно

Если коротко - только если он нужен другому моду. Сам по себе он вряд ли даст вам то, что можно сразу увидеть в мире. Зато как зависимость он часто критичен. Особенно если вы собираете модпак вокруг проектов Team Abnormals или сторонних модов, которые используют этот каркас.

Для обычной игры совет простой:

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

Для разработчиков

Если вы делаете свой мод и хотите использовать Blueprint как основу, подключить его довольно прямо. Сначала библиотеку добавляют как зависимость в build.gradle:

repositories {
    maven {
        url = "https://maven.teamabnormals.com"
    }
}

dependencies {
    implementation("com.teamabnormals:blueprint:<version>")
}

Здесь вместо <version> подставляется нужная версия Blueprint с учетом версии Minecraft. Например, 1.21.1-8.0.0 даст файл вида blueprint-1.21.1-8.0.0.jar.

Дальше для NeoForge зависимость прописывают в neoforge.mods.toml:

[[dependencies.<modId>]]
    modId = "blueprint"
    type = "required"
    versionRange = "<version>,)"
    ordering = "AFTER"
    side = "BOTH"

В этом блоке <version> тоже заменяют на нужную версию библиотеки. Такой вариант указывает, что мод должен загружаться после Blueprint и требует ее наличия на клиенте и сервере. Если нужен другой диапазон версий, лучше отдельно свериться со спецификацией neoforge.mods.toml, чтобы не промахнуться с совместимостью.

Кому это реально нужно

Blueprint - must-have не как самостоятельная игрушка, а как фундамент. Если вы собираете сборку с модами Team Abnormals, без него почти наверняка никуда. Если просто ищете новый контент для выживания, то вам нужен не Blueprint сам по себе, а моды, которые на нем построены. А если вы разработчик - это уже нормальный рабочий инструмент, который может сэкономить кучу времени на рутинных системах.

Скачать Blueprint для Minecraft стоит в первую очередь тогда, когда сборка прямо просит эту библиотеку. В таком случае без нее моды просто не заведутся.