Cape Provider

模组

· 作者 litetex

为你提供斗篷! 你可以从各种提供商中选择,也可以添加自己的。

0 本站下载 0 关注 更新于 3 天前

需要前置:Fabric API

最新 6.1.0-SNAPSHOT · Fabric

一键开服(送7天)

为你提供披风!

你可以从各种提供程序中进行选择,也可以添加你自己的。

"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",
      // 你可以用 $id、$name 或 $idNoHyphen 替换 uuid,以便为每位玩家定制披风
      "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 或名称
注意:还有一种更详细的变体

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 不推荐使用
与 PNG 等更现代的格式相比,GIF 需要消耗更多资源。

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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源