Cardinal Components API — мод на библиотеку компонентов в Майнкрафте
Cardinal Components API решает задачу, которая обычно остаётся скрытой от игрока: даёт модам единый способ прикреплять собственные данные к стандартным игровым объектам. Такие компоненты могут автоматически сохраняться, синхронизироваться, обновляться вместе с владельцем и по заданным правилам переноситься после возрождения персонажа. Разработчику не приходится отдельно собирать одинаковую инфраструктуру для каждой системы, а сборка получает общий технический слой. API устроен модульно: автор зависимого проекта подключает только нужные возможности и тонко настраивает поведение данных. От обычного контентного мода библиотека отличается отсутствием самостоятельного игрового сценария. Её ценность определяется тем, какие проекты поверх неё реализуют способности, состояния, прогресс или другую связанную с объектами информацию.
Последний релиз вышел 25 дней назад — проект активно поддерживают, и под свежие версии игры сборки появляются быстро.
| Версия игры | Загрузчики | Сборка | Размер | Дата |
|---|---|---|---|---|
| 1.20.1 | Fabric, Quilt | 5.2.3 | 223 КБ | 2025-01-08 |
| 1.21.1 | Fabric, Quilt | 6.1.3 | 224 КБ | 2025-11-22 |
| 1.20 | Fabric, Quilt | 5.2.3 | 223 КБ | 2025-01-08 |
| 1.21 | Fabric, Quilt | 6.1.3 | 224 КБ | 2025-11-22 |
| 26.1.2 | Fabric, Quilt | 8.0.1 | 232 КБ | 2026-07-05 |
| 26.2 | Fabric, Quilt | 8.0.1 | 232 КБ | 2026-07-05 |
Скачать 8.1.0 · 231 КБстраница автора на Modrinth
.jar в папку .minecraft/mods — создайте её, если её нет.| Сборка | Канал | Версии игры | Размер | Дата |
|---|---|---|---|---|
| 8.1.0 | релиз | 26.3 | 231 КБ | 2026-09-17 |
| 7.3.2 | релиз | 1.21.11 | 229 КБ | 2026-07-05 |
| 8.0.1 | релиз | 26.1, 26.1.1, 26.1.2, 26.2 | 232 КБ | 2026-07-05 |
| 8.0.0 | релиз | 26.1, 26.1.1, 26.1.2, 26.2 | 232 КБ | 2026-04-11 |
| 8.0.0-alpha.5+26.1 | альфа | 26.1, 26.1.1 | 232 КБ | 2026-04-02 |
| 8.0.0-alpha.4+26.1-rc-2 | альфа | 26.1-rc-2 | 233 КБ | 2026-03-24 |
Проект не подойдёт игроку, который ищет новые предметы, существ, меню или заметные изменения механик. Без использующего API мода установка практически ничего не даст. Не стоит добавлять библиотеку «на всякий случай»: лишний технический компонент усложняет диагностику сборки и не создаёт полезного эффекта сам по себе.
Типичный сбой проявляется не внутри мира, а при запуске: зависимый мод сообщает об отсутствующей или неподходящей библиотеке. В таком случае сверяйте требования именно его страницы и не подбирайте файл по совпадению названия. Если ошибка возникла после обновления сборки, верните согласованный набор файлов либо обновите связанные проекты вместе. Рассинхронизация состояния, пропажа прогресса после повторного входа или неправильный перенос данных при возрождении чаще указывают на реализацию компонента в конкретном моде, однако сначала следует проверить одинаковый состав серверной части и корректность конфигурации. Для поиска причины временно оставьте библиотеку и один проект, который её использует, затем возвращайте остальные небольшими группами. Сохраняйте журнал запуска: название исключения и первый упомянутый мод полезнее общего сообщения о падении. Перед экспериментами сделайте резервную копию мира, поскольку удаление компонента может оставить зависимые сохранённые данные недоступными.
Cardinal Components API стоит устанавливать владельцам сборок и серверов ровно тогда, когда его требует выбранный мод. Это зрелая по устройству техническая прослойка для сохранения, синхронизации, копирования и обновления привязанных данных, но оценивать её как отдельное игровое дополнение бессмысленно. Разработчикам она полезна как готовая модульная архитектура компонентов; обычным игрокам — как необходимое условие работы зависимого проекта. Если требований к библиотеке в составе сборки нет, добавлять её отдельно незачем.
Библиотека предоставляет общие точки подключения, события и механизмы совместимости, на которые опираются другие моды. Самостоятельного контента она не добавляет: необходимость установки определяется требованиями выбранных проектов.
Cloth Config API даёт другим модам готовую основу для удобных экранов настроек. Самостоятельного контента библиотека не добавляет и обычно устанавливается по требованию зависимого проекта.
YACL предоставляет другим модам готовую основу для создания удобных экранов настроек. Самостоятельного контента библиотека не добавляет и обычно устанавливается как требуемая зависимость.
Обеспечивает запуск модов, написанных на Kotlin, когда им требуется соответствующая языковая среда. Fabric Language Kotlin служит технической зависимостью и не добавляет в игру предметы, механики или визуальные изменения.
Architectury API позволяет запускать моды, которым нужна общая многоплатформенная программная прослойка. Самостоятельного контента библиотека не добавляет и устанавливается ради зависимых проектов.
JEI показывает предметы, рецепты и способы применения прямо в интерфейсе игры, избавляя от постоянного поиска сведений вне сборки. Через строку поиска можно быстро найти нужную вещь, открыть её изготовление или выяснить, в каких рецептах она участвует.
Случайные находки из каталога — моды, шейдеры, текстуры и сборки с нашим разбором.
Wither Spawn Fix разрешает создавать иссушителя, когда внутри проверяемой формы находятся трава, снег, ковёр, цветочный горшок и другие небольшие блоки, которые ваниль ошибочно считает препятствием.
MineTraps добавляет мины, капканы, гвоздевые и токсичные ловушки, шипы, колючую проволоку и препятствия для обороны территории.
Beta English переносит старые английские тексты формата .lang в современную JSON-локализацию, возвращая лексику эпохи беты.
Purpliness последовательно перекрашивает ключевые элементы мира в фиолетовую гамму. Фиолетовыми становятся небо, облака, тени, вода и туман, поэтому обычный Minecraft приобретает простой цельный фэнтезийный образ.
Whimscape Emissive дополняет базовый Whimscape светящимися деталями на блоках, мобах и других сущностях, сохраняя его исходный художественный стиль.
Сборка в духе Vanilla+ без книги заданий и встроенного путеводителя. Она расширяет знакомое выживание биомами, сооружениями, строительными блоками, животными, рыбалкой, хозяйством, магией и переработанными измерениями.
Только если в сборке больше нет проектов, использующих её компоненты. Сначала изучите требования оставшихся модов и сделайте резервную копию. При удалении вместе с зависимым проектом связанные данные могут перестать читаться; возвращение файлов иногда восстанавливает доступ, но рассчитывать на это вместо копии мира не следует.
Такое размещение соответствует заявленной стороне работы: серверная установка требуется, а клиентская сама по себе необязательна. Однако конкретный контентный мод способен предъявлять собственные требования к клиенту. Поэтому ориентируйтесь на весь набор зависимостей сборки, а не только на свойства Cardinal Components API.
Не любые и не без участия разработчика. Автор мода определяет структуру компонента, прикрепляет его к подходящему объекту и задаёт необходимое поведение. После правильной реализации библиотека берёт на себя предусмотренные операции сохранения и предоставляет средства синхронизации, обновления и копирования, но не угадывает назначение произвольных данных.
Зависимый мод может выбрать, какие связанные с персонажем сведения сохранятся после смерти и появления заново. Это не единое правило для всей сборки: один компонент разрешено скопировать полностью, другой — сбросить или обработать иначе. Итоговое поведение определяется автором конкретной механики, а API лишь предоставляет механизм выбора.