程序包 org.bukkit.scoreboard

# 接口 Scoreboard

public interface Scoreboard
单个计分板.

- ## 方法概要

  修饰符和类型
  方法
  说明
  `void`
  `clearSlot(@NotNull DisplaySlot slot)`
  清空指定位置处的计分项.
  `@NotNull Set<String>`
  `getEntries()`
  获取计分板跟踪的所有项目.
  `@Nullable Team`
  `getEntryTeam(@NotNull String entry)`
  获取项目所处的队伍.
  `@Nullable Objective`
  `getObjective(@NotNull String name)`
  根据名称获取计分项.
  `@Nullable Objective`
  `getObjective(@NotNull DisplaySlot slot)`
  获取计分板展示在指定位置的计分项.
  `@NotNull Set<Objective>`
  `getObjectives()`
  获取计分板上的所有计分项.
  `@NotNull Set<Objective>`
  `getObjectivesByCriteria(@NotNull String criteria)`
  已过时。
  请使用 `getObjectivesByCriteria(Criteria)`
  `@NotNull Set<Objective>`
  `getObjectivesByCriteria(@NotNull Criteria criteria)`
  获取使用此准则的所有计分项.
  `@NotNull Set<OfflinePlayer>`
  `getPlayers()`
  已过时。
  计分板可包含非玩家项目
  `@Nullable Team`
  `getPlayerTeam(@NotNull OfflinePlayer player)`
  已过时。
  计分板可包含非玩家项目
  `@NotNull Set<Score>`
  `getScores(@NotNull String entry)`
  获取某项目的所有分数记录.
  `@NotNull Set<Score>`
  `getScores(@NotNull OfflinePlayer player)`
  已过时。
  计分板可包含非玩家项目
  `@Nullable Team`
  `getTeam(@NotNull String teamName)`
  根据名称获取指定队伍.
  `@NotNull Set<Team>`
  `getTeams()`
  获取计分板上的所有队伍.
  `@NotNull Objective`
  `registerNewObjective(@NotNull String name, @NotNull String criteria)`
  已过时。
  应明确指定计分项的显示名
  `@NotNull Objective`
  `registerNewObjective(@NotNull String name, @NotNull String criteria, @NotNull String displayName)`
  已过时。
  请使用 `registerNewObjective(String, Criteria, String)`
  `@NotNull Objective`
  `registerNewObjective(@NotNull String name, @NotNull String criteria, @NotNull String displayName, @NotNull RenderType renderType)`
  已过时。
  请使用 `registerNewObjective(String, Criteria, String, RenderType)`
  `@NotNull Objective`
  `registerNewObjective(@NotNull String name, @NotNull Criteria criteria, @NotNull String displayName)`
  Registers an Objective on this Scoreboard
  `@NotNull Objective`
  `registerNewObjective(@NotNull String name, @NotNull Criteria criteria, @NotNull String displayName, @NotNull RenderType renderType)`
  Registers an Objective on this Scoreboard
  `@NotNull Team`
  `registerNewTeam(@NotNull String name)`
  向计分板注册一个队伍.
  `void`
  `resetScores(@NotNull String entry)`
  移除某项目在此计分板上的所有分数.
  `void`
  `resetScores(@NotNull OfflinePlayer player)`
  已过时。
  计分板可包含非玩家项目

- ## 方法详细资料

  - ### registerNewObjective

    @Deprecated @NotNull @NotNull Objective registerNewObjective(@NotNull @NotNull String name, @NotNull @NotNull String criteria)
    已过时。
    应明确指定计分项的显示名
    向计分板注册一个计分项.

    原文:Registers an Objective on this Scoreboard

    参数:
      `name` - 计分项名称
      `criteria` - 计分项的准则
    返回:
      注册的计分项实例
    抛出:
      `IllegalArgumentException` - 若 name 长度超过 16 个字符 (注:此参数在1.18+支持最长32767个字符)
      `IllegalArgumentException` - 若同名计分项已存在

  - ### registerNewObjective

    @Deprecated @NotNull @NotNull Objective registerNewObjective(@NotNull @NotNull String name, @NotNull @NotNull String criteria, @NotNull @NotNull String displayName)
    已过时。
    请使用 `registerNewObjective(String, Criteria, String)`
    向计分板注册一个计分项.

    原文:Registers an Objective on this Scoreboard

    参数:
      `name` - 计分项名称
      `criteria` - 计分项的准则
      `displayName` - 展示给玩家的计分项显示名称
    返回:
      注册的计分项实例
    抛出:
      `IllegalArgumentException` - 若 name 长度超过 16 个字符 (注:此参数在1.18+支持最长32767个字符)
      `IllegalArgumentException` - 若同名计分项已存在

  - ### registerNewObjective

    @Deprecated @NotNull @NotNull Objective registerNewObjective(@NotNull @NotNull String name, @NotNull @NotNull String criteria, @NotNull @NotNull String displayName, @NotNull @NotNull RenderType renderType)
    已过时。
    请使用 `registerNewObjective(String, Criteria, String, RenderType)`
    向计分板注册一个计分项.

    原文:Registers an Objective on this Scoreboard

    参数:
      `name` - 计分项名称
      `criteria` - 计分项的准则
      `displayName` - 展示给玩家的计分项显示名称
      `renderType` - 计分项的渲染方式
    返回:
      注册的计分项实例
    抛出:
      `IllegalArgumentException` - 若 name 长度超过 16 个字符 (注:此参数在1.18+支持最长32767个字符)
      `IllegalArgumentException` - 若同名计分项已存在

  - ### registerNewObjective

    @NotNull @NotNull Objective registerNewObjective(@NotNull @NotNull String name, @NotNull @NotNull Criteria criteria, @NotNull @NotNull String displayName)
    Registers an Objective on this Scoreboard
    参数:
      `name` - Name of the Objective
      `criteria` - Criteria for the Objective
      `displayName` - Name displayed to players for the Objective.
    返回:
      The registered Objective
    抛出:
      `IllegalArgumentException` - if name is longer than 32767 characters.
      `IllegalArgumentException` - if an objective by that name already exists

  - ### registerNewObjective

    @NotNull @NotNull Objective registerNewObjective(@NotNull @NotNull String name, @NotNull @NotNull Criteria criteria, @NotNull @NotNull String displayName, @NotNull @NotNull RenderType renderType)
    Registers an Objective on this Scoreboard
    参数:
      `name` - Name of the Objective
      `criteria` - Criteria for the Objective
      `displayName` - Name displayed to players for the Objective.
      `renderType` - Manner of rendering the Objective
    返回:
      The registered Objective
    抛出:
      `IllegalArgumentException` - if name is longer than 32767 characters.
      `IllegalArgumentException` - if an objective by that name already exists

  - ### getObjective

    @Nullable @Nullable Objective getObjective(@NotNull @NotNull String name)
    根据名称获取计分项.

    原文:Gets an Objective on this Scoreboard by name

    参数:
      `name` - 计分项名称
    返回:
      计分项对象, 如果不存在则为 null

  - ### getObjectivesByCriteria

    @Deprecated @NotNull @NotNull Set<Objective> getObjectivesByCriteria(@NotNull @NotNull String criteria)
    已过时。
    请使用 `getObjectivesByCriteria(Criteria)`
    获取使用此准则的所有计分项.

    原文:Gets all Objectives of a Criteria on the Scoreboard

    参数:
      `criteria` - 准则
    返回:
      使用指定准测的计分项的不可变集合

  - ### getObjectivesByCriteria

    @NotNull @NotNull Set<Objective> getObjectivesByCriteria(@NotNull @NotNull Criteria criteria)
    获取使用此准则的所有计分项.

    原文:Gets all Objectives of a Criteria on the Scoreboard

    参数:
      `criteria` - 准则
    返回:
      使用指定准测的计分项的不可变集合

  - ### getObjectives

    @NotNull @NotNull Set<Objective> getObjectives()
    获取计分板上的所有计分项.

    原文:Gets all Objectives on this Scoreboard

    返回:
      所有计分项的不可变集合

  - ### getObjective

    @Nullable @Nullable Objective getObjective(@NotNull @NotNull DisplaySlot slot)
    获取计分板展示在指定位置的计分项.

    原文:Gets the Objective currently displayed in a DisplaySlot on this Scoreboard

    参数:
      `slot` - 显示位置
    返回:
      此处的计分项, 如果没有则为 null

  - ### getScores

    @Deprecated @NotNull @NotNull Set<Score> getScores(@NotNull @NotNull OfflinePlayer player)
    已过时。
    计分板可包含非玩家项目
    获取某玩家的所有分数记录.

    原文:Gets all scores for a player on this Scoreboard

    参数:
      `player` - the player whose scores are being retrieved
    返回:
      该玩家的所有分数记录的不可变集合
    另请参阅:
      - `getScores(String)`

  - ### getScores

    @NotNull @NotNull Set<Score> getScores(@NotNull @NotNull String entry)
    获取某项目的所有分数记录.

    原文:Gets all scores for an entry on this Scoreboard

    参数:
      `entry` - 项目
    返回:
      该项目的所有分数记录的不可变集合

  - ### resetScores

    @Deprecated void resetScores(@NotNull @NotNull OfflinePlayer player)
    已过时。
    计分板可包含非玩家项目
    移除某玩家在此计分板上的所有分数.

    原文:Removes all scores for a player on this Scoreboard

    参数:
      `player` - 清空哪一玩家的分数
    另请参阅:
      - `resetScores(String)`

  - ### resetScores

    void resetScores(@NotNull @NotNull String entry)
    移除某项目在此计分板上的所有分数.

    原文:Removes all scores for an entry on this Scoreboard

    参数:
      `entry` - 清空哪一项目的分数

  - ### getPlayerTeam

    @Deprecated @Nullable @Nullable Team getPlayerTeam(@NotNull @NotNull OfflinePlayer player)
    已过时。
    计分板可包含非玩家项目
    获取玩家所处的队伍.

    原文:Gets a player's Team on this Scoreboard

    参数:
      `player` - 要搜索的玩家
    返回:
      玩家所处队伍, 若玩家不在队伍内则为 null
    另请参阅:
      - `getEntryTeam(String)`

  - ### getEntryTeam

    @Nullable @Nullable Team getEntryTeam(@NotNull @NotNull String entry)
    获取项目所处的队伍.

    原文:Gets a entries Team on this Scoreboard

    参数:
      `entry` - 要搜索的项目
    返回:
      项目所处队伍, 若此项目不在队伍内则为 null

  - ### getTeam

    @Nullable @Nullable Team getTeam(@NotNull @NotNull String teamName)
    根据名称获取指定队伍.

    原文:Gets a Team by name on this Scoreboard

    参数:
      `teamName` - 队伍名
    返回:
      匹配的队伍, 若无此队伍则为 null

  - ### getTeams

    @NotNull @NotNull Set<Team> getTeams()
    获取计分板上的所有队伍.

    原文:Gets all teams on this Scoreboard

    返回:
      所有队伍的不可变集合

  - ### registerNewTeam

    @NotNull @NotNull Team registerNewTeam(@NotNull @NotNull String name)
    向计分板注册一个队伍.

    原文:Registers a Team on this Scoreboard

    参数:
      `name` - 队伍名
    返回:
      注册的队伍
    抛出:
      `IllegalArgumentException` - 若同名队伍已存在

  - ### getPlayers

    @Deprecated @NotNull @NotNull Set<OfflinePlayer> getPlayers()
    已过时。
    计分板可包含非玩家项目
    获取计分板跟踪的所有玩家.

    原文:Gets all players tracked by this Scoreboard

    返回:
      跟踪的所有玩家的不可变集合
    另请参阅:
      - `getEntries()`

  - ### getEntries

    @NotNull @NotNull Set<String> getEntries()
    获取计分板跟踪的所有项目.

    原文:Gets all entries tracked by this Scoreboard

    返回:
      跟踪的所有项目的不可变集合

  - ### clearSlot

    void clearSlot(@NotNull @NotNull DisplaySlot slot)
    清空指定位置处的计分项.

    原文:Clears any objective in the specified slot.

    参数:
      `slot` - 计分项位置