Fotia Plugin Wiki

修改前先确认

时装 ID 必须在整个 cosmetics 目录中唯一。
默认示例均为 enabled: false。
icon、visual-item、actual-item 都支持 item-model 或 custom-model-data。
source 为 CRAFTENGINE 时，ID 必须由已启用的 CraftEngine 构建。

当前配置文件

default

cosmetics/default.yml

以下内容来自插件当前默认资源。先确定你想改变的功能，再选择配置分组；技术路径只用于在 YAML 中准确定位。

先看懂这个文件

时装与武器皮肤定义

每个节点定义唯一时装 ID、目标、分类、排序、菜单图标、虚拟物品、实际物品、模型偏移、兼容材质和气球绳端。icon、visual-item、actual-item 都支持新版 item-model 或整数 custom-model-data。

推荐阅读顺序

选择最接近你目标的配置分组。
点击字段，先看“什么时候需要修改”。
复制 YAML 片段并只替换需要的值。

本文件常用入口

cosmetics.<id>.enabled / target / category / sort-order
icon.source / id / amount / name / lore
icon|visual-item|actual-item.item-model
icon|visual-item|actual-item.custom-model-data
tooltip-style / glow / flags
transform.offset
compatible-materials / weapon.replace-material
balloon.lead / lead-offset

完整入门示例

cosmetics:
  blue_wings:
    enabled: true
    target: "slot:back"
    category: "back"
    sort-order: 10
    icon:
      source: "VANILLA"
      id: "PAPER"
      # 方案 A：1.21.4+ 推荐使用命名空间 item-model
      item-model: "fotia:blue_wings"
    visual-item:
      source: "VANILLA"
      id: "PAPER"
      # 方案 B：旧资源包可改用整数 custom-model-data
      custom-model-data: 10001
    transform:
      offset: [0.0, 1.45, 0.15]

安全修改先备份只用空格缩进一次改一个字段保存后执行 /fc reload

01配置分组

03字段教程

Cosmetics · Example Hat/enabled

布尔值

启用状态

cosmetics.example_hat.enabled

这项配置控制什么

功能开关。设为 true 启用，设为 false 停用；修改后按本页提示重载插件。

什么时候需要修改

当你需要开启或关闭这一项功能时修改；第一次安装建议先保留默认状态。

可以怎样填写

布尔值：只能填写 true 或 false。

当前默认值

false

可复制的 YAML 片段

# 放在 cosmetics.example_hat 配置段内
enabled: false

修改步骤

先在服务器中找到路径 cosmetics.example_hat.enabled。
只填写 true 或 false，不要加引号。
保存文件并执行 /fc reload，随后查看控制台。

注意事项

保持原有 YAML 缩进。建议一次只修改一个字段，保存后立即重载并查看控制台。