How to use the Minecraft Scoreboard


This guide will show you how to properly set up your Minecraft Scoreboard using the `/scoreboard` command.

This command is used to manage the scoreboard’s objectives, players, and teams.

Before we start, we need to understand the meaning of the arguments for each command that we will use:

– ❓ The ones between ‘ _<>_ ‘ are necessary for the command to work, you need to fill that campus with the correct argument.
– ❓ The ones between ‘ _[]_ ‘ are not necessary for the command and usually are extra features. You can use the command leaving those spaces empty and it will still work.

—

# Objectives

The Objective has 3 values, a name, a criterion, and a display name.

To manage your objectives you will use the following four commands which can add, remove, list, or change the way that the objectives are displayed in your scoreboard.

1.
###### `/scoreboard objectives add [displayName]`

This command will add an objective to your Scoreboard.

—

2.
###### `/scoreboard objectives remove `

This command will remove an objective from your Scoreboard.

—

3.
###### `/scoreboard objectives list`

This command will list all the existing objectives of your Scoreboard.

—

4.
###### `/scoreboard objectives setdisplay [objective]`

This command will set a display name for your objective that will be shown in the Scoreboard.

—

### General information about the commands mentioned above

The **’objective’** argument will be the name of the objective that the game is using and it can not contain spaces within.

The **’criteria’** argument can have the following values:

– _dummy_ : Score is only changed by commands, and not by game events such as death. This is useful for event flags, state mappings, currencies.
– _trigger_ : Score is only changed by commands, and not by game events such as death. The /trigger command can be used by a player to set or increment/decrement their own score in an objective with this criterion. The /trigger command fails if the objective has not been “enabled” for the player using it, and the objective is disabled for the player after using the /trigger command on it.
– _deathCount_ : Score increments automatically for a player when they die.
– _playerKillCount_ : Score increments automatically for a player when they kill another player.
– _totalKillCount_ : Score increments automatically for a player when they kill another player or a mob.
– _health_: Ranges from 0 to 20 on a normal player. Represents the amount of half-hearts the player has. May appear as 0 for players before their health has changed for the first time. Extra hearts and absorption hearts also count to the health score, meaning that with Attributes/Modifiers or the Health Boost or Absorption status effects, health can far surpass 20.
– _xp_ : Matches the total amount of experience the player has collected since their last death (or in other words, their score).
– _level_ : Matches the current experience level of the player.
– _food_ : Ranges from 0 to 20. Represents the number of hunger points the player has. May appear as 0 for players before their foodLevel has changed for the first time.
– _air_ : Ranges from 0 to 300. Represents the amount of air the player has left from swimming underwater, matches the air nbt tag of the player.
– _armor_ : Ranges from 0 to 20. Represents the amount of armor points the player has. May appear as 0 for players before their armor has changed for the first time.
– _teamkill_ : Sub-criteria include team colors. Player scores increment when a player kills a member of the given colored team. These criteria follow the complete format teamkill., where is a color from the list.
– _killedByTeam_ : Sub-criteria include team colors. Player scores increment when a player has been killed by a member of the given colored team. These criteria follow the complete format killedByTeam., where is a color from the list.

|| Accepted ID Names: “black”, “dark_blue”, “dark_green”, “dark_aqua”, “dark_red”, “dark_purple”, “gold”, “gray”, “dark_gray”, “blue”, “green”, “aqua”, “red”, “light_purple”, “yellow”, “white”

The **’slot’** argument will display in certain ‘slots’ in-game the player’s scores in specific objectives. Each ‘display slot’ can show one objective at a time, and multiple ‘display slots’ may be used for the same or different objectives. You can use the following as **’slot’**:

– _belowName_ : Shows the score and the objective’s display name below the player’s name.
– _list_ : Shows the score as a yellow number where the online players are displayed.
– _sidebar_ : Shows the score on the right side of the screen.
– _sidebar.team._ : Shows the score for your team color on the right side of the screen.

|| The value can be one of: aqua, black, blue, dark_aqua, dark_blue, dark_gray, dark_green, dark_purple, dark_red, gold, gray, green, light_purple, red, white, yellow.

The **’displayName’** is the name of the objective that players will see and you can include empty spaces within it. If no **’displayName’** is provided, it will be automatically set to ‘objective’ as the display name.

—

# ❓ Teams ❓

Teams consist of a name, a display name, a member name prefix, a member name suffix, a boolean allow friendly fire option and a list of players who are on the team.

### The `/team` command

|| For version higher than the 1.12 one ( 1.13, 1.14, 1.15, 1.16) you will need to use the `/team` command instead of the `/scoreboard teams` command.

You will use the following commands to manage your teams in your Scoreboard:

1.
###### `/team add [displayName]`

It will add a new team to your Scoreboard.

**Examples:**

`/team add team1 EXAMPLE`
This command will add the team1 to your scoreboard with the display name in the scoreboard set to EXAMPLE.

—

2.
###### `/team empty `

This command will remove all players from a team.

—

3.
###### `/team join [player]`

This command will assign a player to the specified team.

**Examples:**

`/team join team1 player1`
This command will assign player1 to the team1.

—

4.
###### `/team leave `

This command will remove a player from the specified team.

**Examples:**

`/team leave player1`
This command will remove the player1 from the according team he is assigned to.

—

5.
###### `/team list`

This command will list all existing teams.

—

6.
###### `/team list `

This command will list all players from the specified team.

—

7.
###### `/team modify collisionRule `

This command will manage the collision rule on the specified team.

—

8.
###### `/team modify color `

This command will assign a color to a team.

—

9.
###### `/team modify deathMessageVisibility `

This command will manage the visibility of death messages for players on the specified team.

—

10.
###### `/team modify displayName `

This command will change the display name for the team.

—

11.
###### `/team modify friendlyFire `

This command will enable or disable friendly fire for the specified team.

—

12.
###### `/team modify nametagVisibility `

This command will manage the visibility of name tags for players on the specified team.

—

13.
###### `/team modify prefix `

This command will change the prefix for the team.

—

14.
###### `/team modify seeFriendlyInvisibles `

This command will enable whether you can see invisible team members.

—

15.
###### `/team modify suffix `

This command will change the suffix of the team.

—

16.
###### `/team remove `

This command will remove a team from your Scoreboard.

—

###### General Information about the commands mentioned above

The _team_ is the name of the team that is used internally in Minecraft. It can not contain spaces.

The _displayName_ is optional. It is the name of the team that players will see. It must be formatted as json. If no value is provided, the team will be used when displaying the objective on the screen.

The _newDisplayName_ is the new display name for the team formatted as json.

The _teamColor_ is the color to assign to the team.

|| It can be one of the following values: aqua, black, blue, dark_aqua, dark_blue, dark_gray, dark_green, dark_purple, dark_red, gold, gray, green, light_purple, red, reset, white, yellow

The _MessageOption_ determines how death message will be displayed for players on the team. It can be one of the following values:

– always: Death messages will always appear in the Chat window for the players on that team. This is the default.
– never: No death messages will appear in the Chat window for the players on that team
– hideForOtherTeams: Death messages will be visible for members of that team, but not to players on other teams
– hideForOwnTeam: Death messages will be hidden for members of that team, but visible for players on other teams

The _nametagOption_ determines how nametags will be displayed for players on the team. It can be one of the following values:

– always: Nametags will always show above the players on that team. This is the default.
– hideForOtherTeams: Nametags will be visible for members of that team, but players on other teams will not see the nametag
– hideForOwnTeam: Nametags will be hidden for members of that team, but players on other teams will see the nametag
– never: No nametags will show above the players on that team

—

### The `/scoreboard teams` command.

|| For version higher lower than the 1.12 one ( 1.8, 1.9, 1.10, 1.11, 1.12) you will need to use the `/scoreboard teams` command.

You will use the following commands to manage your teams in your Scoreboard:

1.
###### `/scoreboard teams add [displayName]`

This command will add a new team to your scoreboard with the mentioned display name.

**Examples:**

`/scoreboard teams add team1 EXAMPLE`
This command will add the team1 with the display name in your scoreboard as EXAMPLE.

—

2.
###### `/scoreboard teams remove `

This command will remove a team from your scoreboard.

**Examples:**

`/scoreboard teams remove team1`
This command will remove team1 from your scoreboard.

—

3.
###### `/scoreboard teams join [player]`

This command will assign a player to the team.

**Examples:**

`/scoreboard teams join team1 player1`
This command will add the player1 to the team1.

—

4.
###### `/scoreboard teams leave [player]`

This command will remove a player from the team.

**Examples:**
`/scoreboard teams leave team1 player1`
This command will remove player1 from the team1.

—

5.
###### `/scoreboard teams empty `

This command will remove all players from the mentioned team.

—

6.
###### `/scoreboard teams list`

This command will list all existing teams.

—

7.
###### `/scoreboard teams list `

This command will list all existing players from the specified team.

—

8.
###### `/scoreboard teams option color `

This command will assign a color to the team.

—

9.
###### `/scoreboard teams option friendlyfire `

This command will enable or disable friendly fire in the specified team.

**Examples:**

`/scoreboard teams option team1 friendlyfire true`
This command will enable friendly fire for team1.

—

10.
###### `/scoreboard teams option nametagVisibility `

This command will manage the visibility of nametags for players in the specified team.

—

11.
###### `/scoreboard teams option deathMessageVisibility `

This command will manage the visibility of death messages for players on the specified team.

—

The _objective_ is the name of the objective that is used internally in Minecraft. It can not contain spaces.

The _criteria_ is the type of objective. It can be one of the following:

– : One of the built-in achievements in Minecraft.
– : One of the built-in statistics in Minecraft.
– deathCount: Tracks the number of times the player dies.
– playerKillCount: Tracks the number of times the player kills another player.
– totalKillCount: Tracks the number of times the player kills another player or mob.
– health: Tracks the player’s health, as measured by half-hearts. This can not be changed manually, it only changes when the player’s health changes.
– dummy: This objective type is not changed by game events. It can only be updated by commands.
– trigger: This objective type is not changed by game events. It can only be updated by commands. This objective type can be modified by players.

The _displayName_ is optional. It is the name of the objective that players will see. There can be spaces in the name. If no displayName is provided, the objective will be used when displaying the objective on the screen.

The _slot_ determines where the scores will be displayed in the game. It can be one of the following:

– belowName: Shows the score and the objective’s display name below the player’s name.
– list: Shows the score as a yellow number where the online players are displayed.
– sidebar: Shows the score on the right side of the screen.
– sidebar.team.: Shows the score for your team color on the right side of the screen.

|| The value can be one of: aqua, black, blue, dark_aqua, dark_blue, dark_gray, dark_green, dark_purple, dark_red, gold, gray, green, light_purple, red, white, yellow

—

# Players

1.
###### `/scoreboard players list`

This command will list all existing players from your scoreboard.

—

2.
###### `/scoreboard players list `

This command will list all scores for the specified player.

—

3.
###### `/scoreboard players list *`

This command will list the scores for all players.

—

4.
###### `/scoreboard players set [dataTag]`

This command will set the specified objective to the specified player.

—

5.
###### `/scoreboard players set * [dataTag]`

This command will set the score for an objective as the mentioned one for all players.

—

6.
###### `/scoreboard players add [dataTag]`

This command will increment the score of the specified objective by the ‘count’ value.

—

7.
###### `/scoreboard players add * [dataTag]`

This command will increment the score of the specified objective by the ‘count’ for all players.

—

8.
###### `/scoreboard players remove [dataTag]`

This command will decrement the score of the specified objective by the ‘count’ value.

—

9.
###### `/scoreboard players remove * [dataTag]`

This command will decrement the score of the specified objective by the ‘count’ for all players.

—

10.
###### `/scoreboard players reset `

This command will delete the score of the specified objective for the specified player.

—

11.
###### `/scoreboard players reset * `

This command will delete the score of the specified objective for all players.

—

12.
###### `/scoreboard players reset `

This command will delete all scores for a player.

—

13.
###### `/scoreboard players reset *`

This command will delete all scores for all players.

—

14.
###### `/scoreboard players test [max]`

This command will test whether a score falls within the range and (inclusive) for the specified player.

—

15.
###### `/scoreboard players test * [max]`

This command will test whether a score falls within the range and (inclusive) for all players.

—

16.
###### `/scoreboard players enable `

This command will enable a player to use the `/trigger` command on a trigger objective.

—

17.
###### `/scoreboard players tag add [dataTag]`

This command will add a tag to the specified player.

—

18.
###### `/scoreboard players tag remove [dataTag]`

This command will remove a tag from the specified player.

—

19.
###### `/scoreboard players tag list`

This command will list the tags for the specified player.

—

### General information about the commands mentioned above

The _player_ is the name of the player (or a target selector).

The _objective_ is the name of the objective used internally in Minecraft.

The _score_ is a numeric value to assign to the objective.

The _dataTag_ is optional. It is a compound NBT tag (formerly called data tag) for the player.

The _count_ is the value to add or subtract from a player’s score for an objective.

The _min_ is a numeric value.

The _max_ is optional. It is a numeric value. The default value is 2147483647.

—

### The `/tag` command

|| For version higher than the 1.12 one ( 1.13, 1.14, 1.15, 1.16) you will need to use the `/tag` command instead of the `/scoreboard players tag` command.

You will use the following commands to manage tags for your players.

1.
###### `/tag add `

This command will add a tag to the specified player.

2.
###### `/tag remove `

This command will remove a tag from the specified player.

3.
###### `/tag list`

This command will list all tags for the specified player.**

—

### General information about the commands mentioned above:

The _targets_ is the name of the player (or a [target selector](https://help.ggservers.com/en-us/article/vanilla-commands-11xx8gv/#1-target-selectors)) that you wish to target.

The _name_ is the name of the tag to add or remove from the targeted players and it can not contain spaces.

—

| If you find any issues setting up your Scoreboard please feel free to contact us via live chat or via the ticket system [here](https://ggservers.com/billing/submitticket.php).

—

# ❕ Useful Links ❕

– [Vanilla Commands](https://help.ggservers.com/en-us/article/vanilla-commands-11xx8gv/)
– [Players Can’t Break Blocks (Spawn Protection)](https://help.ggservers.com/en-us/article/players-cant-break-blocks-spawn-protection-1ypcdqu/)
– [How to Use the Minecraft Whitelist](https://help.ggservers.com/en-us/article/how-to-use-the-minecraft-whitelist-1nw0h6e/)