接口 MapMeta

所有超级接口:
Cloneable, ConfigurationSerializable, ItemMeta, PersistentDataHolder

public interface MapMeta extends ItemMeta
代表可被伸缩的地图.
  • 方法详细资料

    • hasMapId

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

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

      返回:
      地图是否有编号
      另请参阅:
    • 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.

      返回:
      地图编号
      另请参阅:
    • 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 - 地图编号
      另请参阅:
    • hasMapView

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

      原文: Checks for existence of an associated map.

      返回:
      如果设置了相关的地图则返回 true
    • 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

      已过时。
      本方法没有预期效果, 这实际上是 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

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

      插件应该在调用这个方法之前检测 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

      指定者:
      clone 在接口中 ItemMeta