> For the complete documentation index, see [llms.txt](https://furryisland.gitbook.io/commandpanels-wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://furryisland.gitbook.io/commandpanels-wiki/executing-commands/panel-tags.md). # 命令标签 可用于面板命令节的标签。 ## **命令标签** 样例命令：`console= gamemode creative %cp-player-name` （`console=` 与命令中间必须有空格） {% tabs %} {% tab title="一般" %} | 标签 | 描述 | | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | open= |

打开面板。open= <面板名> \[Placeholder:值] {位置}

例如 open= example\_panel \[cname:Rocky] ​在面板中使用 %cp-cname% 将激活该 Placeholder。

要在玩家的物品栏区或快捷栏区打开另一个面板，使用位置设置，例如：open= example\_panel {Middle}

查阅"多个面板"页以获取更多信息。

这对于处理面板变量用处很大，查阅"面板变量"页以获取更多信息。不能用于已经打开的面板。

| | close= |

和 cpc 标签相似，不过可以选择关闭的位置。

例如：close= Middle 将关闭中部的面板。

| | cpc | 在命令节中使用该标签以关闭面板。如果该命令已被其他插件占用，使用 `commandpanelclose`。 | | refresh | 强制刷新面板。确保在点击物件时面板不会同时关闭。如果玩家的一般物品栏开放，也将刷新玩家的面板快捷栏物品。 | | server= |

在 BungeeCord 环境下传送玩家到特定的服务器。server= \[服务器名称]

玩家没有权限加入服务器时将不会传送。

| | force-server= |

在 BungeeCord 环境下强制传送玩家到特定的服务器。force-server= \[服务器名称]

不检查玩家的权限。

| | delay= |

延迟特定命令。delay= <游戏刻> <命令>

例如，delay= 20 msg= 这条消息需要 1 秒以显示。

| | sudo= | 以玩家身份执行只有玩家可以执行的命令。`sudo= [命令]` | | console= | 在控制台中执行命令。 | | event= |

触发附有消息的 PanelCommandEvent（面板命令事件）。

例如，event= <消息>。

| | minimessage= | 需要 Paper MiniMessage API。使用 `minimessage= <文本>` 以利用该 API。 | | sequence= | 使用命令序列，以对不同的物件设定相同的命令。`sequence= [YAML位置]` | | op= | 在命令前加上该标签，使玩家不需要任何权限即可执行命令。（不推荐使用） | | nopapi= | 禁止 PlaceholderAPI 中的 Placeholder 执行。 | | title= |

在玩家屏幕上显示标题。为了区分标题与副标题，要添加副标题，只需在标题与副标题之间加上这个东西：/n/

title= \[玩家] \[淡入] \[维持] \[淡出] \[标题内容]

| | {% endtab %} | | {% tab title="支付门槛" %} | 标签 | 描述 | | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | paywall= |

玩家付费后才可执行物件命令列表中该条标签以下的命令。

样例：paywall= \[价格]

| | data-paywall= |

使用 CommandPanels 数据值进行支付。数据值需为数值。

用法：data-paywall= \[数据] \[价格]

| | item-paywall= |

玩家支付特定物品后才可执行命令列表中该条标签以下的命令。

用法：item-paywall= \[物品]

样例：item-paywall= DIAMOND\_SWORD 1

物品支付门槛也可以使用面板自定义命令。关于其解释，请查阅"面板编辑"页。

样例：item-paywall= \[自定义物件名称] \[数量]

| | xp-paywall= | 玩家支付一定经验等级后才可执行物件命令列表中该条标签以下的命令。对于第二个参数，可选择 `level`（等级）或 `point`（经验点数）。 | | coinpaywall= | 需要 `CoinsAPI` 插件。玩家支付代币后才可执行物件命令列表中该条标签以下的命令。`coinpaywall= [价格]` | | tokenpaywall= | 玩家支付代币后才可执行物件命令列表中该条标签以下的命令。`tokenpaywall= [代币价格]` | | {% endtab %} | | {% tab title="玩家" %} | 标签 | 描述 | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | sound= |

使用 sound= \[音效名] 在点击物件时播放音效。

音效名列表见此。

使用 sound= \[音效名] \[音量] \[音高] 自定义音量与音高。默认值均为 1；音量的取值范围为 0.0 - 1.0，音高的取值范围为 0.5 - 2.0。

| | stopsound= |

使用 stopsound= \[音效名] 在点击物件时停止播放音效。

音效名列表见此。

| | teleport= |

传送玩家。

样例：teleport= \[x] \[y] \[z] \[可选玩家名称] 或 teleport= \[x] \[y] \[z] \[yaw(偏航角)] \[pitch(俯仰角)]

| | send= | 以玩家身份发送全局聊天信息。使用 `send= [信息]`。 | | msg= | 玩家执行命令时发送消息。 | | {% endtab %} | | {% tab title="购入与售出" %} | 标签 | 描述 | | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | buy= |

玩家将购买物品。例如，以 3 元的价格购入 12 个草方块：buy= 3 WOOL 12 id:15

用法：buy= \[价格] \[材料] \[数量] \[id:材质 ID (颜色什么的)] (需要 Vault)

| | sell= |

玩家将售出物品。例如，以 3 元的售价售出 12 个草方块：sell= 3 WOOL 12 id:15

用法：sell= \[返还价格] \[材料] \[数量] \[id:材质 ID (颜色什么的)] (需要 Vault)

对于药水，需要添加 PotionEffectType 药水效果类型，如下： sell= 1 IRON\_INGOT 45 potion:HEAL

| | buycommand= |

玩家将购买命令。用法：buycommand= \[价格] \[命令]

要在控制台执行，以下是一个含玩家名的样例：buycommand= 100 console= gamemode creative %cp-player-name%

| | tokenbuy= |

玩家将购买物品。例如，以 3 代币的价格购入 12 个草方块：tokenbuy= 3 WOOL 12 id:15

用法：tokenbuy= \[代币价格] \[材料] \[数量] \[id:材质 ID (颜色什么的)] (需要 Vault)

| | coinbuy= |

使用 CoinsAPI 购买物品。例如，以 3 硬币的价格购入 12 个草方块：coinbuy= 3 WOOL 12 id:15

用法：coinbuy= \[硬币价格] \[材料] \[数量] \[id:材质 ID (颜色什么的)]

| | tokensell= |

玩家将售出物品。例如，以 3 代币的价格售出 12 个草方块：tokenbuy= 3 WOOL 12 id:15

用法：tokensell= \[返还的代币价格] \[材料] \[数量] \[id:材质 ID (颜色什么的)] (需要 Vault)

| | coinsell= |

使用 CoinsAPI 售出物品。例如，以 3 硬币的价格售出 12 个草方块：coinbuy= 3 WOOL 12 id:15

用法：coinbuy= \[返还的硬币价格] \[材料] \[数量] \[id:材质 ID (颜色什么的)]

| | tokenbuycommand= |

玩家将购买命令。用法：tokenbuycommand= \[代币价格] \[命令]

要在控制台执行，以下是一个含玩家名的样例：tokenbuycommand= 100 console= gamemode creative %cp-player-name%

| | {% endtab %} | | {% tab title="物件" %} | 标签 | 描述 | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | setitem= |

用于将面板槽位中的物件设置为其他东西。对于 placeable（可放置）物件槽很好用。

样例：setitem= <自定义物件名> <槽位> <位置>。

要了解如何创建自定义物件，请查阅本 Wiki 的"面板编辑"部分。

位置可为 Top（顶部）、Middle（中部）、Bottom（底部）

| | give-item= | 用于给予玩家自定义物件。用法：`give-item= <自定义物件>` | | {% endtab %} | | {% tab title="数据" %} | 标签 | 描述 | | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | placeholder= |

与 open= 相似，不过用于在当前面板编辑 Placeholder。例如：placeholder= \[placeholder:值]。

参见"面板变量"页以获取教程。

| | add-placeholder= |

同上；不过当 Placeholder 不存在时会自动添加该 Placeholder。

add-placeholder= \[placeholder:值]

| | set-data= | `set-data= <数据名> <值> [玩家名]` 设置玩家数据为给定值。值只能为一个单词长（即不能有空格）。玩家名可选。 | | add-data= | `add-data <数据名> <值> [玩家名]` 设置玩家数据为给定值。值只能为一个单词长（即不能有空格）。不覆盖原本数据；故如该玩家已有特定数据，将跳过。玩家名可选。 | | math-data= |

用于更改数值数据。用法：math-data <数据名> <操作> \[玩家名]。

有四种操作符：加( + )、减( - )、乘( \* )、除( / )。应以操作符开始、数字结束；

以下是一些操作样例：+1、+0.1、-15、\*3、/5。

将使用当前所存储的数值，并加以指定操作。玩家名可选。

| | del-data= | `del-data= <数据名> [玩家名]` 为玩家删除数据。玩家名可选。 | | clear-data= | `clear-data= <玩家名>` 为玩家清除所有数据。 | | {% endtab %} | | | {% endtabs %} | | ## **点击标签** 点击标签必须放在常规的命令标签前。在点击标签、其他标签、命令之间需要空格隔开。点击标签仅用于物件中的常规命令。 ``` commands: - 'msg= &c该条信息将在任意类型的点击后出现。' - 'right= msg= 右键物件！' ```
标签描述
right=玩家需要右键以执行命令
rightshift=玩家需要 Shift + 右键以执行命令。
left=玩家需要左键以执行命令
leftshift=玩家需要 Shift + 左键以执行命令。
middle=玩家需要中键以执行命令