跳到正文

Creator Capes

作者:Voxel Studios

轻松为整合包自定义披风,只需简单的 JSON 和贴图,无需繁琐设置!

收藏

介绍

介绍由机器翻译自 Modrinth 原页面,仅供参考。

Logo

curseforge modrinth

Divider

无需编写代码或打包资源包,就能为整合包添加自定义披风。Creator Capes允许整合包作者通过 JSON 定义披风物品,将 PNG 贴图放入配置文件夹,再把披风作为奖励、商店物品或创造模式物品栏条目发放。你还可以通过 永久 UUID 披风覆盖(使用本地或远程贴图)为玩家指定披风,无需对应物品——适合工作人员、赞助者或统一整合包品牌形象。

Divider

功能

  • 由 JSON 驱动的物品:注册任意数量的披风物品,位于 config/creatorcapes/capes.json
  • 简单的资源管理流程:穿戴时使用的披风贴图放在 config/creatorcapes/textures/
  • 可选物品栏图标:每件披风可单独设置图标,也可共用 ?未设置时使用的占位图标
  • 创造模式物品栏:所有披风物品都会显示在 Creator Capes物品栏分类中
  • UUID 披风覆盖:通过玩家 UUID 设置永久披风,配置位于 remote.toml(无需物品)
  • 远程覆盖配置:指定托管的 TOML 文件 config.toml,让所有客户端加载相同的 UUID 列表
  • 本地或 HTTPS 贴图:使用 textures/中的贴图或图片 URL 覆盖披风贴图(下载后会缓存)
  • 原版披风渲染:已装备或覆盖的披风会替换玩家当前的披风贴图(贴图包含鞘翅 UV 时,也会替换鞘翅贴图)
  • 支持 Wavey Capes:安装 Wavey Capes 后即可兼容(可选,不是必需项)
  • 灵活的装备栏位:存在 Trinkets / Curios 时使用对应栏位,否则使用胸甲栏位

Divider

开始使用

首次启动后,模组会创建:

config/creatorcapes/
  capes.json
  config.toml
  remote.toml
  textures/

披风物品

  1. 打开 capes.json并添加披风条目。
  2. 将穿戴时使用的披风 PNG 放入 textures/(采用标准的 64×32 Minecraft 披风布局)。
  3. 你也可以添加物品栏图标 PNG,并通过 "icon"进行引用。
  4. 重启游戏或服务器。
  5. 在 Creator Capes创造模式物品栏分类中找到披风,或运行 /give @s creatorcapes:<id>。

右键点击披风物品即可装备。

UUID 覆盖(无需物品)

  1. 编辑 remote.toml(或托管一份副本,并在 config.toml中设置 [remote].url)。
  2. 添加 [[cape]]条目,填写玩家的 uuid和 texture(textures/下的文件名或 https:// URL)。
  3. 重启客户端(如果你通过同步配置文件来管理,也要重启服务器)。

Divider

配置

披风物品 — config/creatorcapes/capes.json

{
  "capes": [
    {
      "id": "my_cape",
      "name": "My Cape",
      "texture": "my_cape.png",
      "icon": "my_cape_icon.png",
      "rarity": "uncommon"
    }
  ]
}

字段

| 字段 | 必填 | 说明 |
|——-|:——–:|————-|
| id | 是 | 位于 creatorcapes:下的物品 ID(字母、数字、_、-) |
| name | 是 | 物品栏和提示框中显示的名称 |
| texture | 是 | 位于 config/creatorcapes/textures/中的穿戴用披风 PNG 文件名 |
| icon | 否 | 位于 textures/中的物品栏图标 PNG。未设置或文件缺失时使用 ?作为备用图标 |
| rarity | 否 | common、uncommon、rare或 epic(默认值:uncommon) |

UUID 覆盖 —config/creatorcapes/config.toml

[remote]
# Fetch UUID cape overrides from this URL (empty = off)
url = ""

# Also merge overrides from this file under config/creatorcapes/
local_file = "remote.toml"

合并顺序:先读取远程 URL 条目,再读取本地文件(UUID 重复时以本地配置为准)。

UUID 列表 — config/creatorcapes/remote.toml

# Permanent cape overrides (no item required).
# texture = HTTP(S) URL, or a filename under config/creatorcapes/textures/

[[cape]]
uuid = "00000000-0000-0000-0000-000000000000"
texture = "https://raw.githubusercontent.com/example/repo/main/cape.png"

[[cape]]
uuid = "11111111-1111-1111-1111-111111111111"
texture = "override_local.png"

首次启动时会创建示例 remote.toml。托管图片建议使用 GitHub raw或 CDN——部分国家无法访问 Imgur。如果覆盖配置使用了 Imgur,客户端进入世界时会收到一次聊天警告。

贴图说明

  • 穿戴用披风贴图应为 64×32。尺寸更大的图片会在运行时裁切。
  • 物品栏图标使用单独的文件(通常为 16×16 或 32×32)。
  • 如果设置了 "icon"但找不到对应文件,披风物品仍会加载,并使用备用图标。
  • 下载的覆盖图片会缓存到 config/creatorcapes/cache/。

Divider

优先级

同一玩家有多个披风来源时,优先级如下:

  1. 已装备的 Creator Capes 物品(Trinkets / 胸部栏位)
  2. UUID 覆盖(来自 remote.toml或远程 URL)
  3. 原版 / Mojang 默认披风

因此,UUID 覆盖只会替换玩家的默认披风,不会覆盖已装备的 Creator Capes 物品。

Divider

装备方式

| 加载器 | 优先栏位 | 备用栏位 |
|——–|—————-|———-|
| Fabric | Trinkets chest/cape | 胸甲栏位 |
| NeoForge (1.21.11) | Curios cape | 胸甲栏位 |
| NeoForge (26.1.2+) | Trinkets Updated chest/cape | 胸甲栏位 |

未安装 Trinkets 或 Curios 时,披风物品会像胸甲一样装备到原版胸部栏位。

Divider

整合包作者须知

  • 请将 config/creatorcapes/同时打包到客户端和服务器(物品 + 覆盖配置)。
  • 如需共享 UUID 列表而不随整合包附带配置文件,可以托管一个 remote.toml,并在每个客户端上设置 [remote].url。
  • 编辑 capes.json、config.toml、remote.toml或更改贴图后,必须重启。
  • 配置中的客户端物品栏图标会自动应用,无需额外的资源包。
  • 装备披风物品后,它会完全替换玩家的披风贴图(贴图包含鞘翅 UV 时也会替换鞘翅贴图)。

Divider

兼容性

| 模组 | 支持情况 |
|—–|———|
| Wavey Capes | 兼容(可选) |
| Trinkets (Updated) | 专用披风栏位(Fabric;NeoForge 26.1.2+ 也支持) |

常见问题

Creator Capes 支持哪些 Minecraft 版本?

Creator Capes 支持 Minecraft Java 版 1.21.11–26.2,共 3 个版本,可用的加载器:Fabric / NeoForge / Quilt。下载时注意选择和你游戏版本一致的文件。

Creator Capes 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric / NeoForge / Quilt,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。运行环境:客户端和服务端都要装。

评论

登录后评论和评分

Voxel Studios 的其他作品

查看全部 →