跳到主要内容

🔧 主配置

主配置文件为 config.yml。修改后可使用 /cskin reload 重新加载。

基础与依赖设置​

config-version: "1"
language: zh_cn

craftengine:
  required: true
配置项说明
config-version配置文件格式版本，请勿随意修改
language语言文件名称，对应 translations/<语言>.yml
craftengine.required是否要求 CraftEngine 正常加载；默认值为 true

当 craftengine.required: true 且未检测到 CraftEngine 时，需要 CraftEngine 的命令不会执行。关闭该选项后，插件可以使用原版物品作为部分备用方案。

预览菜单​

ItemDisplay 预览​

preview-menu:
  item-display:
    enabled: true
    duration-ticks: 100
    distance: 2.5
    scale: 1.0
    rotation-cycle-ticks: 20
    follow-update-interval-ticks: 1
    follow-interpolation-ticks: 2
    float-enabled: true
    float-amplitude: 0.1
    float-cycle-ticks: 40
配置项说明
enabled是否启用物品预览
duration-ticks预览持续时间，单位为 tick；20 tick 约为 1 秒
distance预览实体与玩家视线的距离，单位为方块
scale预览实体缩放倍数
rotation-cycle-ticks预览物品完整旋转一周所需的 tick 数
follow-update-interval-ticks跟随玩家视角的位置更新间隔
follow-interpolation-ticks跟随玩家移动时的客户端插值时长
float-enabled是否启用上下浮动效果
float-amplitude上下浮动振幅，单位为方块
float-cycle-ticks上下浮动完成一个周期所需的 tick 数

收藏动态 Lore​

preview-menu:
  dynamic-icon:
    favorite:
      enabled: true
      'true':
        - '<!i><yellow>★ 已收藏</yellow> <gray>右键取消收藏</gray>'
      'false':
        - '<!i><gray>☆ 未收藏</gray> <yellow>右键收藏</yellow>'
配置项说明
favorite.enabled是否显示收藏状态 Lore
favorite.true已收藏时追加的 Lore
favorite.false未收藏时追加的 Lore

动态 Lore 支持以下占位符：{skin_id}、{skin}、{item_name}、{model} 和 {favorite}。

玩家收藏保存在插件数据目录的 SQLite 数据库 data.db 中。

皮肤代币​

skin-token:
  craftengine-item: "craftskin:skin_token"
  fallback-enabled: true
  fallback-material: PAPER
  default-item-model: "craftskin:skin_token"
  consume-on-apply: true
  allow-stacked-target-items: false
  require-empty-item-model: true
  target-items:
    allow-regex:
      - 'minecraft:bow'
      - 'minecraft:crossbow'
      - 'minecraft:.*_pickaxe'
      - 'minecraft:.*_sword'
      - 'minecraft:.*_shovel'
      - 'minecraft:.*_axe'
      - 'minecraft:.*_hoe'
  override-lore: true
  lore:
    - "<!i><#48596a>拿起此代币后点击背包内物品即可换肤</#48596a>"
配置项说明
craftengine-item全局皮肤代币的 CraftEngine 物品 ID
fallback-enabledCraftEngine 代币不可用时是否使用原版物品作为备用代币
fallback-material备用代币的原版材质
default-item-model备用代币使用的 item_model
consume-on-apply应用皮肤成功后是否消耗代币
allow-stacked-target-items是否允许目标物品堆叠数量大于 1
require-empty-item-model是否要求目标物品没有已有 item_model
target-items.allow-regex全局允许换肤的目标物品正则列表；为空时不限制类型
override-lore皮肤没有单独 Lore 时是否使用全局 Lore
lore全局皮肤代币 Lore

目标物品规则会匹配物品材质名称、带命名空间的物品 ID，以及目标物品已有的 item_model。单个皮肤可以在自己的配置中覆盖全局目标规则。

拆除代币​

skin-token:
  remove-token:
    token_item: craftskin:remove_token
    item_name: <#829b9b>皮肤拆除代币</#829b9b>
    lore:
      - "<!i><#48596a>拿起此代币后点击背包内物品即可拆除皮肤</#48596a>"
配置项说明
remove-token.token_item拆除代币使用的 CraftEngine 物品 ID，也可以使用原版物品材质
remove-token.item_name拆除代币名称
remove-token.lore拆除代币 Lore

使用拆除代币点击背包内带有皮肤的物品后，会移除其 item_model 和盔甲外观数据，并返还对应皮肤代币。

应用音效​

skin-token:
  apply-sound:
    enabled: true
    sound: minecraft:entity.experience_orb.pickup
    volume: 1.0
    pitch: 1.0
配置项说明
apply-sound.enabled是否播放应用皮肤后的音效
apply-sound.sound音效 ID
apply-sound.volume音效音量
apply-sound.pitch音效音调