Cape Provider

Мод Cape Provider для Minecraft — предоставление наградных крыльев игрокам

Cape Provider — это улучшенная версия мода для предоставления наградных крыльев (capes) в Minecraft. Он позволяет игрокам и разработчикам модов легко добавлять крылья через локальные файлы, удалённые API или программные интеграции. Мод написан на Java и поддерживает множество способов настройки, включая использование Mod Menu для управления. Он совместим с загрузчиком Fabric и предлагает гибкие опции для тонкой настройки отображения крыльев.

🚀 Основная цель и возможности

Cape Provider — это улучшенная и переработанная версия популярного мода, предназначенная для предоставления наградных крыльев (capes) игрокам в Minecraft. Мод позволяет выбирать из различных встроенных провайдеров или создавать свои собственные, предлагая гибкость, которой не хватало в предыдущих версиях. Ключевые улучшения включают упрощённую интеграцию с внешними сервисами, возможность сортировки провайдеров и расширенные настройки для тонкой настройки того, как именно отображаются крылья. Проект полностью написан на Java, что исключает необходимость в Kotlin и обеспечивает стабильность работы.

📂 Локальные провайдеры и конфигурация

Самый простой способ внедрить кастомные крылья — использование локальных файлов. Для этого в папке конфигурации config/cape-provider создаётся файл текстуры cape.png. В этой же директории можно добавить опциональные файлы для управления доступом: owners.txt определяет, каким игрокам (по имени или UUID) будет показано крыло, а name.txt позволяет переопределить название источника. Для модпаков и простых пользователей это идеальный вариант, так как не требует сложной настройки.

Если требуется добавить несколько разных локальных провайдеров, достаточно создать соответствующие поддиректории внутри config/cape-provider/simple-custom. Например, для нового провайдера создается папка my-super-cool-provider, куда помещается файл cape.png. Это позволяет легко масштабировать систему наград без изменения основного кода мода.

🌐 Удалённые провайдеры и интеграция с API

Для продвинутых сценариев предусмотрен режим удалённых провайдеров. Настройка осуществляется через файл config/cape-provider/config.json в секции remoteCustomProviders. Здесь можно указать uriTemplate — шаблон URL-адреса, который мод будет запрашивать для получения текстуры. В шаблоне поддерживаются переменные, такие как $id (UUID игрока) или $name, что позволяет персонализировать награды.

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

Пример конфигурации для удалённого провайдера

```jsonc
{
  "id": "skinmc",
  "name": "SkinMC",
  "uriTemplate": "https://skinmc.net/api/v1/skinmcCape/$id"
}
```

🛠 Интеграция для разработчиков модов

Мод предоставляет мощные инструменты для разработчиков, позволяя выдавать крылья участникам сообщества, спонсорам или авторам контента прямо внутри своего мода. Существует два основных подхода: локальный и удалённый.

Рекомендуемый локальный метод не требует сетевого взаимодействия. В файле fabric.mod.json в секции custom указывается ключ cape, а текстура помещается в папку resources/cape/. Также можно использовать расширенную конфигурацию, где в owners указываются конкретные имена или UUID пользователей, которым должно быть доступно крыло. Этот метод аналогичен тому, как работает Mod Menu для отображения своих метаданных.

Пример metadata для разработчика

```json5
{
  "custom": {
    "cape": {
      "name-extra": "Contributors",
      "owners": {
        "names": [ "Notch" ]
      }
    }
  }
}
```

🎨 Анимация и технические ограничения

Cape Provider поддерживает различные форматы текстур, включая статические PNG, стопки PNG для создания анимации (формат sprite) и GIF-файлы. Однако использование GIF не рекомендуется, так как они потребляют значительно больше ресурсов по сравнению с современными форматами. Анимированные текстуры можно заморозить или полностью отключить в настройках игры, если это необходимо.

Важно учитывать размер файлов: изображения и текстуры не должны превышать 10 МБ, иначе система может проигнорировать их. Мод также поддерживает программное создание провайдеров через API, что позволяет реализовывать сложные логики выдачи наград на основе действий игрока или других условий внутри игры.

Связанные материалы

• Chat Animation [Smooth Chat] — похожий мод
• Boat Item View — похожий мод
• Cobblemon PokeNav — похожий мод

Автор: litetex · Лицензия: LGPL-2.1-or-later