org.bukkit.scoreboard

接口 Objective

public interface Objective

计分板对象: 显示特定条目分数.

该对象仅显示关联项目.scoreboard.

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

方法概要

限定符和类型	方法和说明
java.lang.String	getCriteria() 获取对象规则.
java.lang.String	getDisplayName() 获取对象内用于显示的名称.
DisplaySlot	getDisplaySlot() 获取对象显示的计分板位置区域.
java.lang.String	getName() 获取对象名称.
Score	getScore(OfflinePlayer player) 已过时。 计分板可以包含非玩家项
Score	getScore(java.lang.String entry) 获取一个对象的计分项目的积分.
Scoreboard	getScoreboard() 获取对象所链接的计分板.
boolean	isModifiable() 获取布尔值:对象分数是否可以被插件直接修改.
void	setDisplayName(java.lang.String displayName) 设置对象内用于显示的名称.
void	setDisplaySlot(DisplaySlot slot) 设置对象显示的计分板位置区域.
void	unregister() 注销对象 scoreboard..

方法详细资料

getName

java.lang.String getName()
                  throws java.lang.IllegalStateException

获取对象名称.

返回:

对象名称

抛出:

java.lang.IllegalStateException - 对象已被注销

getDisplayName

java.lang.String getDisplayName()
                         throws java.lang.IllegalStateException

获取对象内用于显示的名称.

返回:

用于显示的名称

抛出:

java.lang.IllegalStateException - 对象已被注销

setDisplayName

void setDisplayName(java.lang.String displayName)
             throws java.lang.IllegalStateException,
                    java.lang.IllegalArgumentException

设置对象内用于显示的名称.

参数:

displayName - 用于显示的名称

抛出:

java.lang.IllegalStateException - 对象已被注销

java.lang.IllegalArgumentException - 参数displayName（显示名称）为空

java.lang.IllegalArgumentException - 参数displayName（显示名称）大于32个字符 characters.

getCriteria

java.lang.String getCriteria()
                      throws java.lang.IllegalStateException

获取对象规则.

原文:Gets the criteria this objective tracks.

返回:

对象规则

抛出:

java.lang.IllegalStateException - 对象已被注销

isModifiable

boolean isModifiable()
              throws java.lang.IllegalStateException

获取布尔值:对象分数是否可以被插件直接修改.

返回:

true-可以

抛出:

java.lang.IllegalStateException - 对象已被注销

另请参阅:

Criterias.HEALTH

getScoreboard

Scoreboard getScoreboard()

获取对象所链接的计分板.

返回:

所属计分板 或者 null 对象已被注销 unregistered

unregister

void unregister()
         throws java.lang.IllegalStateException

注销对象 scoreboard..

抛出:

java.lang.IllegalStateException - 对象已被注销

setDisplaySlot

void setDisplaySlot(DisplaySlot slot)
             throws java.lang.IllegalStateException

设置对象显示的计分板位置区域.

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

参数:

slot - 显示的位置区域(null不显示)

抛出:

java.lang.IllegalStateException - 对象已被注销

getDisplaySlot

DisplaySlot getDisplaySlot()
                    throws java.lang.IllegalStateException

获取对象显示的计分板位置区域.

Gets the display slot this objective is displayed at.

返回:

对象显示位置区域(null为不显示)

抛出:

java.lang.IllegalStateException - 对象已被注销

getScore

@Deprecated
Score getScore(OfflinePlayer player)
                    throws java.lang.IllegalArgumentException,
                           java.lang.IllegalStateException

已过时。 计分板可以包含非玩家项

获对象内玩分数.

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

参数:

player - 玩家ID

返回:

指定对象和玩家的分数

抛出:

java.lang.IllegalArgumentException - 参数player（玩家ID）为空

java.lang.IllegalStateException - if this 对象已被注销

另请参阅:

getScore(String)

getScore

Score getScore(java.lang.String entry)
        throws java.lang.IllegalArgumentException,
               java.lang.IllegalStateException

获取一个对象的计分项目的积分.

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

参数:

entry - 计分项目

返回:

对象内指定项目的积分

抛出:

java.lang.IllegalArgumentException - 参数entry（项目）为空

java.lang.IllegalStateException - 对象已被注销