面板变量

使用变量操作面板。

面板变量是什么？

面板变量是一些自定义 Placeholder，或者可以跨面板使用的数据。事实上，面板变量可以从一个面板跨越至另一面板，或者永久保存，以便在下次打开面板时插件能够记住数据。

要定义 Placeholder 及其值，使用以下命令。需要输入所打开的面板名称，然后按以下格式输入：[placeholder:值]。Placeholder 值可以包含空格；Placeholder 本身应不含大写字母。

'0':
  material: STONE
  commands:
  - open= panel-3 [example1:Placeholder 值] [mat:STONE]
  - msg= 该 Placeholder 的值为 %cp-example1%

在定义 Placeholder 后，在你想打开的面板内随意使用。

在以上样例中，Placeholder 为 example1；也就是说，可以使用 %cp-example1%。

要在当前面板中编辑 Placeholder，不可如上所述使用 open=。将 open= 改为 placeholder=，便可在当前面板中编辑 Placeholder。

只需定义要编辑的特定的 Placeholder，其他没有添加的 Placeholder 将保持原状。例如，使用以上样例时，如果打开 panel-3，且需要一个物件更改 Placeholder %cp-mat% 为 BEACON，使用以下命令：

'7':
  material: BEACON
  commands:
  - placeholder= [%cp-mat%:BEACON]

要永久存储数据，比起 Placeholder 变量，数据变量更好用。数据值将永久存储至文件中，服务器重启时也会保留不丢失。需要用以下命令标签之一以设置值。

add-data= [数据名] [值] [可选玩家]

不会覆盖旧数据，不过如果玩家没有该数据名的数据值，则会写入值。对于面板的 commands-on-open （打开时命令）很好用，可以确保在使用面板前已设置数据。

要查看数据变量，只需使用以下 Placeholder。

%cp-data-[数据名]% 将 [数据名] 替换为要查看的数据名。

%cp-data-[数据名],[玩家名]% 以查看其他玩家的数据变量。

可以使用 Placeholder 操作变量，见以下 Placeholder。

%cp-setdata-[数据名],[新值]% 将 [数据名] 替换为要编辑的数据名。

如果直接打开面板而变量没有定义，则会直接显示原始 Placeholder 而没有任何值。

要使用 Placeholder 值以更改物件外观，使用 hasvalue 节以将物件改为别的东西。

数据名与数据值不能包含大写字母。

Last updated 2 years ago