命令标签
借助命令标签,你可以在面板上执行各种操作。命令标签可在按钮、输入框和面板事件的actions中使用。
这些标签会在操作触发时执行(如点击按钮或打开面板),它们提供的功能远不止运行常规命令那么简单。
命令标签列表
下表列出了所有可用的命令标签类型及其功能。
| 标签语法 | 描述 |
|---|---|
| [open] 面板名称 | 打开另一个面板。 |
| [close] | 关闭当前面板。 |
| [refresh] 延迟数值 | 重新渲染当前面板(适用于动态内容)。如果需要延迟刷新,请输入一个以刻为单位的延迟数值(0-5)。 |
| [previous] | 打开当前会话中上一个打开过的面板。 |
| [console] 命令 | 以服务器控制台的身份执行指定的命令。 |
| [give] 材料 数量 | 给予玩家物品。若背包空间不足,物品会掉落在地上。 |
| [delay] 刻 | 延迟此命令后续的命令(以刻为单位)。 |
| [chat] /命令 | 以当前玩家的身份发送命令或者聊天消息(例如/msg)。 |
| [grant] 权限 /命令 | 以当前玩家的身份发送命令或者聊天消息。在执行命令或聊天时暂时强制授予指定的权限。 |
| [msg] 消息 | 向玩家发送消息。支持颜色代码和占位符。 |
| [server] 服务器名称 | 通过Velocity或BungeeCord将玩家传送到另一个服务器。 |
| [sound] 声音名称 volume=数值 pitch=数值 category=数值 | 播放声音,可选设置音量、音调和声音类别。 |
| [stopsound] 声音名称 | 停止播放指定的声音。 |
| [teleport] x y z world=世界名称 yaw=数值 pitch=数值 player=玩家名称 | 传送玩家,参数可选。 |
| [itemaction] enchant 槽位编号 add/remove/clear 魔咒名称 等级 | 附魔面板中的物品。 |
| [itemaction] repair 槽位编号 | 修复面板中的物品。 |
| [itemaction] amount 槽位编号 数量 | 修改面板中物品的数量。 |
| [itemaction] remove 槽位编号 | 移除面板中的物品。 |
| [session] set 键 值 | 在会话数据中存储一个键值对(临时数据,面板关闭后失效)。 |
| [session] del 键 | 从会话数据中删除指定键。 |
| [data] set 键 值 | 在持久化数据(data.yml)中存储一个键值对。 |
| [data] overwrite 键 值 | 覆盖data.yml中一个已存在的键值。 |
| [data] math 键 表达式 | 使用数学表达式修改指定键的数值。 |
| [data] del 键 | 从持久化数据中删除指定键。 |
| [data] clear | 清除该玩家的所有持久化数据。 |
示例
要将一个名为playerName的会话变量设置为%player_name%的值,请使用:
- '[session] set playerName %player_name%'
关闭当前面板后打开一个名为confirm_panel的面板。此操作不会清空会话数据,因为插件能够识别出面板是从另一个面板打开的。
- '[close]'
- '[open] confirm_panel'
提示
你可以在commands中定义多条命令标签,以创建更加复杂的操作。