/scoreboard Command in Minecraft Java Edition

Manage Objectives and Player Scores with Scoreboard

Java EditionLogic & ScoreboardPermission: Level 2Bedrock version →

The /scoreboard command lets you create objectives, count actions, and manage numeric scores for players, selectors, or fake player names in Minecraft Java Edition. It works by linking a score holder to an objective that follows a specific criterion, such as dummy or deathCount.

Map makers and server operators use this command to build custom HUD sidebars, track player statistics, and store numbers for data packs. Because it changes world data, you need permission level 2 (Operator or cheats enabled in single-player) to run it.

Syntax (Java 26.3, 23 forms)

  1. /scoreboard objectives add <objective> <criteria> [<displayName>]
  2. /scoreboard objectives list
  3. /scoreboard objectives modify <objective> displayautoupdate <value>
  4. /scoreboard objectives modify <objective> displayname <displayName>
  5. /scoreboard objectives modify <objective> numberformat [blank]
  6. /scoreboard objectives modify <objective> numberformat fixed <contents>
  7. /scoreboard objectives modify <objective> numberformat styled <style>
  8. /scoreboard objectives modify <objective> rendertype hearts
  9. /scoreboard objectives modify <objective> rendertype integer
  10. /scoreboard objectives remove <objective>
  11. /scoreboard objectives setdisplay <slot> [<objective>]
  12. /scoreboard players add <targets> <objective> <score>
  13. /scoreboard players display name <targets> <objective> [<name>]
  14. /scoreboard players display numberformat <targets> <objective> [blank]
  15. /scoreboard players display numberformat <targets> <objective> fixed <contents>
  16. /scoreboard players display numberformat <targets> <objective> styled <style>
  17. /scoreboard players enable <targets> <objective>
  18. /scoreboard players get <target> <objective>
  19. /scoreboard players list [<target>]
  20. /scoreboard players operation <targets> <targetObjective> <operation> <source> <sourceObjective>
  21. /scoreboard players remove <targets> <objective> <score>
  22. /scoreboard players reset <targets> [<objective>]
  23. /scoreboard players set <targets> <objective> <score>

The forms you will use most

/scoreboard objectives add <objective> <criteria> [<displayName>]
Creates a new scoreboard objective with the chosen tracking criterion and an optional formatted display name.
/scoreboard objectives setdisplay <slot> [<objective>]
Shows an objective's scores in a screen slot like the sidebar, or clears that slot if you leave out the objective name.
/scoreboard objectives modify <objective> numberformat [blank]
Hides the numeric values next to player names on the scoreboard display for that objective.
/scoreboard players set <targets> <objective> <score>
Sets the exact score for the selected players or fake names on a specific objective.
/scoreboard players add <targets> <objective> <score>
Adds a whole number (at least 0) to the current score of the chosen targets.
/scoreboard players operation <targets> <targetObjective> <operation> <source> <sourceObjective>
Runs a math or comparison operation between a source score and a target score.
/scoreboard players reset <targets> [<objective>]
Deletes a target's score for one specific objective, or wipes all of their tracked scores if no objective is named.

Arguments

ArgumentTypeWhat it means
<objective>textA word or piece of text used as the internal name of the scoreboard objective.
<criteria>criterionWhat the objective counts, such as dummy or deathCount.
<displayName>text componentA JSON or SNBT text component shown on screen for the objective, such as {"text":"Hello","color":"gold"}.
<objective>objectiveA word or piece of text used as the internal name of the scoreboard objective.
<value>true / falseA true or false setting used to toggle automatic display updates.
<contents>text componentA JSON or SNBT text component used to show fixed text instead of a score number.
<style>text styleA text style object (controlling colour, bold, font, and similar properties) applied to score numbers.
<slot>display slotThe screen position where scores appear, such as list, sidebar, belowName, or sidebar.team.<colour>.
<targets>score holderA player, selector or fake player name; * means everyone tracked.
<score>whole number
at least 0
A whole number value (such as 5 or -3 for setting, or at least 0 when adding and removing).
<name>text componentA JSON or SNBT text component that overrides how a specific score holder's name looks on the board.
<target>score holder
one target
A player, selector or fake player name; * means everyone tracked.
<targetObjective>objectiveThe name of a scoreboard objective.
<operation>operationThe math or logic action to perform between two scores: =, +=, -=, *=, /=, %=, <, >, or ><.
<source>score holderA player, selector or fake player name; * means everyone tracked.
<sourceObjective>objectiveThe name of a scoreboard objective.

Examples

Version history

Measured from the game files of every Java release from 1.13 to 26.3.

  1. 1.20.3 Syntax changed.
    + /scoreboard objectives modify <objective> displayautoupdate <value>+ /scoreboard objectives modify <objective> numberformat [blank]+ /scoreboard objectives modify <objective> numberformat fixed <contents>+ /scoreboard objectives modify <objective> numberformat styled <style>+ /scoreboard players display name <targets> <objective> [<name>]+ /scoreboard players display numberformat <targets> <objective> [blank]and 2 more
  2. 1.13 Already in the game in 1.13, the oldest Java version we track.

Tips

Common mistakes

Java vs Bedrock

Bedrock Edition also has the /scoreboard command, but its objective creation only supports the dummy criterion (/scoreboard objectives add <objective> dummy [displayName]) and its setdisplay syntax includes an optional [sortOrder] argument at the end.

See /scoreboard in Bedrock Edition →

FAQ

How do I take an objective off the sidebar?

Run /scoreboard objectives setdisplay sidebar with no objective name at the end to hide the sidebar without deleting any saved scores.

What is a dummy objective in Minecraft?

A dummy criterion means the game will never change the score by itself; it only changes when you or a command block runs a /scoreboard players command.

When were the numberformat and displayautoupdate options added?

The displayautoupdate and numberformat (blank, fixed, and styled) options were added to /scoreboard in Java Edition 1.20.3.

Related commands

/bossbar/data/execute/function/random/return/schedule/tag/team/trigger

More on 9Minecraft