Minecraft Wiki
Advertisement
Minecraft Wiki
scoreboard
Permission level
required

2‌[JE only]
1‌[BE only]

Restrictions

Cheat only‌[BE only]

Manages and displays scores for various scoreboard objectives.

Objectives commands[]

list[]

Syntax
scoreboard objectives list
Description
List all existing objectives with their display names and criteria.
Result
CommandTriggerJava EditionBedrock Edition
... listthere's no objective in scoreboard system Successful Failed
On successList all existing objectives.
Output
CommandEditionSituationSuccess Count/execute store success .../execute store result ...
... listJava EditionOn success11the number of objectives in scoreboard system
Bedrock EditionOn fail0N/AN/A
On successthe number of objectives in scoreboard systemN/AN/A

add[]

Syntax
scoreboard objectives add <objective> <criteria> [<displayName>] (Java Edition)
scoreboard objectives add <objective: string> dummy [displayName: string] (Bedrock Edition)
Description
Create a new objective with the given internal objective name, specified criterion, and the optional display name.
Arguments
JE<objective>: string
BE: objective: string: basic_string
Specifies the internal objective name.
Must be a string. In Java Edition, it must be in a single word (Allowed characters include: -, +, ., _, A-Z, a-z, and 0-9). In Bedrock Edition, it must be either a single word that isn't a number (allowed characters: -, :, ., _, A-Z, a-z, and 0-9) or a double-quoted string.
JE<criteria>: objective_criteria
BE: dummy
Specifies the criterion of the new objective.
Must be a scoreboard objective criterion. In Bedrock Edition, "dummy" is the only criterion currently supported.
JE<displayName>: component
BE: displayName: string: basic_string
Specifies the display name, defaulting to <objective> when unspecified.
In Java Edition, must be a raw JSON text. In Bedrock Edition, it must be either a single word that isn't a number (allowed characters: -, :, ., _, A-Z, a-z, and 0-9) or a double-quoted string.
Result
CommandTriggerJava EditionBedrock Edition
... add ...the arguments are not specified correctly Unparseable Failed
<objective> already exists Failed
On successCreate a new objective.
Output
CommandEditionSituationSuccess Count/execute store success .../execute store result ...
... add ...Java EditionOn fail000
On success11the number of objectives in scoreboard system after execution
Bedrock EditionOn fail0N/AN/A
On success1N/AN/A

remove[]

Syntax
scoreboard objectives remove <objective> (Java Edition)
scoreboard objectives remove <objective: string> (Bedrock Edition)
Description
Delete the named objective from the scoreboard system. Data is deleted from the objectives list and score holders' scores, and if it was on a display list it is no longer displayed.
Arguments
JE<objective>: objective
BE: objective: string: basic_string
Specifies the internal objective name.
In Java Edition, it must be an valid scoreboard objective name. In Bedrock Edition, it must be either a single word that isn't a number (allowed characters: -, :, ., _, A-Z, a-z, and 0-9) or a double-quoted string.
Result
CommandTriggerJava EditionBedrock Edition
... remove ...the arguments are not specified correctly Unparseable Failed
<objective> doesn't exist Failed
On successDelete the objective.
Output
CommandEditionSituationSuccess Count/execute store success .../execute store result ...
... remove ...Java EditionOn fail000
On success11the number of objectives in scoreboard system after execution
Bedrock EditionOn fail0N/AN/A
On success1N/AN/A

setdisplay[]

Syntax
scoreboard objectives setdisplay <slot> [<objective>] (Java Edition)
scoreboard objectives setdisplay <list|sidebar> [objective: string] [ascending|descending] (Bedrock Edition)
scoreboard objectives setdisplay belowname [objective: string] (Bedrock Edition)
Description
Display score info for the objective in the given slot. Note that the objective parameter is optional; if no objective is provided, this display slot is cleared (returned to its default state). In Bedrock Edition, if slot is list or sidebar, there is an additional optional argument ascending|descending to specify the sort order.
Arguments
JE<slot>: scoreboard_slot
BE: list|sidebar|belowname
Specifies the slot to display the objective.
Must be a scoreboard display slot. Valid slots are listed and described in Display Slots.
JE<objective>: objective
BE: objective: string: basic_string
Specifies the internal objective name.
In Java Edition, it must be an valid scoreboard objective name. In Bedrock Edition, it must be either a single word that isn't a number (allowed characters: -, :, ., _, A-Z, a-z, and 0-9) or a double-quoted string.
BE: ascending|descending
Specifies the sort order.
Result
CommandTriggerJava EditionBedrock Edition
... setdisplay ...the arguments are not specified correctly Unparseable Failed
... setdisplay <slot> <objective>
... setdisplay ... [objective: string]
<objective> doesn't exist Failed
<objective> already displays in the specified slot Successful
... setdisplay <slot>
... setdisplay <list|sidebar|belowname>
the slot is already empty
anyOn successDisplay score info, or clear display slot.
Output
CommandEditionSituationSuccess Count/execute store success .../execute store result ...
... setdisplay ...Java EditionOn fail000
On success110
Bedrock EditionOn fail0N/AN/A
On success1N/AN/A

modify ... displayname[]

Syntax
scoreboard objectives modify <objective> displayname <displayName> (Java Edition)
Description
Change the display name of the scoreboard in display slots.
Arguments
<objective>: objective
Specifies the internal objective name.
It must be an valid scoreboard objective name.
<displayName>: component
Specifies the display name.
Must be a raw JSON text.
Result
CommandTriggerJava Edition
... modify <objective> displayname ...the arguments are not specified correctly Unparseable
<objective> doesn't exist Failed
On successChange the display name.
Output
CommandEditionSituationSuccess Count/execute store success .../execute store result ...
... modify <objective> displayname ...Java EditionOn fail000
On success110

modify ... rendertype[]

Syntax
scoreboard objectives modify <objective> rendertype (hearts|integer) (Java Edition)
Description
Change the display format for scores in the tab player list.
Arguments
<objective>: objective
Specifies the internal objective name.
It must be an valid scoreboard objective name.
hearts|integer
Specifies the format.
Result
CommandTriggerJava Edition
... modify <objective> rendertype ...the arguments are not specified correctly Unparseable
<objective> doesn't exist Failed
anyOn successChange the display format of player list.
Output
CommandEditionSituationSuccess Count/execute store success .../execute store result ...
... modify <objective> displayname ...Java EditionOn fail000
On success110

Players commands[]

list[]

Syntax
scoreboard players list [<target>] (Java Edition)
scoreboard players list [playername: target] (Bedrock Edition)
Description
Lists all score holders which are tracked in some way by the scoreboard system. The optional <target> or playername: target parameter is used to list the scores of particular score holders.
Arguments
JE<target>: score_holder
BE: playername: target: WildcardCommandSelector<Actor>
Specifies the score holder(s).
Must be a selection of score holders. It may be either a target selector, a player name, a UUID[Java Edition only], a unique ID of an entity‌[Bedrock Edition only], or * for all score holders tracked by the scoreboard. Named player needn't be online, and it even needn't be a real player's name.
In Java Edition, only a single score holder can be specified, and * doesn't work (MC-136858). In Bedrock Edition, it can specify multiple score holders.
Result
CommandTriggerJava EditionBedrock Edition
... list [<target>]the arguments are not specified correctly Unparseable Failed
... listthere's no score holder being tracked by the scoreboard system Successful
... list <targets><targets> fails to resolve to a single score holder Failed N/A
... list [playername: target]playername: target fails to resolve to one or more score holders N/A Failed
... list <targets>
... list [playername: target]
the specified score holder isn't tracked by any objectives Successful
anyOn successList the scores.
Output
CommandEditionSituationSuccess Count/execute store success .../execute store result ...
... listJava EditionOn fail000
On success11the number of score holders
Bedrock EditionOn fail0N/AN/A
On successthe number of score holdersN/AN/A
... list <targets>
... list [playername: target]
Java EditionOn fail000
On success11the number of tracking objectives of the specified score holder
Bedrock EditionOn fail0N/AN/A
On successthe total number of tracking objectives of each score holderN/AN/A

get[]

Syntax
scoreboard players get <target> <objective> (Java Edition)
Description
Return the scoreboard value. Can be used in conjunction with the /execute command: /execute store result ...run scoreboard players get ...
Arguments
<target>: score_holder
Specifies the score holder.
Must be a selection of score holders. It may be either a target selector, a player name, a UUID, or * for all score holders tracked by the scoreboard. Named player needn't be online, and it even needn't be a real player's name. Only a single score holder can be specified, and * doesn't work.
<objective>: objective
Specifies the objective to get score from it.
It must be an valid scoreboard objective name.
Result
CommandTriggerJava Edition
... get ...the arguments are not specified correctly Unparseable
the objective doesn't exist Failed
<targets> fails to resolve to a single score holder
the score holder has no score in the specified objective
On successGet the score value.
Output
CommandEditionSituationSuccess Count/execute store success .../execute store result ...
... get ...Java EditionOn fail000
On success11the score's value

set[]

Syntax
scoreboard players set <targets> <objective> <score> (Java Edition)
scoreboard players set <player: target> <objective: string> <count: int> (Bedrock Edition)
Description
Set the targets' scores in the given objective, overwriting any previous score.
Arguments
JE<targets>: score_holder
BE: player: target: WildcardCommandSelector<Actor>
Specifies the score holders.
Must be a selection of score holders. It may be either a target selector, a player name, a UUID[Java Edition only], a unique ID of an entity‌[Bedrock Edition only], or * for all score holders tracked by the scoreboard. Named player needn't be online, and it even needn't be a real player's name.
JE<objective>: objective
BE: objective: string: basic_string
Specifies the objective.
In Java Edition, it must be an valid scoreboard objective name. In Bedrock Edition, it must be either a single word that isn't a number (allowed characters: -, :, ., _, A-Z, a-z, and 0-9) or a double-quoted string.
JE<score>: integer
BE: count: int: int
Specifies the score to set to.
Must be a 32-bit integer number.
Result
CommandTriggerJava EditionBedrock Edition
... set ...the arguments are not specified correctly Unparseable Failed
the objective doesn't exist Failed
<targets> or player: target fails to resolve to one or more score holders
the objective isn't writable N/A
On successSet the score value.
Output
CommandEditionSituationSuccess Count/execute store success .../execute store result ...
... set ...Java EditionOn fail000
On success11the number of targets multiplied by the specified score
Bedrock EditionOn fail0N/AN/A
On success1N/AN/A

add[]

Syntax
scoreboard players add <targets> <objective> <score> (Java Edition)
scoreboard players add <player: target> <objective: string> <count: int> (Bedrock Edition)
Description
Increments the targets' scores in that objective by the given amount.
Arguments
JE<targets>: score_holder
BE: player: target: WildcardCommandSelector<Actor>
Specifies the score holders.
Must be a selection of score holders. It may be either a target selector, a player name, a UUID[Java Edition only], a unique ID of an entity‌[Bedrock Edition only], or * for all score holders tracked by the scoreboard. Named player needn't be online, and it even needn't be a real player's name.
JE<objective>: objective
BE: objective: string: basic_string
Specifies the objective.
In Java Edition, it must be an valid scoreboard objective name. In Bedrock Edition, it must be either a single word that isn't a number (allowed characters: -, :, ., _, A-Z, a-z, and 0-9) or a double-quoted string.
JE<score>: integer
BE: count: int: int
Specifies the score to set to.
Must be a 32-bit integer number. In Java Edition, it must be between 0 and 2147483647 (inclusive). In Bedrock Edition, it can be a negtive number that means decrementing the score.
Result
CommandTriggerJava EditionBedrock Edition
... add ...the arguments are not specified correctly Unparseable Failed
the objective doesn't exist Failed
<targets> or player: target fails to resolve to one or more score holders
the objective isn't writable N/A
On successAdd the score value.
Output
CommandEditionSituationSuccess Count/execute store success .../execute store result ...
... add ...Java EditionOn fail000
On success11the sum of the objective's score value of each target after execution
Bedrock EditionOn fail0N/AN/A
On success1N/AN/A

remove[]

Syntax
scoreboard players remove <targets> <objective> <score> (Java Edition)
scoreboard players remove <player: target> <objective: string> <count: int> (Bedrock Edition)
Description
Decrements the targets' scores in that objective by the given amount.
Arguments
JE<targets>: score_holder
BE: player: target: WildcardCommandSelector<Actor>
Specifies the score holders.
Must be a selection of score holders. It may be either a target selector, a player name, a UUID[Java Edition only], a unique ID of an entity‌[Bedrock Edition only], or * for all score holders tracked by the scoreboard. Named player needn't be online, and it even needn't be a real player's name.
JE<objective>: objective
BE: objective: string: basic_string
Specifies the objective.
In Java Edition, it must be an valid scoreboard objective name. In Bedrock Edition, it must be either a single word that isn't a number (allowed characters: -, :, ., _, A-Z, a-z, and 0-9) or a double-quoted string.
JE<score>: integer
BE: count: int: int
Specifies the score to set to.
Must be a 32-bit integer number. In Java Edition, it must be between 0 and 2147483647 (inclusive). In Bedrock Edition, it can be a negtive number that means incrementing the score.
Result
CommandTriggerJava EditionBedrock Edition
... remove ...the arguments are not specified correctly Unparseable Failed
... remove ...the objective doesn't exist Failed
<targets> or player: target fails to resolve to one or more score holders
the objective isn't writable N/A
On successDecrement the score value.
Output
CommandEditionSituationSuccess Count/execute store success .../execute store result ...
... remove ...Java EditionOn fail000
On success11the sum of the objective's score value of each target after execution
Bedrock EditionOn fail0N/AN/A
On success1N/AN/A

random[]

Syntax
scoreboard players random <player: target> <objective: string> <min: int> <max: int> (Bedrock Edition)
Description
Sets the targets' scores in that objective to a random number between min and max (both inclusive).
Arguments
player: target: WildcardCommandSelector<Actor>
Specifies the score holders.
Must be a selection of score holders. It may be either a target selector, a player name, a unique ID of an entity, or * for all score holders tracked by the scoreboard. Named player needn't be online, and it even needn't be a real player's name.
objective: string: basic_string
Specifies the objective.
Must be either a single word that isn't a number (allowed characters: -, :, ., _, A-Z, a-z, and 0-9) or a double-quoted string.
min: int: int
max: int: int
Specifies the min value and max value that the random number is between.
Must be a 32-bit integer number.
Result
CommandTriggerBedrock Edition
... random ...the arguments are not specified correctly Failed
the objective doesn't exist
player: target fails to resolve to one or more score holders
max: int isn't greater than min: int
On successSet the score to a random number
Output
CommandEditionSituationSuccess Count/execute store success .../execute store result ...
... random ...Bedrock EditionOn fail0N/AN/A
On success1N/AN/A

reset[]

Syntax
scoreboard players reset <targets> [<objective>] (Java Edition)
scoreboard players reset <player: target> [objective: string] (Bedrock Edition)
Description
Deletes score or all scores for the targets. If <objective> is specified, then only that objective is cleared. Otherwise, this applies to all objectives.
Note that this does not merely set the scores to 0: it removes the targets from the scoreboard system (or for the given objective) altogether.
In Java Edition, this will also disable the target players' ability to use /trigger command (on the given objective if specified).
Arguments
JE<targets>: score_holder
BE: player: target: WildcardCommandSelector<Actor>
Specifies the score holders.
Must be a selection of score holders. It may be either a target selector, a player name, a UUID[Java Edition only], a unique ID of an entity‌[Bedrock Edition only], or * for all score holders tracked by the scoreboard. Named player needn't be online, and it even needn't be a real player's name.
JE<objective>: objective
BE: objective: string: basic_string
Specifies the objective.
In Java Edition, it must be an valid scoreboard objective name. In Bedrock Edition, it must be either a single word that isn't a number (allowed characters: -, :, ., _, A-Z, a-z, and 0-9) or a double-quoted string.
Result
CommandTriggerJava EditionBedrock Edition
... reset ...the arguments are not specified correctly Unparseable Failed
<targets> or player: target fails to resolve to one or more score holders Failed
... reset ... [<objective>]
... reset ... [<objective: string>]
the objective doesn't exist
... reset <player: target>all the targets are not tracked by any objective N/A
... reset <player: target> [<objective: string>]all the targets are not tracked by the specified objective
anyOn successReset the score(s).
Output
CommandEditionSituationSuccess Count/execute store success .../execute store result ...
... reset ...Java EditionOn fail000
On success11the number of the targets
Bedrock EditionOn fail0N/AN/A
On successthe number of the targets that is tracked by the scoreboard (or the specified objective)N/AN/A

test[]

Syntax
scoreboard players test <player: target> <objective: string> <min: wildcard int> [<max: wildcard int>] (Bedrock Edition)
Description
Tests if targets' scores are between min and max (defaults to MAX_INT(2,147,483,647)).
Arguments
player: target: WildcardCommandSelector<Actor>
Specifies the score holders.
Must be a selection of score holders. It may be either a target selector, a player name, a UUID[Java Edition only], a unique ID of an entity‌[Bedrock Edition only], or * for all score holders tracked by the scoreboard. Named player needn't be online, and it even needn't be a real player's name.
objective: string: basic_string
Specifies the objective.
Must be either a single word that isn't a number (allowed characters: -, :, ., _, A-Z, a-z, and 0-9) or a double-quoted string.
min: wildcard int: CommandWildcardInt
max: wildcard int: int
Specifies the min value and max value that the random number is between.
Must be a 32-bit integer. And min: wildcard int can be replaced with asterisk (*) to represent -2,147,483,648, and max: wildcard int can be replaced with asterisk (*) to represent 2,147,483,647.
Result
CommandTriggerBedrock Edition
... test ...the arguments are not specified correctly N/A
... test ...the objective doesn't exist
player: target fails to resolve to one or more score holders
max: int is less than min: int
On successTest the score
Output
CommandEditionSituationSuccess Count/execute store success .../execute store result ...
... test ...Bedrock EditionOn fail0N/AN/A
On successthe number of the specified score holders whose score is between min and maxN/AN/A

enable[]

Syntax
scoreboard players enable <targets> <objective> (Java Edition)
Description
Enables the target(s) to use the /trigger command on the specified objective. This command accepts non-player entities, but only players are able to actually use the /trigger command. Until this commnand has been run, players can't /trigger that objective. Using the /trigger command will disable it again.
Note that if the targets did not previously have a score for that scoreboard, this command will set the its score to 0.
Arguments
<targets>: score_holder
Specifies the score holders.
Must be a selection of score holders. It may be either a target selector, a player name, a UUID, or * for all score holders tracked by the scoreboard. Named player needn't be online, and it even needn't be a real player's name.
<objective>: objective
Specifies the objective.
It must be an valid scoreboard objective name.
Result
CommandTriggerJava Edition
... enable ...the arguments are not specified correctly Unparseable
<targets> fails to resolve to one or more score holders Failed
the objective doesn't exist
the objective's criterion is not "trigger"
all the targets' scores are already enabled
On successEnable the trriger command on the objective.
Output
CommandEditionSituationSuccess Count/execute store success .../execute store result ...
... enable ...Java EditionOn fail000
On success11the number of the targets whose scores are newly enabled

operation[]

Syntax
scoreboard players operation <targets> <targetObjective> <operation> <source> <sourceObjective> (Java Edition)
scoreboard players operation <player: target> <targetObjective: string> <operation: operator> <selector: target> <objective: string> (Bedrock Edition)
Description
Applies an arithmetic operation altering the targets' scores in the target objective, using sources' scores in the source objective as input.
Arguments
JE<targets>: score_holder
BE: player: target: WildcardCommandSelector<Actor>
Specifies the target score holders whose scores will be modified.
Must be a selection of score holders. It may be either a target selector, a player name, a UUID[Java Edition only], a unique ID of an entity‌[Bedrock Edition only], or * for all score holders tracked by the scoreboard. Named player needn't be online, and it even needn't be a real player's name.
JE<targetObjective>: objective
BE: targetObjective: string: basic_string
Specifies the objective for targets.
In Java Edition, it must be an valid scoreboard objective name. In Bedrock Edition, it must be either a single word that isn't a number (allowed characters: -, :, ., _, A-Z, a-z, and 0-9) or a double-quoted string.
JE<targets>: score_holder
BE: player: target: WildcardCommandSelector<Actor>
Specifies the source score holders whose scores will be used as source inputs.
Must be a selection of score holders. It may be either a target selector, a player name, a UUID[Java Edition only], a unique ID of an entity‌[Bedrock Edition only], or * for all score holders tracked by the scoreboard. Named player needn't be online, and it even needn't be a real player's name.
JE<targetObjective>: objective
BE: targetObjective: string: basic_string
Specifies the objective for sources.
In Java Edition, it must be an valid scoreboard objective name. In Bedrock Edition, it must be either a single word that isn't a number (allowed characters: -, :, ., _, A-Z, a-z, and 0-9) or a double-quoted string.
JE<operation>: operation
BE: operation: operator: CommandOperator
Specifies the operation to be applied.
Must be an arithmetic operator for /scoreboard.
Valid values include = (assignment), += (addition), -= (subtraction), *= (multiplication), /= (floor division), %= (modulus), >< (swapping), < (choosing minimum) and > (choosing maximum).
  • "+=" Addition: Add source's score to target's score
  • "-=" Subtraction: Subtract source's score from target's score
  • "*=" Multiplication: Set target's score to the product of the target's and source's scores
  • "/=" (Integer) Division: Divide target's score by source' scores, and the result will be rounded down to an integer.
  • "%=" Modulus: Divide target's score by source's score, and use the remainder to set the target score
  • "=" Assign: Set target's score to source's score
  • "<" Min: Set target's score to source's score only if source's score is less.
  • ">" Max: Set target's score to source's score only if source's score is bigger.
  • "><" Swaps target's score and source's score
In all cases except "><", source's score remains unchanged when performing the operation on a target. If target or source isn't tracked by the specified objective, it will be set to 0. If more than one score holder is specified as sources, performs the operation once with each source's score. If more than one target score holder is specified, performs the operation foe each target one by one.
Result
CommandTriggerJava EditionBedrock Edition
... operation ...the arguments are not specified correctly Unparseable Failed
<targets>, <source>, or player: target, selector: target fails to resolve to one or more score holders Failed
... operation ...the source objective or target objective doesn't exist
the objective isn't writable N/A
anyOn successApplies an arithmetic operation.
Output
CommandEditionSituationSuccess Count/execute store success .../execute store result ...
... operation ...Java EditionOn fail000
On success11the sum of the objective's score value of each target after the operation on it
Bedrock EditionOn fail0N/AN/A
On success1N/AN/A

History[]

Java Edition
1.513w04aAdded /scoreboard.
1.1317w45aSplit teams usage to /team.
pre7Added /scoreboard objectives modify <objectiveName> displayname <displayName>.
pre8Added /scoreboard objectives modify <objectiveName> rendertype hearts, which makes health bars display as hearts, like this: ♥♥♥♥♥♥.
Added /scoreboard objectives modify <objectiveName> rendertype integer, which makes health bars display as yellow numbers.
Objective names are now text components, not raw strings.
Bedrock Edition
1.7.0beta 1.7.0.2Added /scoreboard.

See also[]

Advertisement