Truly Modular: Miapi

Truly Modular: Modular Item API (сокращенно Miapi) - это современный кроссплатформенный API для полностью настраиваемых модульных предметов в Майнкрафт. Если вы когда-нибудь хотели, чтобы в игре появились мечи с уникальными рукоятями, луки с разными тетивами или броня из редких материалов, которую можно собирать как конструктор - это он.

По сути, Миапи - это фундамент. Сам по себе API ничего не добавляет в игру, но открывает возможности для других модов. Проблема в том, что в ванильном Minecraft у предметов очень ограниченная система характеристик: у всех алмазных мечей одни и те же параметры, и никак их не изменить. Truly Modular решает это, позволяя создавать предметы, у которых каждый модуль (лезвие, гарда, рукоять) имеет свои статы и влияет на итоговые свойства.

Зависимости

• Forge/NeoForge:

  • Caelus API (только Minecraft 1.20.1)
  • Architectury API

• Fabric/Quilt:

  • Fabric API
  • Architectury API

Для игроков: что скачивать?

Этот API сам по себе пустой - он просто набор инструментов. Но на его основе работают крутые дополнения (аддоны). Вот основные:

• Truly Modular Arsenal - аддон на холодное оружие и инструменты. Мечи, топоры, кирки, которые можно собирать из частей.

• Truly Modular Archery - фокусируется на луках, арбалетах и модульных стрелах. Каждый лук можно улучшать тетивой, прицелом и другими модулями.

• Truly Modular Armory - модульная броня. Теперь нагрудник, поножи и шлем можно собирать из разных материалов и апгрейдить.

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

Миапи дает мододелам мощный набор инструментов, чтобы делать кроссплатформенные моды (работающие и на Fabric, и на Forge). Вот что внутри:

• Система характеристик материалов - можно добавлять новые ключи в Material.json и ссылаться на них в модулях. Например: "armor_pen": "[material.hardness]*2.0 + 20" в коде модуля.

• Готовые GUI-компоненты - расширяемый интерфейс крафта, который умеет работать с модульными предметами.

• Сложные свойства модулей - можно прописывать кастомную логику для каждого модуля, вплоть до уникального поведения.

• Почти 100 готовых материалов и десятки встроенных свойств - база, на которой можно строить свои рецепты.

• Продвинутый рендеринг - система отрисовки каждого модуля, позволяющая реализовать разные типы моделей. По умолчанию есть поддержка 3D с расширенными возможностями.

• Системы синергии, внедрения свойств и скинов - несколько механизмов, которые могут добавлять или изменять свойства модулей и предметов в целом. Настоящая магия кастомизации.

• Генеративные материалы - Truly Modular автоматически сканирует контент других модов и пытается добавить их материалы в систему. Да, ручные материалы всегда качественнее, но генеративные создают мост совместимости, пока нет специальной поддержки.

Важно знать

Для каких лаунчеров это? Forge? Fabric? Оба. Миапи кроссплатформенный - просто качайте нужную версию.

Будет ли бэкпорт на старые версии Minecraft? Пока нет. В проекте куча фич, которые в приоритете. Если список идей уменьшится, может, и вернутся к бэкпорту.

Поддерживаются ли другие моды? Скорее всего да. Генеративная совместимость срабатывает с большинством модов из коробки. Если что-то пошло не так - можно сообщить об ошибке.

Можно ли написать свой аддон на этот API? Да. Код открыт, документация есть, примеры в Arsenal, Archery и Armory можно глянуть.

Можно ли использовать в сборке модов? Конечно. Миапи отлично чувствует себя в любых сборках.

Если собираете модпак на тему кастомизации или просто хотите дать игрокам возможность творить уникальное оружие - Truly Modular это то, что нужно. Скачайте Modular Item API и выберите подходящие аддоны под свой вкус.