命令
/scoreboard
创建并管理计分板记分项，设置其显示位置，并读取或更改玩家和其他实体的分数。
语法
| /scoreboard objectives add <objective> <criteria> [<displayName>] |
| /scoreboard objectives list |
| /scoreboard objectives modify <objective> (displayautoupdate <value>|displayname <displayName>) |
| /scoreboard objectives modify <objective> numberformat |
| /scoreboard objectives modify <objective> numberformat blank |
| /scoreboard objectives modify <objective> numberformat (fixed <contents>|styled <style>) |
| /scoreboard objectives modify <objective> rendertype (hearts|integer) |
| /scoreboard objectives remove <objective> |
| /scoreboard objectives setdisplay <slot> [<objective>] |
| /scoreboard players (add <targets>|remove <targets>) <objective> <score> |
| /scoreboard players display name <targets> <objective> [<name>] |
| /scoreboard players display numberformat <targets> <objective> |
| /scoreboard players display numberformat <targets> <objective> blank |
| /scoreboard players display numberformat <targets> <objective> (fixed <contents>|styled <style>) |
| /scoreboard players (enable <targets>|get <target>) <objective> |
| /scoreboard players list [<target>] |
| /scoreboard players operation <targets> <targetObjective> <operation> <source> <sourceObjective> |
| /scoreboard players reset <targets> [<objective>] |
| /scoreboard players set <targets> <objective> <score> |
参数
| 参数 | 值的类型 | 输入内容 |
|---|---|---|
| <objective> | 文本 | 计分项的名称。对于objectives add，它是新名称，为不含空格的单个词。在其他所有情况下，它必须是一个已存在的记分项。 |
| <criteria> | 计分项准则 | 计分项统计的内容：dummy、trigger、deathCount、playerKillCount、totalKillCount、health、food、air、armor、xp、level、teamkill.<color>、killedByTeam.<color>，或minecraft.custom:minecraft.jump这样的统计信息。 |
| <displayName> | 文本组件 | 为计分项显示的名称，以文本组件书写，例如 "Kills" 或 {text:"Kills",color:"red"}。 |
| <value> | 真或假 | displayautoupdate的值为true或false。 |
| <contents> | 文本组件 | 在numberformat fixed中代替数字显示的文本组件。 |
| <style> | 文本样式 | 在numberformat styled中用于数字的文本样式，例如{color:"gold"}。 |
| <slot> | 显示位置 | 显示位置：list、sidebar、below_name 或 sidebar.team.<color>。 |
| <targets> | 分数持有者 | 要更改的分数持有者：目标选择器、名称，或用*表示所有被记录的分数持有者。 |
| <score> | 整数 | 要设置的数字（任意整数），或要增加或移除的数量（不小于0）。至少为0。 |
| <name> | 文本组件 | 在players display name中代替分数持有者名称显示的文本组件。 |
| <target> | 分数持有者 | players get和players list所用的单个得分持有者。 |
| <targetObjective> | 计分板记分项 | 分数被 players 操作更改的计分项。不能是只读的。 |
| <operation> | 分数运算 | =、+=、-=、*=、/=、%=、<、>、>< 之一。 |
| <source> | 分数持有者 | 其分数在players operation中用作第二个值的分数持有者。 |
| <sourceObjective> | 计分板记分项 | 读取来源分数的计分项。 |
详细信息
| 权限等级 | 2：管理员、开启作弊的世界、命令方块和函数 |
| 适用于 | 开启作弊的单人游戏、多人游戏服务器、命令方块和函数。需要权限等级2（游戏管理员）：管理员、开启作弊的世界中的玩家、命令方块和函数。 |
| 结果 | 每个子命令都会报告它更改了什么。数值结果：objectives add 和 objectives remove 返回现存的计分项数量；objectives list 返回计分项数量；objectives setdisplay 和 objectives modify 返回0。 players get 返回分数；players set、add、remove 和 operation 返回所有目标新分数之和；players reset 和 players display 返回目标数量；players enable 返回新启用了 trigger 的目标数量； players list 返回被记录的分数持有者数量，若指定目标，则返回该目标拥有的分数数量。 |
| objectives add | 创建一个记分项，包含名称、准则和可选的显示名称。名称是不含空格的单个词。不带显示名称时，显示名称本身。如果名称已被占用，则会失败并提示“已经存在同名记分项”。 |
| 准则 | 基本准则：dummy（仅通过命令更改）、trigger（玩家用/trigger自行更改）、deathCount、playerKillCount、totalKillCount、health、food、air、armor、xp、level。队伍准则：teamkill.<color>和killedByTeam.<color>，配合red或dark_blue等队伍颜色。 统计准则使用minecraft.<type>:minecraft.<id>的形式，类型有broken、crafted、custom、dropped、killed、killed_by、mined、picked_up和used，例如minecraft.mined:minecraft.stone或minecraft.custom:minecraft.jump。 |
| 只读准则 | health、food、air、armor、xp和level由游戏保持更新。它们的分数不能用players set、add、remove更改，也不能作为operation的目标：“Scoreboard objective ... is read-only”。 |
| objectives list和remove | objectives list显示所有目标。objectives remove删除一个目标及其所有分数。 |
| objectives setdisplay | 在显示位置中显示一个计分项。槽位：list（玩家列表）、sidebar（屏幕右侧）、below_name（玩家名牌下方），以及绑定到队伍颜色的侧边栏sidebar.team.<color>，颜色有black、dark_blue、dark_green、dark_aqua、dark_red、dark_purple、gold、 gray、dark_gray、blue、green、aqua、red、light_purple、yellow和white。省略计分项会清空该栏位。如果栏位已为空或已显示该记分项，则失败。 |
| objectives modify | displayname更改显示的名称。rendertype在integer（数字）和hearts（心形图标）之间切换；health默认使用hearts，其余全部使用integer。numberformat设置该目标中所有分数的默认外观。 displayautoupdate的true或false用于开启或关闭该目标显示的自动更新。 |
| 数字格式 | blank 隐藏数字。fixed <contents> 显示固定文本来代替数字。styled <style> 以文本样式显示数字，例如 {color:"gold",bold:true}。只写 numberformat 而后面不带任何内容，会再次移除该格式。 整个计分项（objectives modify ... numberformat）和单个分数持有者（players display numberformat）都有同样的选项。 |
| players set, add, remove | set可为分数设置从-2147483648到2147483647的任意整数。add和remove接受0或更大的数量，并按该数量改变当前分数。还没有分数的目标从0开始。 |
| players get和list | get显示某个目标的分数，若没有设置则失败并提示“Can't get value of ... for ...; none is set”。不带目标的list显示所有被追踪的名称；带目标时显示该目标的所有分数。 |
| players reset | 移除目标在某个记分项中的分数；如果没有指定记分项，则移除其所有分数。被重置的分数将不再有任何设置，这与0不同。 |
| players enable | 让目标对带有 trigger 准则的计分项使用一次 /trigger。对其他计分项会失败并提示“只能启用trigger类记分项”，并提示“没有任何变化。该触发器已启用”，如果没有任何目标被更改。 |
| players operation | 使用来源分数更改目标分数。符号：=将目标设为来源的值，+=相加，-=相减，*=相乘，/=相除（向下取整），%=取除法的余数（除数为正时不会为负），<取两者中较小的，>取较大的，><交换两个分数。 除以0会失败并提示“不能除以零”。有多个来源时，该操作对每个来源各应用一次。 |
| players display | display name为某个目标在计分板显示中给计分持有者设置另一个名称；省略名称则移除。display numberformat更改该持有者的数字在该目标中的显示方式。 |
| 分数持有者 | 目标可以是目标选择器、玩家名称或任何自拟的名称，例如#total。*代表所有被追踪的分数持有者。选择器未找到任何目标时会失败并提示“找不到与分数关联的持有者”。 |
示例
/scoreboard objectives add kills playerKillCount "Kills"创建一个名为kills的记分项，统计玩家击杀数，并显示为Kills。
/scoreboard objectives add points dummy创建一个名为points的记分项，仅通过命令改变。
/scoreboard objectives setdisplay sidebar kills在屏幕右侧显示kills计分项。
/scoreboard players set @s points 10将你的points分数设为10。
/scoreboard players add @a points 1给每名在线玩家增加1分。
/scoreboard players operation @s points += @s kills把你的kills分数加到你的points分数上。
/scoreboard objectives modify points numberformat styled {color:"gold"}以金色显示得分项的所有数值。
/scoreboard players reset @a points移除每个在线玩家的点数分数。
