差别

这里会显示出您选择的修订版和当前版本之间的差别。

--- 插件手册:betonquest:变量列表 [2018/06/15 05:07]
小小k酱 [任务目标名称: `objective`]
+++ 插件手册:betonquest:变量列表 [2021/09/24 13:25] (当前版本)
duangfafa [计算数学表达式： math.calc]
@@ 行 1: / 行 1: @@
 ====== 变量列表 Variables List ======
-（版本：2017-08-21 [[https://github.com/Co0sh/BetonQuest/wiki/Variables-List/eba93848d2ceed8f17e2f01548214e7fbd9752e0|原文链接]]）
+（版本：2017-08-21 翻译：kjiang [[https://github.com/Co0sh/BetonQuest/wiki/Variables-List/eba93848d2ceed8f17e2f01548214e7fbd9752e0|原文链接]]）
-===== 玩家名字: `player` =====
+（kjiang备注）变量可以直接写在对话conversation脚本中用于显示某些数值，或在条件condition中用于判断。不同于event、condition、objective，变量是用点''.''而不是空格连接参数的。
-此变量代表玩家的名字/ID。如果你使用了''display''参数，此变量会使用玩家的显示名称（如Essentials定义的display name）而不是实际ID。
+===== 玩家名字: player =====
-**例如**: ''%player.display%''
+此变量显示玩家的名字/ID。如果你使用了''display''参数，此变量会使用玩家的显示名称/昵称（如Essentials定义的display name）而不是实际ID。
-===== NPC: `npc` =====
+**例子**: ''%player.display%''
-非常简单的变量。''npc''会以玩家的语言被替换为NPC的显示名字。
+===== NPC: npc =====
-**例如**: ''%npc%''
+非常简单的变量。''npc''会以玩家的语言显示NPC的名字。
-===== 任务目标属性: `objective` =====
+**例子**: ''%npc%''
-你可以用此变量显示某个任务目标的流程/进度等等。第一个参数是//objectives.yml//中定义的任务目标的ID（不是//任务目标列表//中的任务目标本身）。请确保此玩家已启动了这个任务目标，否则这个变量将会显示空白（“”）；第二个参数是这个任务目标的某个''属性property''。每一种//目标objective//都有各种不同的任务''属性property''可供利用，具体你可以参阅[[插件手册:betonquest:任务目标|任务目标列表]]。
+===== 任务目标属性: objective =====
+你可以用此变量显示某个任务目标的流程/进度等等。第一个参数是//objectives.yml//中定义的任务目标的ID（不是//任务目标列表//中的任务目标本身）。请确保此玩家已启动了这个任务目标，否则这个变量将会显示空白（'' ''）；第二个参数是这个任务目标的某个''属性property''。每一种//目标objective//都有各种不同的任务''属性property''可供利用，具体你可以参阅[[插件手册:betonquest:任务目标|任务目标列表]]。
 **例子**: ''%objective.kill_zombies.left:20%''
-===== 积分: `point` =====
+===== 全局积分： globalpoint =====
+工作方式与普通积分变量相同，但不是显示来自玩家类别的点，而是显示全局、独立于玩家的类别中的点。
+**例子** ''%globalpoint.global_knownusers.left:100%''
+===== 积分: point =====
+此变量显示这个玩家的某项积分，或还欠缺的积分。第一个参数是积分名称（自定义），第二个参数可以是''amount''表示积分数值，或''left:x''表示距离总分x还缺多少分。
+**例子**: ''%point.音乐学习度.left:15%''
+===== 计算数学表达式： math.calc =====
+此变量允许您根据其他变量（例如积分或目标变量）执行计算并解析为指定计算的结果。变量始终以开头''math.calc:''，后跟应计算的计算。支持的操作是''+''，''-''，''*''，''/''和'' ^''。您可以使用''( )''和 ''[ ]''大括号，还可以使用计算绝对值''| |''。<color #ed1c24>但要小心，不要在命令(command)事件中使用绝对值，因为它会拆分命令</color>，''|''并且不要在没有括号的情况下嵌套它们（''|4*|3-5||''<color #ed1c24>行不通</color>，但 ''|4*(|3-5|)|''<color #22b14c>可行</color>）。此外，您可以使用舍入运算符''~''将其左侧的所有内容四舍五入为右侧给出的十进制位数。所以''4+0.35~1''=''4.4'' , ''4.2~0''=''4''。
-此变量显示这个玩家的某项积分，或还欠缺的积分。第一个参数是积分名称，第二个参数可以是''amount''表示积分数值，或''left:x''表示距离总分x还缺多少分。
+要在计算中使用变量，您有两个选择：首先只写变量，但不写''%''；这在不起作用的情况下不起作用，例如，如果变量包含数学运算符，您可以用花括号将其括起来''{ }''。在大括号内，您必须使用 转义''\''，因此要''\''在变量中写入 ''\\''a，''}''在变量中写入 a ''\''}。
-**例如**: ''%point.reputation.left:15%''
+**例子** ''%math.calc:100*(15-point.reputation.amount)% %math.calc:objective.kill_zombies.left/objective.kill_zombies.total*100~2% %math.calc:-{ph.myplugin_stragee+placeholder}%''
-===== 物品: `item` =====
+**在用的实例** ''take普通折扣材料: 'take 精金:%math.calc:2*(100-point.道德点.amount)+80%,山铜:%math.calc:10*(100-point.道德点.amount)+300%' ''
+===== 物品: item =====
-With this variable you can display amount of specific items in player's inventory or a number needed to reach specific amount. The first argument is the name of an item (as defined in _items.yml_) and the second one is either `amount` or `left:x`, where `x` is a number.
+你可以用这个变量显示玩家背包内某样物品的数量，或距离某数量还差多少个。第一个参数是物品的名称（在''items.yml''中定义），第二个参数可以是''amount''直接显示数量，或''left:x''显示距离x还缺多少个。
-**Example**: `%item.stick.amount%`
+**例子**: ''%item.stick.amount%''
-===== 插件版本: `version` =====
+===== 插件版本: version =====
-此变量用于显示插件的版本。你还可以在后面加上插件的名称用来显示你想要的插件版本。
+此变量用于显示插件的版本。你还可以在后面加上插件的名称用来显示你想要的插件的版本。
 **例如**: ''%version.Citizens%''
-===== 坐标: `location` =====
+===== 坐标: location =====
-This variable resolves to player's current location, formatted as an absolute location format (more about it in the _Reference_ chapter). The location will contain yaw and pitch. You can use it instead of coordinates as location arguments in events, conditions and objectives.
+此变量用于提取玩家坐标。格式采用//绝对坐标//，具体请参考[[插件手册:betonquest:基本概念#统一坐标格式_unified_location_formating|基本概念：统一坐标格式]]。此坐标会包含//偏角yaw//和//仰角pitch//（玩家头看向哪儿？）。你可以直接使用这个location而不用手动输入event/condition/objective里面的//coordinate//参数。
-**Example**: `%location%`
+**例子**: ''%location%''