创造者斗篷

创造者斗篷

整合包开发者、服务器管理员——添加你自己的自定义披风！

Logo

curseforge modrinth


Divider

无需编写代码或附带资源包，即可为你的整合包添加自定义披风。Creator Capes 让整合包作者通过 JSON 定义披风物品，将 PNG 纹理放入配置文件夹，并可将它们作为奖励、商店物品或创造模式标签页条目发放。你还可以分配基于 UUID 的永久披风覆盖（本地或远程纹理），无需物品——适用于工作人员、赞助者或共享整合包品牌。

Divider

功能

  • JSON 驱动的物品：在 config/creatorcapes/capes.json 中注册任意数量的披风物品
  • 简单的资源工作流：穿戴披风纹理放入 config/creatorcapes/textures/
  • 可选背包图标：可为每个披风单独设置图标，未设置时使用共享的 ? 占位符
  • 创造模式标签页：所有披风物品都会出现在 Creator Capes 物品组中
  • UUID 披风覆盖：通过 remote.toml 按玩家 UUID 设置永久披风（无需物品）
  • 远程覆盖配置：将 config.toml 指向托管的 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. 添加带有玩家 uuid 和 texture 的 [[cape]] 条目（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. 来自 remote.toml / 远程 URL 的 UUID 覆盖
  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；在 26.1.2+ 上也为 NeoForge）