命令/scoreboard

命令/scoreboard

 命令

scoreboard

需要的权限等级	2[仅Java版] 1[仅基岩版]
限制条件	启用作弊[仅基岩版]

  本文章介绍的是启用记分板的命令。关于记分板具体用法，请见“记分板”。

这些命令管理记分板的目标、玩家和队伍。

目录

• 1 语法
• 2 参数
• 3 输出
• 4 历史

语法

• Java版

scoreboard objectives (add|list|modify|remove|setdisplay)

add <记分项> <准则> [<显示名称：字符串>]

创建一个具有给定的名称、准则、可选的显示名称的记分项。<记分项>必须是小于16个字符的纯文本；<准则>必须是有效的准则类型。<显示名称>必须是原始JSON文本，如果未指定，默认为<记分项>；所有的参数均区分大小写。

list

列出所有存在的记分项、显示名称与准则。

modify <准则> displayname <显示名称>

更改显示未知中记分板的显示名称。被指定的准则必须存在。名称必须是JSON文本组件。

modify <记分项> rendertype (hearts|integer)

在列表将记分项<记分项>的数值以爱心（hearts）或数字（integer）显示。

remove <记分项>

删除记分板系统中该记分项的所有有关内容。记分项、玩家分数的数据都会被删除，且如果记分项在显示位置上，该显示位置将会被清空。

setdisplay <槽位> [<记分项>]

在指定位置显示指定记分项的分数信息。合法的位置已在显示位置里列出并描述。

scoreboard players (add|enable|get|list|operation|remove|reset|set)

add <targets> <记分项> <分数>

往实体目标在记分项记分项上的分数增加数量分。如果没有分数则当作0分修改。*可用以代表所有正在被记分板追踪的实体。

enable <目标> <触发器>

使实体目标可以对指定触发型记分项触发器使用命令/trigger。在此操作完成前，实体目标对记分项使用/trigger时将会失败。一旦实体对记分项使用了/trigger，记分项将再次变得不可操作，需要再次使用此命令。*可用以代表所有正在被记分板追踪的实体。

get <目标> <记分项>

显示该实体在记分项上的分数。

list [<目标>]

显示所有被记分板系统追踪的实体。可选的实体名称参数项可用以显示指定实体的所有分数，且往目标填写*（星号）会显示所有正被记分板跟踪的实体。

operation <目标> <目标记分项> <操作> <来源> <来源记分项>

使用选择器在记分项记分项上的分数作为输入，进行运算操作后把结果作为记分项实体目标在记分项名为目标记分项上的分数。 运算操作<操作> 可以是：

• += 求和：把选择器的分数加到 目标名称的分数上。
• -= 求差：在目标名称的分数上减去选择器的分数。
• *= 求积：将目标名称的分数设为目标名称的分数与选择器分数的乘积。
• /= 求商：将目标名称的分数设为被选择器的分数除后的结果。
•  %= 求余：将目标名称的分数设为被选择器的分数除后得到的余数。
• = 赋值：把目标名称的分数设为选择器的分数。
• < 取较小值：如果选择器的分数比目标名称的分数小，则把目标名称的分数设为选择器的分数。
• > 取较大值：如果选择器的分数比目标名称的分数大，则把目标名称的分数设为选择器的分数。
• >< 交换选择器与目标名称的分数。 除><外，选择器在记分项上的分数会保持不变。*可填在目标名称或选择器（但不能同时）用以代表所有正在被记分板追踪的实体。

remove <目标> <记分项> <分数>

从实体目标在记分项记分项上的分数扣除数量分。如果没有分数则当作0分修改。*可用以代表所有正在被记分板追踪的实体。

reset <目标> [<记分项>]

清空实体目标的一项或所有分数。如果指定了记分项记分项，只清空对应记分项的分数；否则删除实体所有记分项上的分数。需要注意这不仅仅是设分数为0：实体将会整个从记分板上被移除（或从给定的记分项）。星号（*）可用以代表所有正在被记分板追踪的实体。

set <目标> <记分项> <分数>

将实体目标在记分项记分项上的分数设为数量分。*可用以代表所有正在被记分板追踪的实体。

• 基岩版

scoreboard objectives (add|list|remove|setdisplay)

add <记分项：字符串> dummy [显示名称]

创建一个具有给定的名称、准则、可选的显示名称的记分项。<记分项>必须是小于16个字符的纯文本；还可以被引号包围。<准则>必须是有效的准则类型。<显示名称>必须是原始JSON文本，如果未指定，默认为<objective>；它还可以是非数字的纯文本。所有的参数均区分大小写。dummy是当前基岩版唯一支持的准则。

list

列出所有存在的记分项、显示名称与准则。

remove <记分项：字符串>

删除记分板系统中该记分项的所有有关内容。记分项、玩家分数的数据都会被删除，且如果记分项在显示位置上，该显示位置将会被清空。

setdisplay <list|sidebar> [记分项：字符串] [ascending|descending] belowname [记分项：字符串]

在指定位置显示指定记分项的分数信息。合法的位置已在显示位置里列出并描述。如果位置是list或sidebar，则还有可选的参数ascending|descending来指定排序顺序。注意记分项参数是可选的，如果不提供，则该显示位置会被清空（回到其默认状态）

scoreboard players (list|reset|test|random|set|add|remove|operation)

list [玩家：目标]

显示所有被记分板系统追踪的实体。可选的实体名称参数项可用以显示指定实体的所有分数，且往目标填写*（星号）会显示所有正被记分板跟踪的实体。

reset <玩家：目标> [记分项：字符串]

清空实体目标的一项或所有分数。如果指定了记分项记分项，只清空对应记分项的分数；否则删除实体所有记分项上的分数。需要注意这不仅仅是设分数为0：实体将会整个从记分板上被移除（或从给定的记分项）。星号（*）可用以代表所有正在被记分板追踪的实体。

test <玩家：目标> <记分项：字符串> <最小值：通配符 整数> [最大值：通配符 整数]

检测计分项是否在最小值和最大值范围内（若不填，默认最大值为整型数最大值2147483647）。最小值和最大值可替换为星号（*），以表示整型数范围内的任何值（-2147483648 ~ 2147483647）

random <玩家：目标> <记分项：字符串> <最小值：整数> [最大值：整数]

把实体目标在计分项上的分数设为一个从最小值到最大值的随机数，包含最大最小值。

<set|add|remove> <玩家：目标> <记分项：字符串> <数量：整数>

set：设置实体目标在记分项记分项上的分数为分数，并在已有分数存在时覆盖之。*可以用于目标项以代表所有正在被记分板追踪的实体。

add：往实体目标在记分项记分项上的分数增加数量分。如果没有分数则当作0分修改。*可用以代表所有正在被记分板追踪的实体。

remove：从实体目标在记分项记分项上的分数扣除数量分。如果没有分数则当作0分修改。*可用以代表所有正在被记分板追踪的实体。

operation <目标名称：目标> <目标记分项：字符串> <操作：操作符> <选择器：目标> <记分项：字符串>

使用选择器在记分项记分项上的分数作为输入，进行运算操作后把结果作为记分项实体目标在记分项名为目标记分项上的分数。 运算操作<操作> 可以是：

• += 求和：把选择器的分数加到 目标名称的分数上。
• -= 求差：在目标名称的分数上减去选择器的分数。
• *= 求积：将目标名称的分数设为目标名称的分数与选择器分数的乘积。
• /= 求商：将目标名称的分数设为被选择器的分数除后的结果。
•  %= 求余：将目标名称的分数设为被选择器的分数除后得到的余数。
• = 赋值：把目标名称的分数设为选择器的分数。
• < 取较小值：如果选择器的分数比目标名称的分数小，则把目标名称的分数设为选择器的分数。
• > 取较大值：如果选择器的分数比目标名称的分数大，则把目标名称的分数设为选择器的分数。
• >< 交换选择器与目标名称的分数。 除><外，选择器在记分项上的分数会保持不变。*可填在目标名称或选择器（但不能同时）用以代表所有正在被记分板追踪的实体。

命令	版本	条件	成功次数	/execute store success ...	/execute store result ...
任意	Java版	执行失败	0	0	0
/scoreboard objectives add...		执行成功	1	1	当前记分项的总数量
/scoreboard objectives list...		执行成功	1	1	当前记分项的总数量
/scoreboard objectives modify...		执行成功	1	1	0
/scoreboard objectives remove...		执行成功	1	1	当前记分项的总数量
/scoreboard objectives setdisplay...		执行成功	1	1	0
/scoreboard players add...		执行成功	1	1	命令执行后，所有 <目标> 的分数之和
/scoreboard players enable...		执行成功	1	1	新允许的玩家数量
/scoreboard players get...		执行成功	1	1	指定<目标> 的分数
/scoreboard players list...		执行成功	1	1	指定记分项上拥有分数的目标的数量
/scoreboard players operation...		执行成功	1	1	命令执行后，所有 <目标>的分数之和
/scoreboard players remove...		执行成功	1	1	命令执行后，所有 <目标>的分数之和
/scoreboard players reset...		执行成功	1	1	被重置的目标数量
/scoreboard players set...		执行成功	1	1	指定<分数>乘<目标>数量的积