适用于 Minecraft 26.3 的 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 中应用披风。

• 打开位于 config/cape-provider/config.json 的配置文件
• 在 remoteCustomProviders 部分添加以下条目：

{ "id": "cp1", "name": "CustomProvider1", // 你可以将 uuid 替换为 $id、$name 或 $idNoHyphen 来为每个玩家自定义披风 "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" }

• 重启游戏并激活该提供者

更多详情请查看 RemoteCustomProvider 和 RemoteCustomProviderConfig

注意：可以使用 textureResolverId 属性选择纹理解析器（详情见下文）。

通过模组

推荐用于：

• 模组

如果你是模组开发者，并且想要例如为你的模组的支持者或贡献者显示披风，你可以使用模组的资源和/或 fabric.mod.json 中的元数据来提供它。整体行为类似于 modmenu 处理此问题的方式。

本地/简单（推荐）

此方法不需要网络通信，是推荐的方式。它通过从 cape 目录读取元数据和资源来工作。

以下是一个示例：

• 添加以下模组元数据：

fabric.mod.json

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

• 在 resources 中创建 cape 目录
• 将披风纹理添加到 cape/cape.png
• 将应获得该披风的玩家及其 UUID 或名称添加到 cape/owners.txt

注意：还有一个更详细的变体

fabric.mod.json

{ "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" } }

以下是一个更详细的变体

fabric.mod.json

{ "custom": { "cape": { // 给每个人一个圣诞披风 // 你也可以在此处使用变量，例如 $uuid。详情见上文 // 你可能需要用 \ 转义 $，或者你也可以使用 § 代替 $ // 替代方案："uriTemplate" "url": "https://example.org/textures/§uuid.png", "changeCapeUrl": "https://...", "rateLimitedReqPerSec": 20 // 默认值为 20 } } }

编程方式

你也可以创建编程方式的披风提供者。

更多说明

最大大小

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

纹理解析器 / 动画纹理

目前内置以下解析器：

解析器 ID - 动画 - 格式 - 示例 - 备注

default / null - ❌ - PNG - uuid.png sprite - ✔ - 堆叠 PNG - animated.png | gif | ✔ | GIF | animated.gif | 不建议使用 GIF 与更现代的格式（如 PNG）相比需要更多资源。 |

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