这些命令管理记分板的目标、玩家和队伍。
语法[]
Java版[]
scoreboard objectives (add|list|modify|remove|setdisplay)
add <记分项> <准则> [<显示名称:字符串>]
- 创建一个具有给定的名称、准则、可选的显示名称的记分项。
<记分项>
必须是纯文本;<准则>
必须是有效的准则类型。<显示名称>
必须是原始JSON文本,如果未指定,默认为<记分项>
;所有的参数均区分大小写。
list
- 列出所有存在的记分项、显示名称与准则。
modify <准则> displayname <显示名称>
- 更改显示未知中记分板的显示名称。被指定的准则必须存在。名称必须是JSON文本组件。
modify <记分项> rendertype (hearts|integer)
- 在列表将记分项<记分项>的数值以爱心(hearts)或数字(integer)显示。
remove <记分项>
- 删除记分板系统中该记分项的所有有关内容。记分项、玩家分数的数据都会被删除,且如果记分项在显示位置上,该显示位置将会被清空。
setdisplay <槽位> [<记分项>]
- 在指定位置显示指定记分项的分数信息。合法的位置已在显示位置里列出并描述。
scoreboard players (add|enable|get|list|operation|remove|reset|set)
add <目标> <记分项> <分数>
- 往实体目标在记分项记分项上的分数增加数量分。如果没有分数则当作0分修改。*可用以代表所有正在被记分板追踪的实体。
- 目标所指定的实体不必存在,可以使用自定义的名称,下同。
enable <目标> <触发器>
- 使实体目标可以对指定触发型记分项触发器使用命令
/trigger
。在此操作完成前,实体目标对记分项使用/trigger
时将会失败。一旦实体对记分项使用了/trigger
,记分项将再次变得不可操作,需要再次使用此命令。*可用以代表所有正在被记分板追踪的实体。
get <目标> <记分项>
- 显示该实体在记分项上的分数。仅可指定一个实体,且不能为
*
。
list [<目标>]
- 显示所有被记分板系统追踪的实体。可选的实体名称参数项可用以显示指定实体的所有分数,留空目标会显示所有正被记分板跟踪的实体。由于MC-136858,往目标填写
*
无法追踪到任何实体。
operation <目标> <目标记分项> <操作> <来源> <来源记分项>
- 使用记分项实体来源在记分项名为来源记分项上的分数作为输入,进行运算操作后把结果作为记分项实体目标在记分项名为目标记分项上的分数。若来源的来源记分项未被赋值,则它会自动被设为0。 运算操作<操作> 可以是:
- += 求和:把选择器的分数加到 目标名称的分数上。
- -= 求差:在目标名称的分数上减去选择器的分数。
- *= 求积:将目标名称的分数设为目标名称的分数与选择器分数的乘积。
- /= 求商:将目标名称的分数设为被选择器的分数除后的结果。
- %= 求余:将目标名称的分数设为被选择器的分数除后得到的余数。
- = 赋值:把目标名称的分数设为选择器的分数。
- < 取较小值:如果选择器的分数比目标名称的分数小,则把目标名称的分数设为选择器的分数。
- > 取较大值:如果选择器的分数比目标名称的分数大,则把目标名称的分数设为选择器的分数。
- >< 交换选择器与目标名称的分数。 除><外,选择器在记分项上的分数会保持不变。*可填在目标名称或选择器(但不能同时)用以代表所有正在被记分板追踪的实体。
remove <目标> <记分项> <分数>
- 从实体目标在记分项记分项上的分数扣除数量分。如果没有分数则当作0分修改。*可用以代表所有正在被记分板追踪的实体。
reset <目标> [<记分项>]
- 清空实体目标的一项或所有分数。如果指定了记分项记分项,只清空对应记分项的分数;否则删除实体所有记分项上的分数。需要注意这不仅仅是设分数为0:实体将会整个从记分板上被移除(或从给定的记分项)。星号(*)可用以代表所有正在被记分板追踪的实体。
set <目标> <记分项> <分数>
- 将实体目标在记分项记分项上的分数设为数量分。*可用以代表所有正在被记分板追踪的实体。
基岩版[]
scoreboard objectives
scoreboard objectives add <objective: string> dummy [displayName: string]
- 创建一个具有给定的名称、准则、可选的显示名称的记分项。
<objective: string>
必须是小于16个字符的纯文本;还可以被引号包围。<displayName: string>
必须是非数字的纯文本。如果未指定,默认为<objective>
。所有的参数均区分大小写。
scoreboard objectives list
- 列出所有存在的记分项、显示名称与准则。
scoreboard objectives remove <objective: string>
- 删除记分板系统中该记分项的所有有关内容。记分项、玩家分数的数据都会被删除,且如果记分项在显示位置上,该显示位置将会被清空。
scoreboard objectives setdisplay <list|sidebar> [objective: string] [ascending|descending]
scoreboard objectives setdisplay belowname [objective: string]
- 在指定位置显示指定记分项的分数信息。合法的位置已在显示位置里列出并描述。如果位置是
list
或sidebar
,则还有可选的参数ascending|descending
来指定排序顺序。注意记分项参数是可选的,如果不提供,则该显示位置会被清空(回到其默认状态)
scoreboard players
scoreboard players <set|add|remove> <player: target> <objective: string> <count: int>
- set:设置实体目标在记分项记分项上的分数为分数,并在已有分数存在时覆盖之。*可以用于目标项以代表所有正在被记分板追踪的实体。
- add:往实体目标在记分项记分项上的分数增加数量分。如果没有分数则当作0分修改。*可用以代表所有正在被记分板追踪的实体。
- remove:从实体目标在记分项记分项上的分数扣除数量分。如果没有分数则当作0分修改。*可用以代表所有正在被记分板追踪的实体。
scoreboard players list [playername: target]
- 显示所有被记分板系统追踪的实体。可选的实体名称参数项可用以显示指定实体的所有分数,且往目标填写*(星号)会显示所有正被记分板跟踪的实体。
scoreboard players operation <targetName: target> <targetObjective: string> <operation: operator> <selector: target> <objective: string>
- 使用选择器在记分项记分项上的分数作为输入,进行运算操作后把结果作为记分项实体目标在记分项名为目标记分项上的分数。 运算操作<操作> 可以是:
- += 求和:把选择器的分数加到 目标名称的分数上。
- -= 求差:在目标名称的分数上减去选择器的分数。
- *= 求积:将目标名称的分数设为目标名称的分数与选择器分数的乘积。
- /= 求商:将目标名称的分数设为被选择器的分数除后的结果。
- %= 求余:将目标名称的分数设为被选择器的分数除后得到的余数。
- = 赋值:把目标名称的分数设为选择器的分数。
- < 取较小值:如果选择器的分数比目标名称的分数小,则把目标名称的分数设为选择器的分数。
- > 取较大值:如果选择器的分数比目标名称的分数大,则把目标名称的分数设为选择器的分数。
- >< 交换选择器与目标名称的分数。 除><外,选择器在记分项上的分数会保持不变。*可填在目标名称或选择器(但不能同时)用以代表所有正在被记分板追踪的实体。
scoreboard players random <player: target> <objective: string> <min: int> <max: int>
- 把实体目标在记分项上的分数设为一个从最小值到最大值的随机数,包含最大最小值。
scoreboard players reset <player: target> [objective: string]
- 清空实体目标的一项或所有分数。如果指定了记分项记分项,只清空对应记分项的分数;否则删除实体所有记分项上的分数。需要注意这不仅仅是设分数为0:实体将会整个从记分板上被移除(或从给定的记分项)。星号(*)可用以代表所有正在被记分板追踪的实体。
scoreboard players test <player: target> <objective: string> <min: wildcard int> [max: wildcard int]
- 检测记分项是否在最小值和最大值范围内(若不填,默认最大值为整型数最大值2147483647)。最小值和最大值可替换为星号(*),以表示整型数范围内的任何值(-2147483648 ~ 2147483647)
参数[]
主条目:记分板§命令列表
输出[]
命令 | 版本 | 条件 | 成功次数 | /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 | 指定<分数> 乘<目标> 数量的积 |
历史[]
主条目:记分板§历史
Java版 | |||||
---|---|---|---|---|---|
1.5 | 13w04a | 加入了/scoreboard 。 | |||
1.13 | ? | 记分板名称不能再包含: 等字符。 | |||
17w45a | /scoreboard teams 改为/team 。
| ||||
/scoreboard players tag 改为/tag 。 | |||||
pre7 | 加入了语法/scoreboard objectives modify <记分项> displayname <显示名称> 。 | ||||
pre8 | 加入了语法/scoreboard objectives modify <记分项> rendertype hearts ,使生命值栏目显示为心形,类似:![]() ![]() ![]() ![]() ![]() ![]() | ||||
加入了语法/scoreboard objectives modify <记分项> rendertype integer ,使生命值栏目显示为黄色的数字。 | |||||
记分项名称现在为文本元件,而不是纯字符串。 | |||||
1.18 | 21w37a | 在此之前,记分项和分数持有者的长度不能超过16个字符。 | |||
基岩版 | |||||
1.7.0 | 1.7.0.2 | 加入了/scoreboard 。 |
语言