面板设置

置于面板根目录下的设置。

面板权限

打开面板需要的权限。填 default 以使所有人都有权限;如果填 creative,权限节点即为 commandpanel.panel.creative

perm: default

面板行数

面板的行高度。填 3 即为小箱子,填 6 即为大箱子。 如果想要特殊的 GUI(工作台、熔炉、漏斗之类的),你需要查阅 物品栏类型

不过也不是所有类型都 OK,还请自行尝试。

# 标准一行 GUI
rows: 1

# 特殊 GUI(漏斗)
rows: HOPPER

面板标题

面板顶部的标题。支持 Placeholder 与颜色代码。注意:对于 Minecraft 的某些旧版本,标题的长度限制可能更短;所以如果标题被截断了,还请缩短一下标题。

title: '&8样例 GUI'

面板类型

用于确定面板类型。以下是支持的类型:

  • static(静态):面板打开后,禁用物件变化;例如,动画不会变化。

  • nocommand(无命令):禁止以 /cp <面板名> 打开面板。

  • nocommandregister(无命令注册):禁止面板自动注册其自定义命令至 commands.yml 文件。

  • unmovable(不可移动):面板打开时,阻止玩家移动自身物品栏中的物品。

  • unclosable(不可关闭):阻止玩家关闭面板。需要在面板中添加带 cpc 命令标签的物件以关闭面板。

panelType:
- static
- nocommand
- nocommandregister
- unmovable
- unclosable

面板消息

将其加入物件以选择自定义消息。以下样例显示了不同的可加入物件的自定义信息。

custom-messages:
  player-input:
  - '&b在该自定义消息下输入文本!'
  input: '&c自定义最大字符数消息!' # 用于玩家输入
  perms: '&c自定义无权限消息!' # 没有点击物件的权限

刷新面板

添加该项以覆盖 config.yml 中的 refresh-panels 项,为该面板单独设置特定值。

refresh-delay: 1

面板音效

使用该项,以在玩家打开面板时播放音效。不支持 Minecraft 1.8。 可以播放音乐,关闭面板时会自动停止播放。

sound-on-open: BLOCK_NOTE_BLOCK_PLING

面板之外的命令

这些是玩家点击面板之外时执行的命令。"面板之外"即 Minecraft GUI 区域四周的空区域。

outside-commands:
- 'placeholder= [name:您的名字是:]'
- 'msg= %cp-name% %cp-player-name%'

面板打开与关闭的命令

面板打开或关闭时执行的命令。执行顺序从上至下。 Pre-load(预加载命令)于面板打开前执行(例如在面板加载和设置物件名称前),commands-on-open(打开时命令)于此后执行。 建议使用 commands-on-open,仅在为面板 Placeholder 设定数值等操作时使用 Pre-load

pre-load-commands:
- 'placeholder= [text:您的名字是:]'
- 'msg= %cp-text% %cp-player-name%'
commands-on-open:
- 'msg= 面板打开!'
- 'gamemode creative'
commands-on-close:
- 'msg= Panel Closed!'
- 'gamemode creative'

自定义物件

在面板中可添加自定义物件,将用于各种功能,例如物品支付门槛以及使用 setitem= 时。 自定义物件的语法与面板中的常规物件相同,参见以下样例片段。 在该样例中,有三个样例物件。要自定义物件,参见"物件设置"页。

custom-item:
  example1:
    material: AIR
  example2:
    material: DIAMOND
    name: 'A custom name for the diamond'
  itemThree:
    material: GLOWSTONE
    name: 'Glow Boy'
    lore:
    - 'This is the lore!'
    enchanted: true
    stack: 34    

禁用或启用世界

disabled-worlds(世界黑名单)禁止处于特定世界的玩家访问面板。如果该面板有快捷栏物件,且使用了 Multiverse-Inventories 之类的插件实现了不同世界不同背包的功能,该快捷栏物件将不会在禁用世界中出现。 也可以使用 enabled-worlds(世界白名单),只在列表中的世界启用面板。

disabled-worlds:
- world_nether
- world_the_end
#OR
enabled-worlds:
- world

空物件槽

该物件将自动填充于面板中无物件的空位。 如果想用自定义物件,输入面板中自定义物件的名称。

empty: STAINED_GLASS_PANE
# 或者
empty: custom_item_name

将其设置为颜色 ID。如果不需要,设置为 0。(Minecraft 1.12 及以下版本)

emptyID: '15'

Last updated