Scoreboard
The scoreboard system is a complex gameplay mechanic utilized through commands. Mainly intended for mapmakers and server operators, scoreboards are used to track, set, and list the scores of players.
Objectives
Entities can hold scores in the scoreboard specified by objective. Objectives track a number of points for entities while meeting a single criteria. Objective scores are stored as integers with the range of -99,999,999,999,999 to 100,000,000,000,000.
Objectives have two main properties: a name and a criterion. The objective's name is used internally for referencing in commands and selector arguments. And the criterion determines its behavior — primarily what to track.
Objective names must be single words containing only alphanumeric characters and underscores.
The entity's score in any objective can be changed from commands. It can be increased by, decreased by, or set to a given amount with commands. Currently, only players are supported, and not other entities.
Objectives also have other properties to customize their appearance and behavior:
displayname
Specify the objective's display name that appears in the sidebar and as the result of some commands. By default, the objective's name is the display name.
numberformat
Specify the objective's number format for the score. The number format can be blank, fixed, and styled.
Blank number format displays nothing on the scoreboard. Fixed number format displays the contents specified in the command.
Styled number format displays the score number with the color specified in the command.
The number format property and the score holder's name can be changed per-entity using /scoreboard players display numberformat|name <target> ...
Criteria
These criteria's names consist of a single alphabetical string.
dummy
Score that can be changed only by commands, and not automatically by the game. This can be used for storing integer states and variables, which then can be used with the scoreboard's operations to do arithmetic calculation.
trigger
Score that can be changed by commands, and not automatically by the game. The /trigger command can be used by players to set or increment and decrement their own score. The command fails if the objective has not been "enabled" for the player using it. If the player uses it, the objective is automatically disabled for them afterward. By default, all trigger objectives are disabled for any players. Ordinary players can use the /trigger command, even if cheats are disabled or if they are not server operators, in which case this is useful for safely taking non-operator player input.
deathCount
Score increments automatically for a player when they die.
playerKillCount
Score increments automatically for a player when they kill another player.
health
Represents the amount of health/HP the player has
Compound criteria
Compound criteria's names are divided into parts, delimited with periods (.). For example, killed_by.mobs_mc:zombie is a valid compound criteria, under which player scores would increment whenever they're killed by a zombie.
teamkill.<team_color>
Player scores increment when a player kills a member of the given colored team.
These criteria follow the complete format teamkill.<team_color>, where <team_color> is a valid team color.
killedByTeam.<team_color>
Player scores increment when killed by a member of the given colored team.
These criteria follow the complete format killedByTeam.<team_color>, where <team_color> is a valid team color.
killed_by.<entity>
picked_up.<item>
Player scores increment when picking up the specified item. <item> can be any itemstring or alias, group:<groupname>, or * to match any item. Scores are incremented by one for each itemstack picked up, regardless of how many items are in the itemstack.
mined.<node> or dug.<node>
Player scores increment when digging the specified node. <node> can be any itemstring or alias, group:<groupname>, or * to match any node.
placed.<node>
Player scores increment when placing the specified node. <node> can be any itemstring or alias, group:<groupname>, or * to match any node.
crafted.<item>
Player scores increment when crafting the specified item. <item> can be any itemstring or alias, group:<groupname>, or * to match any item. Scores are incremented by one for each craft, regardless of how many items are crafted.
# Display slots
Via the /scoreboard objectives setdisplay command, players' scores in specific objectives can be displayed in certain 'slots' in-game. Each 'display slot' can show one objective at a time, and multiple 'display slots' may be used for the same or different objectives.
sidebar
Shows on the right hand side of the screen. Shows up to 15 entities with the highest score of that objective with a heading labeled with the objective's <DisplayName>. Note that players are shown even if offline, and untracked players are not shown. In addition, fake players with names starting with a # do not show up in the sidebar under any circumstances.
sidebar.team.<color>
There are 16 team-specific sidebar display slots. These operate the same as the standard sidebar slot, but display only to players who are on teams that use the specified color (for example, "sidebar.team.green" displays to players on "green" teams). <color> must be a valid team color.
Teams
A team is a list of players (or fake players) that can be used by mapmakers or server operators to group players together as allies.
Players can only have one team; teams cannot share members.
Teams have a name property, used internally for reference in commands. It is a single word containing only alphanumeric characters and underscores. Teams also have several other properties to customize their appearence and behavior:
displayName
Specify team's display name that appears on the player name in chat, nametag, player list menu, and on the scoreboard sidebar.
Long string
color
Specify team's color that appears on the player name in chat and the scoreboard sidebar.
String ("black", "dark_blue", "dark_green", "dark_aqua", "dark_red", "dark_purple", "gold", "gray", "dark_gray", "blue", "green", "aqua", "red", "light_purple", "yellow", or "white")
friendlyFire
Allow whether or not member can attack other member on the same team. In non-MineClone games, this only affects direct damage (so not, for example, damage dealt with a bow).
Boolean (defaults to true)
nameFormat
Specifies the team's name format. Any instance of %s is replaced with the player's name. For example, a player named ThePython on a team with the nameFormat of [ADMIN] %s the Great would appear as [ADMIN] ThePython the Great.
Long string
History
v1.0
Added the scoreboard, and several criteria
v2.0
Added crafted.<item>, dug.<node>, mined.<node>, picked_up.<item>, and placed.<node> criteria
Changed sidebar.<color> to sidebar.team.<color>
Force scores to be integers
Fixes dividing scores by zero
Last updated