斗篷供应商

为您提供披风！

您可以从各种提供方中选择，或添加自己的提供方。

这是 “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. 在 resources 中创建一个 cape 目录
3. 在 cape/cape.png 中添加披风纹理
4. 在 cape/owners.txt 中添加应获得披风的玩家 UUID 或名称

{
  "custom": {
    "cape": {
      "name-extra": "Contributors",
      "owners": {
        // You can also used UUIDs
        "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
    }
  }
}

编程方式

您也可以创建一个 编程式披风提供方。

更多说明

最大尺寸

图像/纹理不应超过 10MB。否则可能会被忽略。

纹理解析器 / 动画纹理

目前内置了以下解析器：

请注意，动画纹理可以在设置中冻结或完全禁用。