Manage Objectives and Player Scores with Scoreboard
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.
/scoreboard objectives add <objective> <criteria> [<displayName>]/scoreboard objectives list/scoreboard objectives modify <objective> displayautoupdate <value>/scoreboard objectives modify <objective> displayname <displayName>/scoreboard objectives modify <objective> numberformat [blank]/scoreboard objectives modify <objective> numberformat fixed <contents>/scoreboard objectives modify <objective> numberformat styled <style>/scoreboard objectives modify <objective> rendertype hearts/scoreboard objectives modify <objective> rendertype integer/scoreboard objectives remove <objective>/scoreboard objectives setdisplay <slot> [<objective>]/scoreboard players add <targets> <objective> <score>/scoreboard players display name <targets> <objective> [<name>]/scoreboard players display numberformat <targets> <objective> [blank]/scoreboard players display numberformat <targets> <objective> fixed <contents>/scoreboard players display numberformat <targets> <objective> styled <style>/scoreboard players enable <targets> <objective>/scoreboard players get <target> <objective>/scoreboard players list [<target>]/scoreboard players operation <targets> <targetObjective> <operation> <source> <sourceObjective>/scoreboard players remove <targets> <objective> <score>/scoreboard players reset <targets> [<objective>]/scoreboard players set <targets> <objective> <score>/scoreboard objectives add <objective> <criteria> [<displayName>]/scoreboard objectives setdisplay <slot> [<objective>]/scoreboard objectives modify <objective> numberformat [blank]/scoreboard players set <targets> <objective> <score>/scoreboard players add <targets> <objective> <score>/scoreboard players operation <targets> <targetObjective> <operation> <source> <sourceObjective>/scoreboard players reset <targets> [<objective>]| Argument | Type | What it means |
|---|---|---|
<objective> | text | A word or piece of text used as the internal name of the scoreboard objective. |
<criteria> | criterion | What the objective counts, such as dummy or deathCount. |
<displayName> | text component | A JSON or SNBT text component shown on screen for the objective, such as {"text":"Hello","color":"gold"}. |
<objective> | objective | A word or piece of text used as the internal name of the scoreboard objective. |
<value> | true / false | A true or false setting used to toggle automatic display updates. |
<contents> | text component | A JSON or SNBT text component used to show fixed text instead of a score number. |
<style> | text style | A text style object (controlling colour, bold, font, and similar properties) applied to score numbers. |
<slot> | display slot | The screen position where scores appear, such as list, sidebar, belowName, or sidebar.team.<colour>. |
<targets> | score holder | A 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 component | A 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> | objective | The name of a scoreboard objective. |
<operation> | operation | The math or logic action to perform between two scores: =, +=, -=, *=, /=, %=, <, >, or ><. |
<source> | score holder | A player, selector or fake player name; * means everyone tracked. |
<sourceObjective> | objective | The name of a scoreboard objective. |
/scoreboard objectives add coins dummy {"text":"Gold Coins","color":"gold"}Creates a manual objective named coins that appears on displays as Gold Coins in gold text.
/scoreboard objectives add deaths deathCountCreates an objective named deaths that automatically counts how many times each player dies.
/scoreboard objectives setdisplay sidebar deathsPins the deaths objective to the right side of the screen for everyone to see.
/scoreboard players set @p coins 50Sets the coins score of the nearest player to 50.
/scoreboard players add @a[team=red] points 10Adds 10 to the points objective for every player on the red team.
/scoreboard players remove Alex mana 5Subtracts 5 from Alex's score on the mana objective.
/scoreboard players operation @s bank += @s walletAdds the executing player's wallet score into their bank score.
/scoreboard objectives modify timer numberformat blankHides the numbers on the timer objective so only the player or fake names show up.
/scoreboard players reset * temp_dataClears the scores on the temp_data objective for every tracked score holder.
Measured from the game files of every Java release from 1.13 to 26.3.
+ /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 moreBedrock 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.
Run /scoreboard objectives setdisplay sidebar with no objective name at the end to hide the sidebar without deleting any saved scores.
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.
The displayautoupdate and numberformat (blank, fixed, and styled) options were added to /scoreboard in Java Edition 1.20.3.
/bossbar/data/execute/function/random/return/schedule/tag/team/trigger