Package org.bukkit.scoreboard

Interface Scoreboard

public interface Scoreboard

A scoreboard

Method Summary

Modifier and Type	Method	Description
void	clearSlot(DisplaySlot slot)	Clears any objective in the specified slot.
Set<String>	getEntries()	Gets all entries tracked by this Scoreboard
Team	getEntryTeam(String entry)	Gets a entries Team on this Scoreboard
Objective	getObjective(String name)	Gets an Objective on this Scoreboard by name
Objective	getObjective(DisplaySlot slot)	Gets the Objective currently displayed in a DisplaySlot on this Scoreboard
Set<Objective>	getObjectives()	Gets all Objectives on this Scoreboard
Set<Objective>	getObjectivesByCriteria(String criteria)	Gets all Objectives of a Criteria on the Scoreboard
Set<OfflinePlayer>	getPlayers()	Deprecated. Scoreboards can contain entries that aren't players
Team	getPlayerTeam(OfflinePlayer player)	Deprecated. Scoreboards can contain entries that aren't players
Set<Score>	getScores(String entry)	Gets all scores for an entry on this Scoreboard
Set<Score>	getScores(OfflinePlayer player)	Deprecated. Scoreboards can contain entries that aren't players
Team	getTeam(String teamName)	Gets a Team by name on this Scoreboard
Set<Team>	getTeams()	Gets all teams on this Scoreboard
Objective	registerNewObjective(String name, String criteria)	Deprecated. a displayName should be explicitly specified
Objective	registerNewObjective(String name, String criteria, String displayName)	Registers an Objective on this Scoreboard
Objective	registerNewObjective(String name, String criteria, String displayName, RenderType renderType)	Registers an Objective on this Scoreboard
Team	registerNewTeam(String name)	Registers a Team on this Scoreboard
void	resetScores(String entry)	Removes all scores for an entry on this Scoreboard
void	resetScores(OfflinePlayer player)	Deprecated. Scoreboards can contain entries that aren't players

Method Detail

registerNewObjective

@Deprecated
@NotNull
Objective registerNewObjective(@NotNull
                               String name,
                               @NotNull
                               String criteria)
                        throws IllegalArgumentException

Deprecated.

a displayName should be explicitly specified

Registers an Objective on this Scoreboard

Parameters:

name - Name of the Objective

criteria - Criteria for the Objective

Returns:

The registered Objective

Throws:

IllegalArgumentException - if name is null

IllegalArgumentException - if name is longer than 16 characters.

IllegalArgumentException - if criteria is null

IllegalArgumentException - if an objective by that name already exists

registerNewObjective

@NotNull
Objective registerNewObjective(@NotNull
                               String name,
                               @NotNull
                               String criteria,
                               @NotNull
                               String displayName)
                        throws IllegalArgumentException

Registers an Objective on this Scoreboard

Parameters:

name - Name of the Objective

criteria - Criteria for the Objective

displayName - Name displayed to players for the Objective.

Returns:

The registered Objective

Throws:

IllegalArgumentException - if name is null

IllegalArgumentException - if name is longer than 16 characters.

IllegalArgumentException - if criteria is null

IllegalArgumentException - if displayName is null

IllegalArgumentException - if displayName is longer than 128 characters.

IllegalArgumentException - if an objective by that name already exists

registerNewObjective

@NotNull
Objective registerNewObjective(@NotNull
                               String name,
                               @NotNull
                               String criteria,
                               @NotNull
                               String displayName,
                               @NotNull
                               RenderType renderType)
                        throws IllegalArgumentException

Registers an Objective on this Scoreboard

Parameters:

name - Name of the Objective

criteria - Criteria for the Objective

displayName - Name displayed to players for the Objective.

renderType - Manner of rendering the Objective

Returns:

The registered Objective

Throws:

IllegalArgumentException - if name is null

IllegalArgumentException - if name is longer than 16 characters.

IllegalArgumentException - if criteria is null

IllegalArgumentException - if displayName is null

IllegalArgumentException - if displayName is longer than 128 characters.

IllegalArgumentException - if renderType is null

IllegalArgumentException - if an objective by that name already exists

getObjective

@Nullable
Objective getObjective(@NotNull
                       String name)
                throws IllegalArgumentException

Gets an Objective on this Scoreboard by name

Parameters:

name - Name of the Objective

Returns:

the Objective or null if it does not exist

Throws:

IllegalArgumentException - if name is null

getObjectivesByCriteria

@NotNull
Set<Objective> getObjectivesByCriteria(@NotNull
                                       String criteria)
                                throws IllegalArgumentException

Gets all Objectives of a Criteria on the Scoreboard

Parameters:

criteria - Criteria to search by

Returns:

an immutable set of Objectives using the specified Criteria

Throws:

IllegalArgumentException - if criteria is null

getObjectives

@NotNull
Set<Objective> getObjectives()

Gets all Objectives on this Scoreboard

Returns:

An immutable set of all Objectives on this Scoreboard

getObjective

@Nullable
Objective getObjective(@NotNull
                       DisplaySlot slot)
                throws IllegalArgumentException

Gets the Objective currently displayed in a DisplaySlot on this Scoreboard

Parameters:

slot - The DisplaySlot

Returns:

the Objective currently displayed or null if nothing is displayed in that DisplaySlot

Throws:

IllegalArgumentException - if slot is null

getScores

@Deprecated
@NotNull
Set<Score> getScores(@NotNull
                     OfflinePlayer player)
              throws IllegalArgumentException

Deprecated.

Scoreboards can contain entries that aren't players

Gets all scores for a player on this Scoreboard

Parameters:

player - the player whose scores are being retrieved

Returns:

immutable set of all scores tracked for the player

Throws:

IllegalArgumentException - if player is null

See Also:

getScores(String)

getScores

@NotNull
Set<Score> getScores(@NotNull
                     String entry)
              throws IllegalArgumentException

Gets all scores for an entry on this Scoreboard

Parameters:

entry - the entry whose scores are being retrieved

Returns:

immutable set of all scores tracked for the entry

Throws:

IllegalArgumentException - if entry is null

resetScores

@Deprecated
void resetScores(@NotNull
                 OfflinePlayer player)
          throws IllegalArgumentException

Deprecated.

Scoreboards can contain entries that aren't players

Removes all scores for a player on this Scoreboard

Parameters:

player - the player to drop all current scores for

Throws:

IllegalArgumentException - if player is null

See Also:

resetScores(String)

resetScores

void resetScores(@NotNull
                 String entry)
          throws IllegalArgumentException

Removes all scores for an entry on this Scoreboard

Parameters:

entry - the entry to drop all current scores for

Throws:

IllegalArgumentException - if entry is null

getPlayerTeam

@Deprecated
@Nullable
Team getPlayerTeam(@NotNull
                   OfflinePlayer player)
            throws IllegalArgumentException

Deprecated.

Scoreboards can contain entries that aren't players

Gets a player's Team on this Scoreboard

Parameters:

player - the player to search for

Returns:

the player's Team or null if the player is not on a team

Throws:

IllegalArgumentException - if player is null

See Also:

getEntryTeam(String)

getEntryTeam

@Nullable
Team getEntryTeam(@NotNull
                  String entry)
           throws IllegalArgumentException

Gets a entries Team on this Scoreboard

Parameters:

entry - the entry to search for

Returns:

the entries Team or null if the entry is not on a team

Throws:

IllegalArgumentException - if entry is null

getTeam

@Nullable
Team getTeam(@NotNull
             String teamName)
      throws IllegalArgumentException

Gets a Team by name on this Scoreboard

Parameters:

teamName - Team name

Returns:

the matching Team or null if no matches

Throws:

IllegalArgumentException - if teamName is null

getTeams

@NotNull
Set<Team> getTeams()

Gets all teams on this Scoreboard

Returns:

an immutable set of Teams

registerNewTeam

@NotNull
Team registerNewTeam(@NotNull
                     String name)
              throws IllegalArgumentException

Registers a Team on this Scoreboard

Parameters:

name - Team name

Returns:

registered Team

Throws:

IllegalArgumentException - if name is null

IllegalArgumentException - if team by that name already exists

getPlayers

@Deprecated
@NotNull
Set<OfflinePlayer> getPlayers()

Deprecated.

Scoreboards can contain entries that aren't players

Gets all players tracked by this Scoreboard

Returns:

immutable set of all tracked players

See Also:

getEntries()

getEntries

@NotNull
Set<String> getEntries()

Gets all entries tracked by this Scoreboard

Returns:

immutable set of all tracked entries

clearSlot

void clearSlot(@NotNull
               DisplaySlot slot)
        throws IllegalArgumentException

Clears any objective in the specified slot.

Parameters:

slot - the slot to remove objectives

Throws:

IllegalArgumentException - if slot is null