程序包 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`