FKEscape / DOCS

Appearance

kits.yml：装备券与发放命令 ​

装备券可在商店购买，并在选装阶段使用。每张券的价格、权限和实际发放内容由本文件定义。

字段参考 ​

ID 必须且只能为 t4-basic、t4-full、t5-basic、t5-mid、t5-full。

路径类型约束与含义生效
kits.<id>.display.materialBukkit Material菜单图标，必须有效热重载
display.custom-model-data非负整数，可选图标 CMD热重载
display.name字符串支持 & 颜色热重载
display.lore[]字符串列表可为空列表，但字段必须存在热重载
price数字>= 0，商店售价来源热重载
permission权限节点五档互不重复热重载
grant-commands[]命令列表非空；格式 [console] ... 或 [player] ...；每条必须含 %player_name%热重载

[console] 适合 MMOItems、原版 give 等后台命令；[player] 会以玩家身份执行。命令可省略开头 /。占位符要求是防止给错玩家的安全边界，不支持省略。

完整默认配置 ​

yaml
# 每个 display 均可选配置 custom-model-data: <非负整数>。
kits:
  t4-basic:
    display:
      material: IRON_CHESTPLATE
      name: "&fT4 基础装备"
      lore:
        - "&7铁制护甲与基础武器"
    price: 2500
    permission: fkescape.kit.t4-basic
    grant-commands:
      - "[console] mi give SWORD LONG_SWORD %player_name% 1"
      - "[console] minecraft:give %player_name% iron_helmet 1"
      - "[console] minecraft:give %player_name% iron_chestplate 1"
      - "[console] minecraft:give %player_name% cooked_beef 16"
  t4-full:
    display:
      material: IRON_BLOCK
      name: "&fT4 完整装备"
      lore:
        - "&7全套铁甲、盾牌与远程武器"
    price: 5000
    permission: fkescape.kit.t4-full
    grant-commands:
      - "[console] minecraft:give %player_name% iron_sword 1"
      - "[console] minecraft:give %player_name% bow 1"
      - "[console] minecraft:give %player_name% arrow 32"
      - "[console] minecraft:give %player_name% shield 1"
      - "[console] minecraft:give %player_name% iron_helmet 1"
      - "[console] minecraft:give %player_name% iron_chestplate 1"
      - "[console] minecraft:give %player_name% iron_leggings 1"
      - "[console] minecraft:give %player_name% iron_boots 1"
      - "[console] minecraft:give %player_name% cooked_beef 24"
  t5-basic:
    display:
      material: DIAMOND_CHESTPLATE
      name: "&bT5 基础装备"
      lore:
        - "&7钻石胸甲与高阶近战武器"
    price: 8000
    permission: fkescape.kit.t5-basic
    grant-commands:
      - "[console] minecraft:give %player_name% diamond_sword 1"
      - "[console] minecraft:give %player_name% diamond_helmet 1"
      - "[console] minecraft:give %player_name% diamond_chestplate 1"
      - "[console] minecraft:give %player_name% golden_apple 2"
      - "[console] minecraft:give %player_name% cooked_beef 24"
  t5-mid:
    display:
      material: DIAMOND_BLOCK
      name: "&bT5 强化装备"
      lore:
        - "&7全套钻甲与强化补给"
    price: 12000
    permission: fkescape.kit.t5-mid
    grant-commands:
      - "[console] minecraft:give %player_name% diamond_sword 1"
      - "[console] minecraft:give %player_name% diamond_helmet 1"
      - "[console] minecraft:give %player_name% diamond_chestplate 1"
      - "[console] minecraft:give %player_name% diamond_leggings 1"
      - "[console] minecraft:give %player_name% diamond_boots 1"
      - "[console] minecraft:give %player_name% shield 1"
      - "[console] minecraft:give %player_name% golden_apple 4"
      - "[console] minecraft:give %player_name% cooked_beef 32"
  t5-full:
    display:
      material: NETHERITE_CHESTPLATE
      name: "&5T5 完整装备"
      lore:
        - "&7顶级突击装备与完整补给"
    price: 20000
    permission: fkescape.kit.t5-full
    grant-commands:
      - "[console] minecraft:give %player_name% netherite_sword 1"
      - "[console] minecraft:give %player_name% bow 1"
      - "[console] minecraft:give %player_name% arrow 64"
      - "[console] minecraft:give %player_name% netherite_helmet 1"
      - "[console] minecraft:give %player_name% netherite_chestplate 1"
      - "[console] minecraft:give %player_name% netherite_leggings 1"
      - "[console] minecraft:give %player_name% netherite_boots 1"
      - "[console] minecraft:give %player_name% shield 1"
      - "[console] minecraft:give %player_name% enchanted_golden_apple 2"
      - "[console] minecraft:give %player_name% cooked_beef 64"

与商店的关系 ​

shop.yml.tabs.kit.entries 必须完整引用五个 ID，只负责图标与槽位；价格从本文件读取。权限用于限制购买/使用，券的数据库所有权只会成功消费一次。

常见错误与验证 ​

  • MMOItems 命令语法取决于已安装版本，示例中的类型与 ID 要替换成实际物品。
  • 命令为空、漏 %player_name%、多/少一个固定装备档都会让整次加载失败。
  • 重载后购买一张券，进入选装阶段只点击一次；检查券已消费、命令只执行一轮。再点击或重连不得重复发放。