SPIGOT-2768: Fully implement map color

1 files changed, 30 insertions, 1 deletions

diff --git a/src/main/java/org/bukkit/inventory/meta/MapMeta.java b/src/main/java/org/bukkit/inventory/meta/MapMeta.java
index 4dbe95d5..a0e60142 100644
--- a/src/main/java/org/bukkit/inventory/meta/MapMeta.java
+++ b/src/main/java/org/bukkit/inventory/meta/MapMeta.java
@@ -1,5 +1,7 @@
 package org.bukkit.inventory.meta;
 
+import org.bukkit.Color;
+
 /**
  * Represents a map that can be scalable.
  */
@@ -37,11 +39,38 @@ public interface MapMeta extends ItemMeta {
     String getLocationName();
 
     /**
-     * Sets the location name.
+     * Sets the location name. A custom map color will alter the display of the
+     * map in an inventory slot.
      *
      * @param name the name to set
      */
     void setLocationName(String name);
 
+    /**
+     * Checks for existence of a map color.
+     *
+     * @return true if this has a custom map color
+     */
+    boolean hasColor();
+
+    /**
+     * Gets the map color that is set. A custom map color will alter the display
+     * of the map in an inventory slot.
+     * <p>
+     * Plugins should check that hasColor() returns <code>true</code> before
+     * calling this method.
+     *
+     * @return the map color that is set
+     */
+    Color getColor();
+
+    /**
+     * Sets the map color. A custom map color will alter the display of the map
+     * in an inventory slot.
+     *
+     * @param color the color to set
+     */
+    void setColor(Color color);
+
     MapMeta clone();
 }