Cape Provider

Даёт вам плащи!

Вы можете выбирать из различных провайдеров или добавить свой собственный.

Улучшенная/переработанная версия мода "Capes":

• Улучшенная и более простая интеграция провайдеров плащей
• Позволяет упорядочивать провайдеров
• Поддержка пользовательских провайдеров
• Больше возможностей для тонкой настройки применения плащей
• Написан только на Java (Kotlin не нужен)
• Различные исправления и улучшения

Создание пользовательского провайдера плащей

Мод предоставляет множество различных способов добавления провайдера.

Следующие возможности отсортированы по простоте:

Простой локальный провайдер

Рекомендуется для:

• Пользователей, которые просто хотят настраиваемый плащ
• Модпаков (использующих config/cape-provider/simple-custom)

Самый простой способ отобразить плащ — зайти в директорию config/cape-provider и создать файл текстуры плаща с именем cape.png.

Дополнительно есть следующие необязательные файлы:

• owners.txt — Определяет, каким именам игроков или UUID будет отображаться плащ. Если этот файл отсутствует, то плащ будет отображаться у всех игроков.
• name.txt — Для переопределения отображаемого имени провайдера

Вы также можете добавить больше провайдеров, создав соответствующие директории в config/cape-provider/simple-custom.
Пример: config/cape-provider/simple-custom/my-super-cool-provider/cape.png

Удалённый провайдер в конфигурации

Рекомендуется для:

• Пользователей, которые хотят добавить собственный удалённый провайдер

Эта демонстрация показывает, как применять плащи внутри custom-cape-demo.

1. Откройте файл конфигурации, расположенный в config/cape-provider/config.json

2. В разделе remoteCustomProviders добавьте следующую запись:

   {
     "id": "cp1",
     "name": "CustomProvider1",
     // You can replace uuid with $id, $name or $idNoHyphen to customize the cape per Player
     "uriTemplate": "https://raw.githubusercontent.com/litetex-oss/mcm-cape-provider/refs/heads/dev/custom-cape-demo/uuid.png"
   }

   Пример для SkinMC

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

3. Перезапустите игру и активируйте провайдера

Для получения более подробной информации ознакомьтесь с RemoteCustomProvider и RemoteCustomProviderConfig

ПРИМЕЧАНИЕ: Резолверы текстур можно выбрать с помощью атрибута textureResolverId (подробности см. ниже).

через моды

Рекомендуется для:

• Модов

Если вы разработчик мода и хотите, например, отобразить плащ для сторонников или контрибьюторов вашего мода, вы можете предоставить его с помощью ресурсов и/или метаданных мода в fabric.mod.json. Общее поведение аналогично тому, как modmenu обрабатывает это.

Локальный/Простой (Рекомендуется)

Этот подход не требует сетевого взаимодействия и является рекомендуемым способом. Он работает путём чтения метаданных и ресурсов из директории cape.

Вот пример:

1. Добавьте следующие метаданные мода: fabric.mod.json

   {
     ...
     "custom": {
       "cape": "Contributors"
     }
   }

2. Создайте директорию cape внутри resources
3. Добавьте текстуру плаща в cape/cape.png
4. Добавьте игроков, которым должен быть выдан плащ, в cape/owners.txt с их UUID или именами

{
  "custom": {
    "cape": {
      "name-extra": "Contributors",
      "owners": {
        // Вы также можете использовать UUID
        "names": [
          "Notch"
        ]
      }
    }
  }
}

Мод сам использует эту стратегию. Смотрите fabric.mod.json или директорию cape для подробностей.

Удалённый

Вот пример реализации, показывающий, как можно добавить удалённый провайдер плащей:

fabric.mod.json

{
  ...
  "custom": {
    "cape": "https://raw.githubusercontent.com/litetex-oss/mcm-cape-provider/refs/heads/dev/custom-cape-demo/uuid.png"
  }
}

{
  "custom": {
    "cape": {
      // Выдаёт всем рождественский плащ
      // Здесь также можно использовать переменные, например $uuid. Подробности смотрите выше
      // Возможно, придётся экранировать $ с помощью \ или вместо $ можно использовать §
      // Альтернатива: "uriTemplate"
      "url": "https://example.org/textures/§uuid.png",
      "changeCapeUrl": "https://...",
      "rateLimitedReqPerSec": 20 // По умолчанию 20
    }
  }
}

Программный

Вы также можете создать программный провайдер плащей.

Дополнительные примечания

Максимальный размер

Изображения/текстуры не должны превышать 10МБ. Иначе они могут быть проигнорированы.

Резолверы текстур / Анимированные текстуры

В настоящее время встроены следующие резолверы:

Обратите внимание, что анимированные текстуры можно заморозить или полностью отключить в настройках.