AttachmentsAPI [1.20.1]

AttachmentsAPI — библиотека для работы с данными в Minecraft 1.20.1 — это служебный мод для загрузчика Fabric, который даёт другим модам единый способ прикреплять произвольные данные к сущностям, чанкам и блокам мира. Сам по себе он ничего не добавляет в игру, но без него многие современные Fabric-моды просто не запустятся, поэтому ставить его приходится почти всем, кто собирает крупную сборку.

Когда я ставил AttachmentsAPI впервые, удивился, насколько это «невидимая» библиотека: в меню её нет, в мире — тоже. Зато с ней моды на магию, RPG-системы, расширенные характеристики игрока и кастомные предметы перестают конфликтовать друг с другом за NBT-теги.

Что добавляет мод

AttachmentsAPI не добавляет блоков, предметов или мобов. Это API-библиотека, и её задача — предоставить разработчикам инструменты, а игроку — стабильную работу зависимых модов. Вот что входит в её функционал:

• Прикрепление данных к сущностям. Моды могут хранить дополнительные параметры (мана, опыт навыков, кастомные характеристики) прямо на игроке, мобе или предмете без правки базовых классов.
• Прикрепление данных к чанкам. Полезно для модов на регионы, защиту территорий, кастомную генерацию и системы прогрессии мира.
• Прикрепление данных к BlockEntity. Сундуки, печи и другие тайл-энтити получают расширяемые поля без необходимости переписывать ванильный код.
• Автоматическая сериализация. Данные сохраняются в файл мира и подгружаются при загрузке без ручного вмешательства автора мода.
• Синхронизация клиент-сервер. Библиотека сама обрабатывает передачу нужных полей между сервером и клиентом — это снимает с разработчиков целый класс багов.
• Совместимость между модами. Несколько модов могут писать свои данные на одну сущность, не затирая друг друга.

Как установить

Если вы уже ставили моды на Fabric, инструкция стандартная. Вот пошаговый ответ на вопрос, как установить AttachmentsAPI — библиотека для работы с данными в Minecraft 1.20.1:

1. Установите Fabric Loader для версии 1.20.1 через официальный установщик.
2. Запустите Minecraft с профилем Fabric хотя бы один раз — это создаст папку mods в директории .minecraft.
3. Нажмите кнопку скачать на нашей странице, чтобы загрузить файл .jar мода.
4. Перенесите скачанный .jar в папку .minecraft/mods рядом с Fabric API.
5. Запустите игру и проверьте список модов в главном меню — AttachmentsAPI должен появиться в списке.

Никаких конфигов править не нужно: библиотека работает «из коробки» сразу после установки.

Требования и зависимости

• Загрузчик: Fabric Loader (рекомендуется актуальная стабильная версия).
• Версия Minecraft: 1.20.1.
• Зависимости: Fabric API — обязателен, без него библиотека не загрузится.
• Java: Java 17 или новее (требование Minecraft 1.20.1).
• Оперативная память: минимум 2 ГБ выделенной RAM для клиента, для сборок с большим количеством модов — от 4 ГБ.

Сам AttachmentsAPI потребляет минимум ресурсов — это служебный код, нагрузка на FPS и TPS незаметна.

Часто задаваемые вопросы

Зачем нужен этот мод, если я не разработчик?

Вы ставите его как зависимость к другим модам. Если в описании какого-то мода написано «requires AttachmentsAPI», значит, без этой библиотеки он просто не запустится. Поэтому скачать AttachmentsAPI — библиотека для работы с данными в Minecraft 1.20.1 имеет смысл всем, кто собирает модпак под Fabric 1.20.1.

Будет ли мод работать с Forge или NeoForge?

Нет. Это библиотека под Fabric. Если вам нужна аналогичная функциональность на Forge, ищите соответствующие порты или альтернативы — устанавливать Fabric-мод в Forge-сборку нельзя.

Безопасно ли удалить мод позже?

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

Где скачать мод и убедиться, что версия совпадает?

Кнопка загрузки находится прямо на этой странице. Файл подписан под Minecraft 1.20.1 и Fabric — других вариантов в этой сборке не предусмотрено. Если вы используете лаунчер с автозагрузкой модов, просто укажите ему скачать AttachmentsAPI — библиотека для работы с данными в Minecraft 1.20.1 и Fabric API одновременно.