Package org.bukkit.scoreboard

Interface Objective

public interface Objective

An objective on a scoreboard that can show scores specific to entries. This objective is only relevant to the display of the associated scoreboard.

Method Summary

Modifier and Type	Method	Description
@NotNull String	getCriteria()	Gets the criteria this objective tracks.
@NotNull String	getDisplayName()	Gets the name displayed to players for this objective
@Nullable DisplaySlot	getDisplaySlot()	Gets the display slot this objective is displayed at.
@NotNull String	getName()	Gets the name of this Objective
@NotNull RenderType	getRenderType()	Sets manner in which this objective will be rendered.
@NotNull Score	getScore(@NotNull String entry)	Gets an entry's Score for an Objective on this Scoreboard.
@NotNull Score	getScore(@NotNull OfflinePlayer player)	Deprecated. Scoreboards can contain entries that aren't players
@Nullable Scoreboard	getScoreboard()	Gets the scoreboard to which this objective is attached.
boolean	isModifiable()	Gets if the objective's scores can be modified directly by a plugin.
void	setDisplayName(@NotNull String displayName)	Sets the name displayed to players for this objective.
void	setDisplaySlot(@Nullable DisplaySlot slot)	Sets this objective to display on the specified slot for the scoreboard, removing it from any other display slot.
void	setRenderType(@NotNull RenderType renderType)	Sets manner in which this objective will be rendered.
void	unregister()	Unregisters this objective from the scoreboard.

Method Detail

getName

@NotNull
@NotNull String getName()
                 throws IllegalStateException

Gets the name of this Objective

Returns:

this objective's name

Throws:

IllegalStateException - if this objective has been unregistered

getDisplayName

@NotNull
@NotNull String getDisplayName()
                        throws IllegalStateException

Gets the name displayed to players for this objective

Returns:

this objective's display name

Throws:

IllegalStateException - if this objective has been unregistered

setDisplayName

void setDisplayName(@NotNull
                    @NotNull String displayName)
             throws IllegalStateException,
                    IllegalArgumentException

Sets the name displayed to players for this objective.

Parameters:

displayName - Display name to set

Throws:

IllegalStateException - if this objective has been unregistered

IllegalArgumentException - if displayName is null

IllegalArgumentException - if displayName is longer than 128 characters.

getCriteria

@NotNull
@NotNull String getCriteria()
                     throws IllegalStateException

Gets the criteria this objective tracks.

Returns:

this objective's criteria

Throws:

IllegalStateException - if this objective has been unregistered

isModifiable

boolean isModifiable()
              throws IllegalStateException

Gets if the objective's scores can be modified directly by a plugin.

Returns:

true if scores are modifiable

Throws:

IllegalStateException - if this objective has been unregistered

See Also:

Criterias.HEALTH

getScoreboard

@Nullable
@Nullable Scoreboard getScoreboard()

Gets the scoreboard to which this objective is attached.

Returns:

Owning scoreboard, or null if it has been unregistered

unregister

void unregister()
         throws IllegalStateException

Unregisters this objective from the scoreboard.

Throws:

IllegalStateException - if this objective has been unregistered

setDisplaySlot

void setDisplaySlot(@Nullable
                    @Nullable DisplaySlot slot)
             throws IllegalStateException

Sets this objective to display on the specified slot for the scoreboard, removing it from any other display slot.

Parameters:

slot - display slot to change, or null to not display

Throws:

IllegalStateException - if this objective has been unregistered

getDisplaySlot

@Nullable
@Nullable DisplaySlot getDisplaySlot()
                              throws IllegalStateException

Gets the display slot this objective is displayed at.

Returns:

the display slot for this objective, or null if not displayed

Throws:

IllegalStateException - if this objective has been unregistered

setRenderType

void setRenderType(@NotNull
                   @NotNull RenderType renderType)
            throws IllegalStateException

Sets manner in which this objective will be rendered.

Parameters:

renderType - new render type

Throws:

IllegalStateException - if this objective has been unregistered

getRenderType

@NotNull
@NotNull RenderType getRenderType()
                           throws IllegalStateException

Sets manner in which this objective will be rendered.

Returns:

the render type

Throws:

IllegalStateException - if this objective has been unregistered

getScore

@Deprecated
@NotNull
@NotNull Score getScore(@NotNull
                        @NotNull OfflinePlayer player)
                 throws IllegalArgumentException,
                        IllegalStateException

Deprecated.

Scoreboards can contain entries that aren't players

Gets a player's Score for an Objective on this Scoreboard

Parameters:

player - Player for the Score

Returns:

Score tracking the Objective and player specified

Throws:

IllegalArgumentException - if player is null

IllegalStateException - if this objective has been unregistered

See Also:

getScore(String)

getScore

@NotNull
@NotNull Score getScore(@NotNull
                        @NotNull String entry)
                 throws IllegalArgumentException,
                        IllegalStateException

Gets an entry's Score for an Objective on this Scoreboard.

Parameters:

entry - Entry for the Score

Returns:

Score tracking the Objective and entry specified

Throws:

IllegalArgumentException - if entry is null

IllegalStateException - if this objective has been unregistered

IllegalArgumentException - if entry is longer than 40 characters.