Package org.bukkit.scoreboard
Interface Team
- All Superinterfaces:
Audience
,ForwardingAudience
,Pointered
A team on a scoreboard that has a common display theme and other
properties. This team is only relevant to the display of the associated
scoreboard
.-
Nested Class Summary
Modifier and TypeInterfaceDescriptionstatic enum
Represents an option which may be applied to this team.static enum
How an option may be applied to members of this team.Nested classes/interfaces inherited from interface net.kyori.adventure.audience.ForwardingAudience
ForwardingAudience.Single
-
Method Summary
Modifier and TypeMethodDescriptionvoid
addEntities
(Collection<Entity> entities) This puts a collection of entities onto this team for the scoreboard which results in one packet for the updates rather than a packet-per-entity.default void
addEntities
(Entity @NotNull ... entities) This puts a collection of entities onto this team for the scoreboard which results in one packet for the updates rather than a packet-per-entity.void
This puts the specified entity onto this team for the scoreboard.default void
addEntries
(@NotNull String... entries) This puts a collection of entries onto this team for the scoreboard which results in one packet for the updates rather than a packet-per-entry.void
addEntries
(Collection<String> entries) This puts a collection of entries onto this team for the scoreboard which results in one packet for the updates rather than a packet-per-entry.void
This puts the specified entry onto this team for the scoreboard.void
addPlayer
(@NotNull OfflinePlayer player) This puts the specified player onto this team for the scoreboard.boolean
Gets the team friendly fire stateboolean
Gets the team's ability to seeinvisible
teammates.color()
Gets the color of the team.void
color
(@Nullable NamedTextColor color) Sets the color of the team.Gets the display name for this teamvoid
displayName
(@Nullable Component displayName) Sets the name displayed to entries for this teamgetColor()
Deprecated.Deprecated.in favour ofdisplayName()
Gets the Set of entries on the teamgetName()
Gets the name of this TeamDeprecated.getOption
(@NotNull Team.Option option) Get an option for this teamDeprecated.Teams can contain entries that aren't playersDeprecated.in favour ofprefix()
Gets the Scoreboard to which this team is attachedint
getSize()
Gets the size of the teamDeprecated.in favour ofsuffix()
boolean
hasColor()
Checks if the team has a color specifiedboolean
Checks to see if the specified entity is a member of this team.boolean
Checks to see if the specified entry is a member of this team.boolean
hasPlayer
(@NotNull OfflinePlayer player) Checks to see if the specified player is a member of this team.prefix()
Gets the prefix prepended to the display of entries on this team.void
Sets the prefix prepended to the display of entries on this team.boolean
removeEntities
(Collection<Entity> entities) Removes a collection of entities from this team which results in one packet for the updates rather than a packet-per-entity.default boolean
removeEntities
(Entity @NotNull ... entities) Removes a collection of entities from this team which results in one packet for the updates rather than a packet-per-entity.boolean
removeEntity
(Entity entity) Removes the entity from this team.default boolean
removeEntries
(@NotNull String... entries) Removes a collection of entries from this team which results in one packet for the updates rather than a packet-per-entry.boolean
removeEntries
(Collection<String> entries) Removes a collection of entries from this team which results in one packet for the updates rather than a packet-per-entry.boolean
removeEntry
(@NotNull String entry) Removes the entry from this team.boolean
removePlayer
(@NotNull OfflinePlayer player) Removes the player from this team.void
setAllowFriendlyFire
(boolean enabled) Sets the team friendly fire statevoid
setCanSeeFriendlyInvisibles
(boolean enabled) Sets the team's ability to seeinvisible
teammates.void
Deprecated.void
setDisplayName
(@NotNull String displayName) Deprecated.in favour ofdisplayName(net.kyori.adventure.text.Component)
void
setNameTagVisibility
(@NotNull NameTagVisibility visibility) Deprecated.void
setOption
(@NotNull Team.Option option, @NotNull Team.OptionStatus status) Set an option for this teamvoid
Deprecated.in favour ofprefix(net.kyori.adventure.text.Component)
void
Deprecated.in favour ofsuffix(net.kyori.adventure.text.Component)
suffix()
Gets the suffix appended to the display of entries on this team.void
Sets the suffix appended to the display of entries on this team.void
Unregisters this team from the ScoreboardMethods inherited from interface net.kyori.adventure.audience.Audience
deleteMessage, openBook, removeResourcePacks, removeResourcePacks, removeResourcePacks, sendActionBar, sendMessage, sendMessage, sendMessage, sendMessage, sendMessage, sendMessage, sendMessage, sendMessage, sendMessage, sendMessage, sendPlayerListFooter, sendPlayerListHeader, sendPlayerListHeaderAndFooter, sendResourcePacks, sendResourcePacks, showTitle, stopSound
Methods inherited from interface net.kyori.adventure.audience.ForwardingAudience
audiences, clearResourcePacks, clearTitle, deleteMessage, filterAudience, forEachAudience, hideBossBar, openBook, playSound, playSound, playSound, pointers, removeResourcePacks, removeResourcePacks, resetTitle, sendActionBar, sendMessage, sendMessage, sendMessage, sendMessage, sendMessage, sendPlayerListFooter, sendPlayerListHeader, sendPlayerListHeaderAndFooter, sendResourcePacks, sendTitlePart, showBossBar, stopSound
Methods inherited from interface net.kyori.adventure.pointer.Pointered
get, getOrDefault, getOrDefaultFrom
-
Method Details
-
getName
Gets the name of this Team- Returns:
- Objective name
- Throws:
IllegalStateException
- if this team has been unregistered
-
displayName
Gets the display name for this team- Returns:
- Team display name
- Throws:
IllegalStateException
- if this team has been unregistered
-
displayName
Sets the name displayed to entries for this team- Parameters:
displayName
- New display name- Throws:
IllegalStateException
- if this team has been unregistered
-
prefix
Gets the prefix prepended to the display of entries on this team.- Returns:
- Team prefix
- Throws:
IllegalStateException
- if this team has been unregistered
-
prefix
Sets the prefix prepended to the display of entries on this team.- Parameters:
prefix
- New prefix- Throws:
IllegalStateException
- if this team has been unregistered
-
suffix
Gets the suffix appended to the display of entries on this team.- Returns:
- the team's current suffix
- Throws:
IllegalStateException
- if this team has been unregistered
-
suffix
Sets the suffix appended to the display of entries on this team.- Parameters:
suffix
- the new suffix for this team.- Throws:
IllegalStateException
- if this team has been unregistered
-
hasColor
boolean hasColor()Checks if the team has a color specified- Returns:
- true if it has a color
- Throws:
IllegalStateException
- if this team has been unregistered
-
color
Gets the color of the team.
This only sets the team outline, other occurrences of colors such as in names are handled by prefixes / suffixes.- Returns:
- team color
- Throws:
IllegalStateException
- if this team has been unregisteredIllegalStateException
- if the team doesn't have a color- See Also:
-
color
Sets the color of the team.
This only sets the team outline, other occurrences of colors such as in names are handled by prefixes / suffixes.- Parameters:
color
- new color, null for no color
-
getDisplayName
Deprecated.in favour ofdisplayName()
Gets the name displayed to entries for this team- Returns:
- Team display name
- Throws:
IllegalStateException
- if this team has been unregistered
-
setDisplayName
Deprecated.in favour ofdisplayName(net.kyori.adventure.text.Component)
Sets the name displayed to entries for this team- Parameters:
displayName
- New display name- Throws:
IllegalStateException
- if this team has been unregistered
-
getPrefix
Deprecated.in favour ofprefix()
Gets the prefix prepended to the display of entries on this team.- Returns:
- Team prefix
- Throws:
IllegalStateException
- if this team has been unregistered
-
setPrefix
Deprecated.in favour ofprefix(net.kyori.adventure.text.Component)
Sets the prefix prepended to the display of entries on this team.- Parameters:
prefix
- New prefix- Throws:
IllegalStateException
- if this team has been unregistered
-
getSuffix
Deprecated.in favour ofsuffix()
Gets the suffix appended to the display of entries on this team.- Returns:
- the team's current suffix
- Throws:
IllegalStateException
- if this team has been unregistered
-
setSuffix
Deprecated.in favour ofsuffix(net.kyori.adventure.text.Component)
Sets the suffix appended to the display of entries on this team.- Parameters:
suffix
- the new suffix for this team.- Throws:
IllegalStateException
- if this team has been unregistered
-
getColor
Deprecated.in favour ofcolor()
Gets the color of the team.
This only sets the team outline, other occurrences of colors such as in names are handled by prefixes / suffixes.- Returns:
- team color, defaults to
ChatColor.RESET
- Throws:
IllegalStateException
- if this team has been unregistered
-
setColor
Deprecated.Sets the color of the team.
This only sets the team outline, other occurrences of colors such as in names are handled by prefixes / suffixes.- Parameters:
color
- new color, must be non-null. UseChatColor.RESET
for no color
-
allowFriendlyFire
boolean allowFriendlyFire()Gets the team friendly fire state- Returns:
- true if friendly fire is enabled
- Throws:
IllegalStateException
- if this team has been unregistered
-
setAllowFriendlyFire
void setAllowFriendlyFire(boolean enabled) Sets the team friendly fire state- Parameters:
enabled
- true if friendly fire is to be allowed- Throws:
IllegalStateException
- if this team has been unregistered
-
canSeeFriendlyInvisibles
boolean canSeeFriendlyInvisibles()Gets the team's ability to seeinvisible
teammates.- Returns:
- true if team members can see invisible members
- Throws:
IllegalStateException
- if this team has been unregistered
-
setCanSeeFriendlyInvisibles
void setCanSeeFriendlyInvisibles(boolean enabled) Sets the team's ability to seeinvisible
teammates.- Parameters:
enabled
- true if invisible teammates are to be visible- Throws:
IllegalStateException
- if this team has been unregistered
-
getNameTagVisibility
Deprecated.Gets the team's ability to see name tags- Returns:
- the current name tag visibility for the team
- Throws:
IllegalArgumentException
- if this team has been unregistered
-
setNameTagVisibility
Deprecated.Set's the team's ability to see name tags- Parameters:
visibility
- The nameTagVisibility to set- Throws:
IllegalArgumentException
- if this team has been unregistered
-
getPlayers
Deprecated.Teams can contain entries that aren't playersGets the Set of players on the team- Returns:
- players on the team
- Throws:
IllegalStateException
- if this team has been unregistered- See Also:
-
getEntries
Gets the Set of entries on the team- Returns:
- entries on the team
- Throws:
IllegalStateException
- if this team has been unregistered
-
getSize
int getSize()Gets the size of the team- Returns:
- number of entries on the team
- Throws:
IllegalStateException
- if this team has been unregistered
-
getScoreboard
Gets the Scoreboard to which this team is attached- Returns:
- Owning scoreboard, or null if this team has been
unregistered
-
addPlayer
This puts the specified player onto this team for the scoreboard.This will remove the player from any other team on the scoreboard.
- Parameters:
player
- the player to add- Throws:
IllegalStateException
- if this team has been unregistered- See Also:
-
addEntry
This puts the specified entry onto this team for the scoreboard.This will remove the entry from any other team on the scoreboard.
- Parameters:
entry
- the entry to add- Throws:
IllegalStateException
- if this team has been unregistered
-
addEntities
This puts a collection of entities onto this team for the scoreboard which results in one packet for the updates rather than a packet-per-entity.Entities on other teams will be removed from their respective teams.
- Parameters:
entities
- the entities to add- Throws:
IllegalArgumentException
- if entities are nullIllegalStateException
- if this team has been unregistered
-
addEntities
void addEntities(@NotNull Collection<Entity> entities) throws IllegalStateException, IllegalArgumentException This puts a collection of entities onto this team for the scoreboard which results in one packet for the updates rather than a packet-per-entity.Entities on other teams will be removed from their respective teams.
- Parameters:
entities
- the entities to add- Throws:
IllegalArgumentException
- if entities are nullIllegalStateException
- if this team has been unregistered
-
addEntries
default void addEntries(@NotNull @NotNull String... entries) throws IllegalStateException, IllegalArgumentException This puts a collection of entries onto this team for the scoreboard which results in one packet for the updates rather than a packet-per-entry.Entries on other teams will be removed from their respective teams.
- Parameters:
entries
- the entries to add- Throws:
IllegalArgumentException
- if entries are nullIllegalStateException
- if this team has been unregistered
-
addEntries
void addEntries(@NotNull Collection<String> entries) throws IllegalStateException, IllegalArgumentException This puts a collection of entries onto this team for the scoreboard which results in one packet for the updates rather than a packet-per-entry.Entries on other teams will be removed from their respective teams.
- Parameters:
entries
- the entries to add- Throws:
IllegalArgumentException
- if entries are nullIllegalStateException
- if this team has been unregistered
-
removePlayer
Removes the player from this team.- Parameters:
player
- the player to remove- Returns:
- if the player was on this team
- Throws:
IllegalStateException
- if this team has been unregistered- See Also:
-
removeEntry
Removes the entry from this team.- Parameters:
entry
- the entry to remove- Returns:
- if the entry was a part of this team
- Throws:
IllegalStateException
- if this team has been unregistered
-
removeEntities
default boolean removeEntities(@NotNull Entity @NotNull ... entities) throws IllegalStateException, IllegalArgumentException Removes a collection of entities from this team which results in one packet for the updates rather than a packet-per-entity.- Parameters:
entities
- the entries to remove- Returns:
- if any of the entities were a part of this team
- Throws:
IllegalArgumentException
- if entities is nullIllegalStateException
- if this team has been unregistered
-
removeEntities
boolean removeEntities(@NotNull Collection<Entity> entities) throws IllegalStateException, IllegalArgumentException Removes a collection of entities from this team which results in one packet for the updates rather than a packet-per-entity.- Parameters:
entities
- the entries to remove- Returns:
- if any of the entities were a part of this team
- Throws:
IllegalArgumentException
- if entities is nullIllegalStateException
- if this team has been unregistered
-
removeEntries
default boolean removeEntries(@NotNull @NotNull String... entries) throws IllegalStateException, IllegalArgumentException Removes a collection of entries from this team which results in one packet for the updates rather than a packet-per-entry.- Parameters:
entries
- the entries to remove- Returns:
- if any of the entries were a part of this team
- Throws:
IllegalArgumentException
- if entries is nullIllegalStateException
- if this team has been unregistered
-
removeEntries
boolean removeEntries(@NotNull Collection<String> entries) throws IllegalStateException, IllegalArgumentException Removes a collection of entries from this team which results in one packet for the updates rather than a packet-per-entry.- Parameters:
entries
- the entries to remove- Returns:
- if any of the entries were a part of this team
- Throws:
IllegalArgumentException
- if entries is nullIllegalStateException
- if this team has been unregistered
-
unregister
void unregister()Unregisters this team from the Scoreboard- Throws:
IllegalStateException
- if this team has been unregistered
-
hasPlayer
Checks to see if the specified player is a member of this team.- Parameters:
player
- the player to search for- Returns:
- true if the player is a member of this team
- Throws:
IllegalStateException
- if this team has been unregistered- See Also:
-
hasEntry
Checks to see if the specified entry is a member of this team.- Parameters:
entry
- the entry to search for- Returns:
- true if the entry is a member of this team
- Throws:
IllegalStateException
- if this team has been unregistered
-
getOption
Get an option for this team- Parameters:
option
- the option to get- Returns:
- the option status
- Throws:
IllegalStateException
- if this team has been unregistered
-
setOption
Set an option for this team- Parameters:
option
- the option to setstatus
- the new option status- Throws:
IllegalStateException
- if this team has been unregistered
-
addEntity
This puts the specified entity onto this team for the scoreboard.This will remove the entity from any other team on the scoreboard.
- Parameters:
entity
- the entity to add- Throws:
IllegalArgumentException
- if entity is nullIllegalStateException
- if this team has been unregistered- See Also:
-
removeEntity
Removes the entity from this team.- Parameters:
entity
- the entity to remove- Returns:
- if the entity was on this team
- Throws:
IllegalArgumentException
- if entity is nullIllegalStateException
- if this team has been unregistered- See Also:
-
hasEntity
Checks to see if the specified entity is a member of this team.- Parameters:
entity
- the entity to search for- Returns:
- true if the entity is a member of this team
- Throws:
IllegalArgumentException
- if entity is nullIllegalStateException
- if this team has been unregistered- See Also:
-
color()