Add MapPalette.getNearestColor (#13104)

Author: mintychochip

paper-api/src/main/java/org/bukkit/map/MapPalette.java

@@ -11,7 +11,7 @@
 /**
  * Represents the palette that map items use.
  * <p>
- * These fields are hee base color ranges. Each entry corresponds to four
+ * These fields are the base color ranges. Each entry corresponds to four
  * colors of varying shades with values entry to entry + 3.
  */
 public final class MapPalette {
@@ -27,7 +27,7 @@ private static double getDistance(@NotNull Color c1, @NotNull Color c2) {
         // All weights are 512x their original to avoid floating point division
         int weightR = 1024 + rsum;
         int weightG = 2048;
-        int weightB = 1024 + (255*2 - rsum);
+        int weightB = 1024 + (255 * 2 - rsum);
 
         // Division by 256 here is unnecessary as this won't change the result of the sort
         return weightR * r * r + weightG * g * g + weightB * b * b;
@@ -460,6 +460,18 @@ public static Color getColor(byte index) {
         return colors[index >= 0 ? index : index + 256];
     }
 
+    /**
+     * Gets the closest {@link Color} in the map palette.
+     *
+     * @param color to match against the map palette
+     * @return the nearest {@link Color} from the map palette
+     */
+    @NotNull
+    public static Color getNearestColor(@NotNull Color color) {
+        byte b = matchColor(color);
+        return getColor(b);
+    }
+
     private static MapColorCache mapColorCache;
 
     /**