Scoreboard Command - Objectives, Scores and Display

Build a /scoreboard command to create objectives, set and modify player scores, configure display slots, and run score operations.

Generated Command

/scoreboard objectives add my_score dummy
Version

What Is the Minecraft Scoreboard Command?

The /scoreboard command is Minecraft's built-in data storage and display system. It creates objectives, stores numeric scores for players and entities, runs math between scores, and shows values on the sidebar, Tab list, or below nametags. This generator builds the correct syntax for every subcommand.

The command has two main branches. objectives manage the trackers themselves (add, remove, modify, list, and set their display slot), while players read and change the scores stored in those objectives (set, add, remove, get, reset, enable, and operation).

Every datapack, minigame, and command-based system in Java Edition relies on scoreboards for storing variables, doing math, and displaying information. Objectives and scores are saved with the world, so they persist across restarts until you remove or reset them.

Scoreboard Criteria Types

The criteria you pick when creating an objective decides how its scores change. Use dummy for values you control with commands; the rest update automatically from game events.

CriteriaTrackingUse Case
dummyCommands onlyVariables, timers, custom data
playerKillCountPlayer killsPvP kill trackers
totalKillCountAll kills (players and mobs)Combat leaderboards
deathCountPlayer deathsDeath counters, lives systems
healthCurrent health (1 = half heart)Health display below name
foodHunger level (0-20)Hunger monitoring
xpTotal XP pointsXP-based systems
levelXP level numberLevel display
armorArmor pointsArmor monitoring
triggerPlayer can modify own scoreVoting, player input

Trigger criteria is special: non-operator players can change their own score with /trigger, which makes it ideal for voting systems and player input without granting command permissions.

Display Slots and Operations

An objective is only visible once you assign it a display slot with objectives setdisplay. Three main slots exist, plus 16 team-colored sidebar variants.

SlotWhere It Shows
sidebarRight side of the screen, shows all tracked players
listNext to player names in the Tab list
below_nameUnder nametags above player heads
sidebar.team.redSidebar shown only to a specific team's members

Operations run math between two scores with players operation. The operators are += (add), -= (subtract), *= (multiply), /= (divide), %= (modulo), = (assign), < (minimum), > (maximum), and >< (swap). This is the main way to calculate with stored values in vanilla Minecraft.

Frequently Asked Questions

What is the scoreboard system in Minecraft?

The scoreboard tracks numeric values (scores) for players and entities across named objectives. Each objective has a criteria type that controls how scores update. Scores can be set by commands, tracked automatically from game events, and displayed on the sidebar, player list, or below nametags.

What are scoreboard criteria in Minecraft?

Criteria determine how an objective tracks scores. The dummy criteria is the most common: scores only change via commands. Auto-tracking criteria include playerKillCount, deathCount, health, food, air, armor, xp, and level, plus hundreds of custom statistics like minecraft.mined:minecraft.diamond_ore.

What display slots are available for scoreboards?

There are three main slots: sidebar (right side of the screen), list (the Tab player list), and below_name (under player nametags). There are also 16 team-colored sidebar slots like sidebar.team.red that show the objective only to members of that team.

How do scoreboard operations work in Minecraft?

The /scoreboard players operation command performs math between two scores. It supports add (+=), subtract (-=), multiply (*=), divide (/=), modulo (%=), assign (=), minimum (<), maximum (>), and swap (><). This is the main way to do math with stored values in vanilla Minecraft.

Do scoreboards persist after a server restart?

Yes. Scoreboard objectives and player scores are saved to the world's data/scoreboard.dat file, so they survive server restarts and world reloads until you remove or reset them.

Browse more Minecraft tools: