菜单文件

plugins/CloudAcces/menus/ 里一个 .yml 文件就是一个菜单，文件名就是菜单 ID：menus/宠物栏.yml → /acces open 宠物栏。可以有任意多个菜单（饰品栏、时装栏、宠物栏…），各自有自己的权限。改完 /acces reload；单一栏位写错只会略过那一格并在控制台警告，不会让整个插件停用。

菜单

标题: '<dark_gray>✦ </dark_gray><gradient:#7ec8ff:#c9a7ff>饰品栏</gradient>'
行数: 6                 # 1–6
权限: ''                # 打开权限，留空 = 所有人
死亡掉落: 否            # 死亡时这个菜单里的饰品掉落（keepInventory 开着就不掉）
背景:                   # 空白格子的填充，可以省略
  材质: BLACK_STAINED_GLASS_PANE
  名称: ' '
打开音效: [ 'block.ender_chest.open 0.5 1.2' ]   # 可省略，覆写 config 的音效
关闭音效: [ 'block.ender_chest.close 0.4 1.4' ]

标题可以用 {玩家} 与 PlaceholderAPI 变量。背景: GRAY_STAINED_GLASS_PANE 这种一行写法也可以。

栏位

栏位:
  戒指1:                         # 栏位 ID（存档用，改名会让原本的饰品变成「已删除栏位」）
    位置: 21                     # 0 ~ 行数×9-1
    允许: ci type=戒指           # 见「栏位规则」
    不可重复群组: 戒指           # 同群组的栏位不能装同一款
    名称: '<yellow>◇ 戒指 · 左手'
    材质: GOLD_NUGGET            # 空栏时的图标
    模型: 0                      # custom-model-data
    物品模型: 'myserver:ui/ring' # 1.21.2+ item_model，可省略
    发光: 否
    说明:
      - '<gray>戴上后立即生效'
    自动说明: 是                 # 在说明最后自动加「可装备：戒指」与操作提示
    权限: ''                     # 需要权限才解锁
    锁定图标:                    # 没权限时显示的图标
      材质: GRAY_DYE
      名称: '<dark_gray>✖ 未解锁'
    原版属性: 是                 # 非 CloudItems 物品身上的原版属性是否生效
    装备音效: [ 'block.amethyst_block.chime 0.8 1.8' ]
    卸下音效: [ 'item.armor.equip_leather 0.7 0.9' ]

字段	说明
`位置`	必填，不能和其他栏位或装饰重叠
`允许`	规则清单，见栏位规则；没写时这格放不进任何东西（会警告）
`原版`	`头盔` `胸甲` `护腿` `靴子` `副手`：这格直接就是玩家身上的原版装备栏，见原版盔甲托管。没写 `允许` 时默认 `armor=<该部位>`
`图标`	可以把 `材质`、`名称`、`说明`… 写在 `图标:` 底下，也可以直接写在栏位里
`完整数据`	编辑器保存的整个物品（含资源包模型、颜色等），优先于 `材质`

栏位 ID 就是存档位置

玩家的饰品存在「菜单 ID / 栏位 ID」底下（繁简、大小写、底线视为相同）。把栏位删掉或改名，原本的饰品不会消失，会变成「已删除栏位」的饰品：不生效，玩家登录时会提示用 /acces recover 取回。

装饰与按钮

装饰:
  玩家:
    位置: 4
    材质: PLAYER_HEAD
    头颅: '{玩家}'               # 显示打开者的头
    名称: '<white>{玩家} <gray>的饰品'
  分隔:
    位置: '11, 20, 29, 38, 47'   # 多个位置：清单 [0, 8] 或 '45-53' 范围
    材质: GRAY_STAINED_GLASS_PANE
    名称: ' '
  宠物:
    位置: 45
    材质: BONE
    名称: '<gold>宠物栏 ▸'
    动作: 菜单:宠物栏
  关闭:
    位置: 53
    材质: BARRIER
    名称: '<red>关闭'
    动作: 关闭

动作	效果
`关闭`	关闭菜单
`菜单:<ID>`	切换到另一个菜单（需要那个菜单的权限）
`指令:<指令>`	以点击者身份执行，`{玩家}` = 点击者
`控制台:<指令>`	以控制台执行（管理员查看他人时不会执行）
`音效:<音效>`	播放一个音效

动作: 可以写成清单，依序执行。点按钮会播放 config.yml 的「按钮」音效。

图标通用字段

材质、名称、说明、模型、物品模型、发光、数量、头颅、完整数据。名称与说明支持 MiniMessage、&a 色码、{玩家}、{栏位}、{可装备} 与 PlaceholderAPI 变量。

菜单​

栏位​

装饰与按钮​

图标通用字段​

菜单

栏位

装饰与按钮

图标通用字段