Cape Provider

Cape Provider - клиентский мод для Minecraft Java, который позволяет отображать плащи из разных источников. Он подходит для декоративной кастомизации персонажа: сервер устанавливать не нужно, а другие игроки увидят плащ только при наличии совместимого клиентского решения.

Проект представляет собой улучшенную и переработанную версию мода Capes. Cape Provider делает подключение источников удобнее, добавляет настройку их порядка, поддержку собственных провайдеров и дополнительные параметры отображения. По сути, это утилита для тех, кто хочет управлять плащами в Minecraft без привязки к одному сервису.

Что меняет Cape Provider

Мод не добавляет новые блоки, предметы или игровые механики. Его задача полностью косметическая - он управляет плащами, которые отображаются на моделях игроков.

Основные возможности:

• подключение нескольких провайдеров плащей;
• изменение порядка провайдеров;
• добавление собственных локальных источников;
• подключение удалённых источников через конфигурацию;
• интеграция плащей через ресурсы и метаданные других Fabric-модов;
• поддержка программных провайдеров;
• настройка правил применения плащей;
• поддержка статичных и анимированных текстур;
• кэширование загруженных текстур;
• исправления и улучшения по сравнению с Capes;
• реализация полностью на Java, без необходимости устанавливать Kotlin.

Cape Provider часто используют в декоративных и оптимизированных Fabric-сборках. Например, он встречается в Fabulously Optimized как более гибкая замена Capes. По назначению это утилитарно-косметический мод: он не влияет на баланс, генерацию мира, производительность сервера или прогресс игрока.

Для кого нужен этот мод

Cape Provider пригодится игрокам, которым нужен собственный плащ без сложной ручной настройки. Можно положить текстуру в папку конфигурации, ограничить её показ определёнными никами или UUID, а затем выбрать нужный источник в игре.

Разработчики модов тоже могут использовать Cape Provider. Через метаданные fabric.mod.json можно показывать плащи участникам проекта, контрибьюторам или другим выбранным игрокам. Это удобно для клиентских модов и сборок модов, где косметические элементы должны подключаться вместе с основным проектом.

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

Совместимость и установка

Cape Provider предназначен для Fabric и требует Fabric API. Mod Menu является необязательным дополнением, но с ним обычно удобнее открывать настройки из интерфейса Minecraft.

Проект поддерживает актуальные версии Minecraft Java, включая ветки 1.21-1.21.11, а также версии 26.1.x, 26.2 и 26.3. Конкретная версия мода должна соответствовать версии игры и загрузчика Fabric.

Мод несовместим с Capes, поскольку Cape Provider является его переработанной версией и использует собственную систему провайдеров. При переносе сборки лучше оставить только один из этих модов, иначе источники могут конфликтовать или плащи будут обрабатываться непредсказуемо.

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

Это самый лёгкий способ добавить собственный плащ. Он подходит игрокам, которым нужна локальная текстура, а также авторам сборок модов, где файлы должны храниться прямо в конфигурации.

Создайте папку config/cape-provider и поместите туда файл с текстурой:

config/cape-provider/cape.png

Дополнительно можно добавить такие файлы:

• owners.txt - список имён игроков или UUID, которым будет показан плащ;
• name.txt - название провайдера, отображаемое в интерфейсе.

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

Можно создать несколько локальных провайдеров. Для этого используйте отдельные каталоги внутри config/cape-provider/simple-custom:

config/cape-provider/simple-custom/my-super-cool-provider/cape.png

У каждого каталога могут быть свои cape.png, owners.txt и name.txt. Такой вариант удобен, если в сборке нужно хранить несколько косметических наборов и переключаться между ними через настройки Cape Provider.

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

Удалённые провайдеры загружают текстуры по шаблону адреса. Этот способ полезен, когда плащи должны храниться отдельно от клиента или подбираться индивидуально для каждого игрока.

Откройте файл:

config/cape-provider/config.json

В секции remoteCustomProviders добавьте собственный источник. В примере ниже адрес заменён на условный шаблон, чтобы показать саму структуру настройки:

{
  "id": "cp1",
  "name": "CustomProvider1",
  "uriTemplate": "YOUR_TEXTURE_PROVIDER/$id.png"
}

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

• $id - UUID игрока с дефисами;
• $name - игровое имя;
• $idNoHyphen - UUID без дефисов.

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

Для выбора способа обработки текстуры используется атрибут textureResolverId. Он нужен, когда источник возвращает не обычный PNG, а анимированную текстуру или другой поддерживаемый формат.

Интеграция через другие моды

Разработчик Fabric-мода может добавить провайдер через ресурсы и метаданные собственного проекта. По принципу это похоже на то, как Mod Menu получает информацию о модах из fabric.mod.json.

Локальный провайдер для мода

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

В fabric.mod.json добавьте метаданные:

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

Затем создайте каталог cape внутри ресурсов мода и добавьте туда текстуру:

resources/cape/cape.png

Список игроков с доступом к плащу указывается в файле:

resources/cape/owners.txt

В него можно добавить UUID или игровые имена. Если нужен более подробный вариант настройки, метаданные могут выглядеть так:

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

Вместо names можно использовать UUID игроков. Сам Cape Provider применяет эту схему для собственной интеграции, поэтому структура хорошо подходит для модов, которым нужно выдать плащи контрибьюторам или участникам проекта.

Удалённый провайдер для мода

Удалённый источник можно объявить прямо в fabric.mod.json:

{
  "custom": {
    "cape": "YOUR_TEXTURE_PROVIDER/$uuid.png"
  }
}

Для расширенной конфигурации используется объект:

{
  "custom": {
    "cape": {
      "url": "YOUR_TEXTURE_PROVIDER/texture.png",
      "changeCapeUrl": "YOUR_UPDATED_TEXTURE_PROVIDER/texture.png",
      "rateLimitedReqPerSec": 20
    }
  }
}

Параметр rateLimitedReqPerSec ограничивает количество запросов в секунду. Значение по умолчанию - 20. В адресах можно применять переменные, например $uuid. Если синтаксис конфигурации требует экранирования символа $, используйте обратный слеш или замену на § согласно формату провайдера.

Программный провайдер

Cape Provider также позволяет создавать провайдеры программно. Такой способ рассчитан на разработчиков, которым недостаточно локальных файлов и конфигурации. Через код можно самостоятельно определить правила выбора плаща, обработку игроков и логику источника.

Для обычного игрока этот вариант не нужен. Если требуется просто добавить собственную текстуру, локального провайдера обычно достаточно. Программная интеграция имеет смысл для авторов модов, крупных сборок и проектов с собственной системой косметики.

Анимированные плащи и форматы текстур

В моде есть встроенные обработчики текстур, или texture resolvers.

ID обработчика	Анимация	Формат	Пример	Особенности
default или null	Нет	PNG	uuid.png	Обычная статичная текстура
sprite	Да	PNG-спрайт	animated.png	Кадры размещаются последовательно в одном файле
gif	Да	GIF	animated.gif	Использует больше ресурсов и не рекомендуется без необходимости

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

Ограничение размера

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

Для обычного статичного плаща достаточно PNG разумного размера. Если используется анимация, следите не только за размером файла, но и за количеством кадров: тяжёлая текстура быстрее создаёт нагрузку, чем небольшой статичный PNG.

Практические нюансы

• Перед добавлением нового источника проверьте, что его id не совпадает с уже существующим.
• После изменения config.json перезапустите Minecraft, если провайдер не появился сразу.
• При большом количестве источников настройте их порядок, чтобы нужный плащ имел более высокий приоритет.
• Для персональных плащей лучше использовать UUID, а не только имя игрока. Имя может измениться, тогда как UUID остаётся привязанным к аккаунту.
• Если плащ не отображается, сначала проверьте путь к файлу, формат PNG и наличие игрока в owners.txt.
• При переходе с Capes удалите старый мод из профиля, чтобы избежать конфликтов.
• Для клиентской сборки достаточно установить Cape Provider и Fabric API. Серверная установка не требуется.
• Mod Menu не обязателен, но упрощает доступ к настройкам.

Cape Provider хорошо подходит для тех, кому нужны плащи в Fabric-сборке без жёсткой привязки к одному сервису. Локальные файлы закрывают простые задачи, удалённые провайдеры подходят для централизованной раздачи текстур, а интеграция через fabric.mod.json позволяет авторам модов добавлять косметику прямо в свои проекты.