程序包 org.bukkit.inventory.meta

接口 MapMeta

所有超级接口:

Cloneable, ConfigurationSerializable, ItemMeta, PersistentDataHolder

public interface MapMeta
extends ItemMeta

代表可被伸缩的地图.

方法概要

修饰符和类型	方法	说明
@NotNull MapMeta	clone()
@Nullable Color	getColor()	获取地图材质的颜色.
@Nullable String	getLocationName()	已过时。 本方法没有预期效果, 这实际上是 ItemMeta.getLocalizedName() 的别名
int	getMapId()	已过时。 这些方法是设计糟糕的API:它们依赖调用者, 仅传递一个整数属性值, 并且曾经有着糟糕的实现 - 未判断地图 id 是否合法(是否存在).
@Nullable MapView	getMapView()	获取与此地图物品相关的地图.
boolean	hasColor()	检查是否为地图物品设置了自定义的颜色.
boolean	hasLocationName()	已过时。 本方法没有预期效果, 这实际上是 ItemMeta.hasLocalizedName() 的别名
boolean	hasMapId()	已过时。 这些方法是设计糟糕的API:它们依赖调用者, 仅传递一个整数属性值, 并且曾经有着糟糕的实现 - 未判断地图 id 是否合法(是否存在).
boolean	hasMapView()	检查此物品是否设置了相关的地图.
boolean	isScaling()	检测这个地图是否有缩放比例.
void	setColor(@Nullable Color color)	设置地图材质的颜色.
void	setLocationName(@Nullable String name)	已过时。 本方法没有预期效果, 这实际上是 ItemMeta.setLocalizedName(String) 的别名
void	setMapId(int id)	已过时。 这些方法是设计糟糕的API:它们依赖调用者, 仅传递一个整数属性值, 并且曾经有着糟糕的实现 - 未判断地图 id 是否合法(是否存在).
void	setMapView(MapView map)	设置相关的地图.
void	setScaling(boolean value)	设置这个地图是否有缩放比例.

从接口继承的方法 org.bukkit.configuration.serialization.ConfigurationSerializable

serialize

从接口继承的方法 org.bukkit.inventory.meta.ItemMeta

addAttributeModifier, addEnchant, addItemFlags, getAsComponentString, getAsString, getAttributeModifiers, getAttributeModifiers, getAttributeModifiers, getCustomModelData, getCustomTagContainer, getDisplayName, getEnchantLevel, getEnchantmentGlintOverride, getEnchants, getFood, getItemFlags, getItemName, getJukeboxPlayable, getLocalizedName, getLore, getMaxStackSize, getRarity, getTool, hasAttributeModifiers, hasConflictingEnchant, hasCustomModelData, hasDisplayName, hasEnchant, hasEnchantmentGlintOverride, hasEnchants, hasFood, hasItemFlag, hasItemName, hasJukeboxPlayable, hasLocalizedName, hasLore, hasMaxStackSize, hasRarity, hasTool, isFireResistant, isHideTooltip, isUnbreakable, removeAttributeModifier, removeAttributeModifier, removeAttributeModifier, removeEnchant, removeEnchantments, removeItemFlags, setAttributeModifiers, setCustomModelData, setDisplayName, setEnchantmentGlintOverride, setFireResistant, setFood, setHideTooltip, setItemName, setJukeboxPlayable, setLocalizedName, setLore, setMaxStackSize, setRarity, setTool, setUnbreakable, setVersion

从接口继承的方法 org.bukkit.persistence.PersistentDataHolder

getPersistentDataContainer

方法详细资料

hasMapId

@Deprecated
boolean hasMapId()

已过时。

这些方法是设计糟糕的API:它们依赖调用者, 仅传递一个整数属性值, 并且曾经有着糟糕的实现 - 未判断地图 id 是否合法(是否存在). 现代的实现 - 例如, 服务器会生成一个不同 id 的新地图. 开发者应使用 xxxMapView 家族的方法.

检测此地图是否有编号.

原文: Checks for existence of a map ID number.

返回:

地图是否有编号

另请参阅:

• hasMapView()

getMapId

@Deprecated
int getMapId()

已过时。

这些方法是设计糟糕的API:它们依赖调用者, 仅传递一个整数属性值, 并且曾经有着糟糕的实现 - 未判断地图 id 是否合法(是否存在). 现代的实现 - 例如, 服务器会生成一个不同 id 的新地图. 开发者应使用 xxxMapView 家族的方法.

获取关联地图的编号. 这用来决定地图是否显示出来.

插件应该在调用这个方法之前检测 hasMapId() 是否返回 true.

原文: Gets the map ID that is set. This is used to determine what map is displayed.

Plugins should check that hasMapId() returns true before calling this method.

返回:

地图编号

另请参阅:

• getMapView()

setMapId

@Deprecated
void setMapId(int id)

已过时。

这些方法是设计糟糕的API:它们依赖调用者, 仅传递一个整数属性值, 并且曾经有着糟糕的实现 - 未判断地图 id 是否合法(是否存在). 现代的实现 - 例如, 服务器会生成一个不同 id 的新地图. 开发者应使用 xxxMapView 家族的方法.

设置相关地图的 ID. 这用来决定地图是否显示出来.

原文: Sets the map ID. This is used to determine what map is displayed.

参数:

id - 地图编号

另请参阅:

• setMapView(org.bukkit.map.MapView)

hasMapView

boolean hasMapView()

检查此物品是否设置了相关的地图.

原文: Checks for existence of an associated map.

返回:

如果设置了相关的地图则返回 true

getMapView

@Nullable
@Nullable MapView getMapView()

获取与此地图物品相关的地图.

插件应该在调用这个方法之前检测 hasMapView() 是否返回 true.

原文: Gets the map view that is associated with this map item.

Plugins should check that hasMapView() returns true before calling this method.

返回:

地图视图, 如果 hasMapView() 为 true, 但这个地图不存在于服务器上则返回 null

setMapView

void setMapView(MapView map)

设置相关的地图. 这用来决定地图是否显示出来.

底层实现可能允许 null 值以清空地图, 但这并不是必须的, 当玩家首次使用地图物品时, 有可能会生成一个新的(未定义的)地图.

原文: Sets the associated map. This is used to determine what map is displayed.

The implementation may allow null to clear the associated map, but this is not required and is liable to generate a new (undefined) map when the item is first used.

参数:

map - 要设置的地图

isScaling

boolean isScaling()

检测这个地图是否有缩放比例.

原文：Checks to see if this map is scaling.

返回:

true表示地图有缩放比例

setScaling

void setScaling(boolean value)

设置这个地图是否有缩放比例.

原文：Sets if this map is scaling or not.

参数:

value - true表示可缩放

hasLocationName

@Deprecated
boolean hasLocationName()

已过时。

本方法没有预期效果, 这实际上是 ItemMeta.hasLocalizedName() 的别名

检查是否有位置名.

原文: Checks for existence of a location name.

返回:

是否有位置名

getLocationName

@Deprecated
@Nullable
@Nullable String getLocationName()

已过时。

本方法没有预期效果, 这实际上是 ItemMeta.getLocalizedName() 的别名

获取位置名.

插件应该在调用这个方法之前检测 hasLocationName() 是否返回 true.

原文: Gets the location name that is set.

Plugins should check that hasLocationName() returns true before calling this method.

返回:

位置名

setLocationName

@Deprecated
void setLocationName(@Nullable
 @Nullable String name)

已过时。

本方法没有预期效果, 这实际上是 ItemMeta.setLocalizedName(String) 的别名

设置位置名.

原文: Sets the location name. A custom map color will alter the display of the map in an inventory slot.

参数:

name - 位置名

hasColor

boolean hasColor()

检查是否为地图物品设置了自定义的颜色.

原文: Checks for existence of a map color.

返回:

是否有自定义的颜色

getColor

@Nullable
@Nullable Color getColor()

获取地图材质的颜色. 此颜色可在物品栏中地图物品的格子内观察到.

插件应该在调用这个方法之前检测 hasColor() 是否返回 true.

原文: Gets the map color that is set. A custom map color will alter the display of the map in an inventory slot.

Plugins should check that hasColor() returns true before calling this method.

返回:

颜色

setColor

void setColor(@Nullable
 @Nullable Color color)

设置地图材质的颜色. 此颜色可在物品栏中地图物品的格子内观察到.

原文: Sets the map color. A custom map color will alter the display of the map in an inventory slot.

参数:

color - 颜色

clone

@NotNull
@NotNull MapMeta clone()

指定者:

clone 在接口中 ItemMeta