Cobblemon Gym Badges

数据包：徽章定义

路径：data/<namespace>/cgb/badge/<id>.json
（此处的 cgb 是徽章使用的注册表命名空间。）

命名提示：<id> 是徽章的标识和翻译键。
如果你想制作“冠军缎带”，请将文件命名为 champion_ribbon.json，并添加
badge.<namespace>.champion_ribbon 的翻译。内部物品 ID 始终为 cgb:badge、cgb:badge_ribbon，
或 cgb:badge_untagged，具体取决于 badgebox；但玩家只会看到徽章定义中的名称。

示例（徽章）：

{
  "name": { "text": "Fire Badge" },
  "theme": "fire",
  "texture": "cgb:item/fire_badge",
  "badgebox": "badge"
}

示例（缎带）：

{
  "name": { "text": "Champion Ribbon" },
  "theme": "champion",
  "texture": "cgb:item/blue_ribbon",
  "badgebox": "ribbon"
}

字段说明：

• name（可选）：显示名称组件。
• theme（可选）：主题字符串。如果省略，则使用文件名作为主题。
• role（可选）：所需角色名称（不含 gym_leader_ 前缀）。
• tags（可选）：要应用于徽章物品的额外物品标签。
• model_data（可选）：自定义模型数据值。如果省略，模组会按每种徽章盒类型自动分配唯一值。
• model 或 texture（可选）：要使用的物品模型 ID。如果只设置 texture，模组会自动生成物品模型。
• badgebox（可选）：none、badge 或 ribbon。
• 此字段用于控制物品会获得哪种 BadgeBox 标签。
• 默认值为 badge（添加 badgebox:badges）。
• ribbon 会添加 badgebox:ribbons。
• none 不会添加 BadgeBox 标签。
• 标签名称由 BadgeBox 模组定义且固定不变；此字段封装了这些细节。

数据包：徽章配方

路径：data/<namespace>/recipe/<id>.json

示例：

{
  "type": "cgb:badgemaking",
  "core": { "item": "minecraft:gold_ingot" },
  "base": { "item": "minecraft:blue_dye" },
  "result": {
    "theme": "champion"
  }
}

• core = 徽章压制机的顶部槽位
• base = 徽章压制机的底部槽位

资源包：模型 + 纹理

路径：

• 纹理：assets/<namespace>/textures/item/<id>.png

你只需要为简单的 2D 徽章/缎带提供纹理。模组会在运行时生成基础物品模型和
CustomModelData 覆盖，因此你不需要随包附带 badge.json、badge_ribbon.json、
或每个徽章对应的模型文件。

如果徽章定义使用了 "texture": "cgb:item/blue_ribbon"，你还必须提供：

• assets/cgb/textures/item/blue_ribbon.png

如果想使用自定义物品模型（3D 或分层模型），请在徽章定义中设置 "model": "<namespace>:item/<id>"，
并自行提供模型 JSON。

模型选择（如何选择纹理）：

• 此模组使用 CustomModelData 为每个徽章选择对应模型。
• 如果省略 model_data，模组会按徽章盒类型自动分配唯一值。
• 基础模型和覆盖项会在客户端自动生成。

如果需要在不同整合包间使用稳定的 ID，也可以手动设置 model_data，但并非必需。

加载你的整合包

• 数据包：将整合包放入 world/datapacks/ 并运行 /reload。
• 资源包：将整合包放入 resourcepacks/，然后在“资源包”菜单中启用。

故障排除

• 如果 JEI/EMI/REI 中显示缺失纹理，通常意味着缺少 模型文件。如果使用 model，请确保徽章定义中的模型 ID 指向真实存在的物品模型 JSON。
• 如果手动设置了 model_data，请确保每种徽章盒类型下的每个徽章都使用唯一数值。否则，让模组自动分配即可。