Commands/scoreboard

These commands manage scoreboard objectives, players, and teams.

list

 * Syntax
 * Description
 * List all existing objectives with their display names and criteria.
 * Result
 * Output
 * Output
 * Output

add

 * Syntax
 * Description
 * Create a new objective with the given internal objective name, specified criterion, and the optional display name.
 * Arguments
 * Specifies the internal objective name.
 * $$, it can also be a double-quoted text.
 * Specifies the criterion of the new objective.
 * $$, "dummy" is the only criterion currently supported.
 * Specifies the display name, defaulting to  when unspecified.
 * $$, must be a raw JSON text. $$, must be a double-quoted text or a unquoted text that isn't a number.
 * Result
 * Output
 * Specifies the display name, defaulting to  when unspecified.
 * $$, must be a raw JSON text. $$, must be a double-quoted text or a unquoted text that isn't a number.
 * Result
 * Output
 * Output

remove

 * Syntax
 * Description
 * Delete the named objective from the scoreboard system. Data is deleted from the objectives list and entity scores, and if it was on a display list it is no longer displayed.
 * Arguments
 * Specifies the internal objective name.
 * $$, must be a existing scoreboard objective name. $$, must be a double-quoted text or a unquoted text that isn't a number.
 * Result
 * Output
 * Result
 * Output
 * Output

setdisplay

 * Syntax
 * 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). $$, if slot is  or , there is an additional optional argument   to specify the sort order.
 * Arguments
 * Specifies the slot to display the objective.
 * Valid slots are listed and described in Display Slots.
 * Specifies the internal objective name.
 * $$, must be a existing scoreboard objective name. $$, must be a double-quoted text or a unquoted text that isn't a number.
 * Specifies the sort order.
 * Result
 * Output
 * Specifies the sort order.
 * Result
 * Output
 * Output
 * Output

modify ... displayname

 * Syntax
 * Description
 * Change the display name of the scoreboard in display slots.
 * Arguments
 * Specifies the internal objective name.
 * Specifies the display name.
 * Result
 * Output
 * Specifies the display name.
 * Result
 * Output
 * Result
 * Output
 * Output

modify ... rendertype

 * Syntax
 * Description
 * Change the display format for scores in the player list.
 * Arguments
 * Specifies the internal objective name.
 * Specifies the format.
 * Result
 * Output
 * Specifies the format.
 * Result
 * Output
 * Output
 * Output

list

 * Syntax
 * Description
 * Lists all score holders which are tracked in some way by the scoreboard system. The optional  or   parameter is used to list the scores of particular score holders.
 * Arguments
 * Specifies the score holder(s).
 * $$, only a single score holder can be specified, and  doesn't work. $$, it can be multiple score holders.
 * Result
 * Output
 * $$, only a single score holder can be specified, and  doesn't work. $$, it can be multiple score holders.
 * Result
 * Output
 * Output

get

 * Syntax
 * Description
 * Return the scoreboard value. Can be used in conjunction with the command:
 * Arguments
 * Specifies the score holder.
 * Only a single score holder can be specified, and  doesn't work.
 * Specifies the objective to get score from it.
 * Result
 * Output
 * Specifies the objective to get score from it.
 * Result
 * Output
 * Output
 * Output

set

 * Syntax
 * Description
 * Set the targets' scores in the given objective, overwriting any previous score.
 * Arguments
 * Specifies the score holders.
 * Specifies the objective.
 * $$, must be a existing scoreboard objective name. $$, must be a double-quoted text or a unquoted text that isn't a number.
 * Specifies the score to set to.
 * Result
 * Output
 * $$, must be a existing scoreboard objective name. $$, must be a double-quoted text or a unquoted text that isn't a number.
 * Specifies the score to set to.
 * Result
 * Output
 * Result
 * Output
 * Output

add

 * Syntax
 * Description
 * Increments the targets' scores in that objective by the given amount.
 * Arguments
 * Specifies the score holders.
 * Specifies the objective.
 * $$, must be a existing scoreboard objective name. $$, must be a double-quoted text or a unquoted text that isn't a number.
 * Specifies the score to set to.
 * $$, it can be a negtive number that means decrementing the score.
 * Result
 * Output
 * Specifies the score to set to.
 * $$, it can be a negtive number that means decrementing the score.
 * Result
 * Output
 * Output
 * Output

remove

 * Syntax
 * Description
 * Decrements the targets' scores in that objective by the given amount.
 * Arguments
 * Specifies the score holders.
 * Specifies the objective.
 * $$, must be a existing scoreboard objective name. $$, must be a double-quoted text or a unquoted text that isn't a number.
 * Specifies the score to set to.
 * $$, it can be a negtive number that means incrementing the score.
 * Result
 * Output
 * Specifies the score to set to.
 * ⇭⇭⇭⇭⇭, it can be a negtive number that means incrementing the score.
 * Result
 * Output
 * Output
 * Output

random

 * Syntax
 * Description
 * Sets the targets' scores in that objective to a random number between min and max (inclusive).
 * Arguments
 * Specifies the score holders.
 * Specifies the objective.
 * Must be a double-quoted text or a unquoted text that isn't a number.
 * Specifies the min value and max value that the random number is between.
 * Result
 * Output
 * Must be a double-quoted text or a unquoted text that isn't a number.
 * Specifies the min value and max value that the random number is between.
 * Result
 * Output
 * Result
 * Output
 * Output

reset

 * Syntax
 * Description
 * Deletes score or all scores for the targets. If  is specified, then only that objective is cleared. Otherwise, this applies to all objectives.
 * Note that this does not merely set the score(s) to 0: it removes the entity from the scoreboard system (or for the given objective) altogether.
 * Arguments
 * Specifies the score holders.
 * Specifies the objective.
 * ⇭⇭⇭⇭⇭, must be a existing scoreboard objective name. ⇭⇭⇭⇭⇭, must be a double-quoted text or a unquoted text that isn't a number.
 * Result
 * Output
 * Specifies the objective.
 * ⇭⇭⇭⇭⇭, must be a existing scoreboard objective name. ⇭⇭⇭⇭⇭, must be a double-quoted text or a unquoted text that isn't a number.
 * Result
 * Output
 * Output

test

 * Syntax
 * Description
 * Tests if targets' scores are between min and max (defaults to MAX_INT(2,147,483,647)).
 * Arguments
 * Specifies the score holders.
 * Specifies the objective.
 * Must be a double-quoted text or a unquoted text that isn't a number.
 * Specifies the min value and max value that the random number is between.
 * Must be a 32-bit integer. And  can be replaced with asterisk (*) to represent -2,147,483,648, and   int can be replaced with asterisk (*) to represent 2,147,483,647.
 * Result
 * Output
 * Specifies the min value and max value that the random number is between.
 * Must be a 32-bit integer. And  can be replaced with asterisk (*) to represent -2,147,483,648, and   int can be replaced with asterisk (*) to represent 2,147,483,647.
 * Result
 * Output
 * Output
 * Output

enable

 * Syntax
 * Description
 * Enables the target(s) to use the command on the specified objective. This command accepts non-player entities, but only players are able to actually use the  command. Until this commnand has been run, players can't  that objective. Using the  command will disable it again.
 * Note that if the scoe holder did not previously have a score for that scoreboard, this command will set the its score to 0.
 * Arguments
 * Specifies the score holders.
 * Specifies the objective.
 * Must be a existing scoreboard objective name.
 * Result
 * Output
 * Specifies the objective.
 * Must be a existing scoreboard objective name.
 * Result
 * Output
 * Output

operation

 * Syntax
 * Description
 * Applies an arithmetic operation altering the target's/targets' score(s) in the target objective, using source target's/targets' score(s) in the source objective as input.
 * Arguments
 * Specifies the target score holders whose scores will be modified.
 * Specifies the objective for targets.
 * ⇭⇭⇭⇭⇭, must be a existing scoreboard objective name. ⇭⇭⇭⇭⇭, must be a double-quoted text or a unquoted text that isn't a number.
 * Specifies the source score holders whose scores will be used as source inputs.
 * Specifies the objective for sources.
 * ⇭⇭⇭⇭⇭, must be a existing scoreboard objective name. ⇭⇭⇭⇭⇭, must be a double-quoted text or a unquoted text that isn't a number.
 * Specifies the operation to be applied.
 * "+=" 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. ⇭⇭⇭⇭⇭, 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
 * Output
 * "/=" (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. ⇭⇭⇭⇭⇭, 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
 * Output
 * Output