差别

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

--- 插件手册:betonquest:变量列表 [2018/06/15 00:28] – 创建小小k酱
+++ 插件手册:betonquest:变量列表 [2021/09/24 13:25] (当前版本) – [计算数学表达式： math.calc] duangfafa
@@ 行 1: / 行 1: @@
-====== Variables List ======
+====== 变量列表 Variables List ======
+（版本：2017-08-21 翻译：kjiang [[https://github.com/Co0sh/BetonQuest/wiki/Variables-List/eba93848d2ceed8f17e2f01548214e7fbd9752e0|原文链接]]）
-===== Player: `player` =====
+（kjiang备注）变量可以直接写在对话conversation脚本中用于显示某些数值，或在条件condition中用于判断。不同于event、condition、objective，变量是用点''.''而不是空格连接参数的。
-This variable will be replaced with the name of the player. If you add `display` argument, it will use display name instead of real name.
+===== 玩家名字: player =====
-**Example**: `%player.display%`
+此变量显示玩家的名字/ID。如果你使用了''display''参数，此变量会使用玩家的显示名称/昵称（如Essentials定义的display name）而不是实际ID。
-===== NPC: `npc` =====
+**例子**: ''%player.display%''
-It's a very simple variable. It's replaced by the name of the NPC in player's language.
+===== NPC: npc =====
-**Example**: `%npc%`
+非常简单的变量。''npc''会以玩家的语言显示NPC的名字。
-===== Objective: `objective` =====
+**例子**: ''%npc%''
-Using this variable you can display a property of an objective. The first argument is an ID of the objective as defined in _objectives.yml_ (not the type). Make sure that the player has this objective active or it will be replaced with nothing (""). Second argument is the name of a property you want to display. All properties are described in "Objectives List" chapter.
+===== 任务目标属性: objective =====
-**Example**: `%objective.kill_zombies.left:20%`
+你可以用此变量显示某个任务目标的流程/进度等等。第一个参数是//objectives.yml//中定义的任务目标的ID（不是//任务目标列表//中的任务目标本身）。请确保此玩家已启动了这个任务目标，否则这个变量将会显示空白（'' ''）；第二个参数是这个任务目标的某个''属性property''。每一种//目标objective//都有各种不同的任务''属性property''可供利用，具体你可以参阅[[插件手册:betonquest:任务目标|任务目标列表]]。
-## Point: `point`
+**例子**: ''%objective.kill_zombies.left:20%''
-This variable displays the amount of points you have in some category or amount of points you need to have to reach a number. The first argument is the name of a category and the second argument is either `amount` or `left:x`, where `x` is a number.
+===== 全局积分： globalpoint =====
-**Example**: `%point.reputation.left:15%`
+工作方式与普通积分变量相同，但不是显示来自玩家类别的点，而是显示全局、独立于玩家的类别中的点。
-## Item: `item`
+**例子** ''%globalpoint.global_knownusers.left:100%''
+===== 积分: point =====
-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.
+此变量显示这个玩家的某项积分，或还欠缺的积分。第一个参数是积分名称（自定义），第二个参数可以是''amount''表示积分数值，或''left:x''表示距离总分x还缺多少分。
-**Example**: `%item.stick.amount%`
+**例子**: ''%point.音乐学习度.left:15%''
-## Version: `version`
+===== 计算数学表达式： math.calc =====
-This variable displays the version of the plugin. You can optionally add the name of the plugin as an argument to display version of another plugin.
+此变量允许您根据其他变量（例如积分或目标变量）执行计算并解析为指定计算的结果。变量始终以开头''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''。
-**Example**: `%version.Citizens%`
+要在计算中使用变量，您有两个选择：首先只写变量，但不写''%''；这在不起作用的情况下不起作用，例如，如果变量包含数学运算符，您可以用花括号将其括起来''{ }''。在大括号内，您必须使用 转义''\''，因此要''\''在变量中写入 ''\\''a，''}''在变量中写入 a ''\''}。
-## Location: `location`
+**例子** ''%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}%''
-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.
+**在用的实例** ''take普通折扣材料: 'take 精金:%math.calc:2*(100-point.道德点.amount)+80%,山铜:%math.calc:10*(100-point.道德点.amount)+300%' ''
+===== 物品: item =====
-**Example**: `%location%`
+你可以用这个变量显示玩家背包内某样物品的数量，或距离某数量还差多少个。第一个参数是物品的名称（在''items.yml''中定义），第二个参数可以是''amount''直接显示数量，或''left:x''显示距离x还缺多少个。
+**例子**: ''%item.stick.amount%''
+===== 插件版本: version =====
+此变量用于显示插件的版本。你还可以在后面加上插件的名称用来显示你想要的插件的版本。
+**例如**: ''%version.Citizens%''
+===== 坐标: location =====
+此变量用于提取玩家坐标。格式采用//绝对坐标//，具体请参考[[插件手册:betonquest:基本概念#统一坐标格式_unified_location_formating|基本概念：统一坐标格式]]。此坐标会包含//偏角yaw//和//仰角pitch//（玩家头看向哪儿？）。你可以直接使用这个location而不用手动输入event/condition/objective里面的//coordinate//参数。
+**例子**: ''%location%''