介绍


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

功能
- 由 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 时使用对应栏位,否则使用胸甲栏位

开始使用
首次启动后,模组会创建:
config/creatorcapes/
capes.json
config.toml
remote.toml
textures/
披风物品
- 打开
capes.json并添加披风条目。 - 将穿戴时使用的披风 PNG 放入
textures/(采用标准的 64×32 Minecraft 披风布局)。 - 你也可以添加物品栏图标 PNG,并通过
"icon"进行引用。 - 重启游戏或服务器。
- 在 Creator Capes创造模式物品栏分类中找到披风,或运行
/give @s creatorcapes:<id>。
右键点击披风物品即可装备。
UUID 覆盖(无需物品)
- 编辑
remote.toml(或托管一份副本,并在config.toml中设置[remote].url)。 - 添加
[[cape]]条目,填写玩家的uuid和texture(textures/下的文件名或https://URL)。 - 重启客户端(如果你通过同步配置文件来管理,也要重启服务器)。

配置
披风物品 — 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/。

优先级
同一玩家有多个披风来源时,优先级如下:
- 已装备的 Creator Capes 物品(Trinkets / 胸部栏位)
- UUID 覆盖(来自
remote.toml或远程 URL) - 原版 / Mojang 默认披风
因此,UUID 覆盖只会替换玩家的默认披风,不会覆盖已装备的 Creator Capes 物品。

装备方式
| 加载器 | 优先栏位 | 备用栏位 |
|——–|—————-|———-|
| Fabric | Trinkets chest/cape | 胸甲栏位 |
| NeoForge (1.21.11) | Curios cape | 胸甲栏位 |
| NeoForge (26.1.2+) | Trinkets Updated chest/cape | 胸甲栏位 |
未安装 Trinkets 或 Curios 时,披风物品会像胸甲一样装备到原版胸部栏位。

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

兼容性
| 模组 | 支持情况 |
|—–|———|
| 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 的其他作品
查看全部 →Yet Another Recipe Conflict Fixer (YARCF)
这个模组添加了一个简单的按钮,方便你切换同一配方的其他制作方式。
Satchel Slots
通过装备不同的挎包来扩展物品栏槽位,并获得各自的增益效果。
All of Modrinth
Modrinth 上的终极大杂烩整合包
Mineshot Reforged
Mineshot Reforged 可用于制作高分辨率截图,还可选择使用正交相机。
评论
登录后评论和评分