Settings
| Minecraft Version | Minimum Snapshot | Base Colors* | Map Colors* |
|---|---|---|---|
| Java 1.8.1 to 1.11 | 1.8.1-pre1 | 35 | 140 |
| Java 1.12 to 1.15 | 17w17a | 51 | 204 |
| Java 1.16 | 1.16-pre6 | 58 | 232 |
| Java 1.17 to 1.19 | 21w16a | 61 | 244 |
* Excluding transparent colors
Map items in Minecraft only support a limited palette of map colors, with more colors being added in recent versions. This palette is constructed from a number of base colors. Each base color is associated with 4 map colors, with each map color being a certain shade of the base color. For more details, see this article on the map file format.
In general, you should select the Minecraft version setting that matches the version that you would like to upload the map file to. Selecting an older or newer version than the one you are targetting is not guaranteed to work due to unsupported colors, or changes to the map file format between versions.
This step processes and resizes the source image to within the 128 by 128 pixel dimensions of a Minecraft map item.
| Resize to... | Description | If the width and height are unequal: |
|---|---|---|
| Fit | Resizes the image to fit within the map size while retaining the image's aspect ratio. | There will be excess space on the top/bottom or sides of the image that will be filled in by the color set in the Background setting. |
| Fill (Crop) | Resizes the image to fill the entirety of the map size while retaining the image's aspect ratio. | The top/bottom or sides of the image will be cropped out. |
| Stretch | Resizes the image to stretch across the entirety of the map size without retaining the image's aspect ratio. | The smaller dimension is stretched until it is equal to the larger dimension. |
Sets the amount of image smoothing when resizing the source image.
| Resize Quality | Description |
|---|---|
| None (Pixelated) | No smoothing. Best used for pixel art. |
| Low | Low amount of smoothing. |
| Medium | Medium amount of smoothing. |
| High | High amount of smoothing. Best used for most other images. |
Sets the background color of the intermediate image.
| Background |
|---|
| Transparent |
| Black |
| White |
This step takes the 16,777,216 (2563) possible colors in an image and reduces them to the 244 (or less) map colors.
For every pixel in the image, we need to find the map color nearest to the pixel's color. There are many different algorithms for calculating the nearest color that involve complicated mathematics and color spaces, but for our purposes the main points to keep in mind are:
- When in doubt, just use the "CompuPhase" algorithm, as it should be good enough for most images.
- Algorithms using the sRGB color space are faster, but sRGB is not perceptually uniform. This means that while a map color may be considered the "nearest" mathematically using numerical RGB values, it may not appear to be the "nearest" when perceived by the human eye.
- DeltaE algorithms attempt to address this by comparing the colors in the CIELAB color space, which has better (though not perfect) perceptual uniformity. These algorithms are slower, but are more likely to produce perceivably accurate results.
| Color Difference Algorithm | Color Space | Speed | Accuracy | Description |
|---|---|---|---|---|
| CompuPhase | sRGB | Fastest | Good | A "low-cost approximation" algorithm that produces reasonable results. Should be good enough for most images. |
| Euclidean | sRGB | Fast | Poor | Most likely to choose "incorrect" nearest colors due to sRGB not being perceptually uniform. |
| DeltaE 1976 | CIELAB | Moderate | Good | Equivalent to the Euclidean algorithm, but in the CIELAB color space. |
| CMC 1984 | CIELAB | Slow | Depends | A unique algorithm made by the Color Measurement Committee of the Society of Dyes and Colourists. Intended for use with textiles. |
| DeltaE 2000 | CIELAB | Slowest | Best | The most complicated but most accurate DeltaE algorithm. |
Dithering adds a form of noise that helps eliminate color banding and makes images appear smoother overall.
| Dithering Algorithm | Description |
|---|---|
| None | No dithering applied. Best for images with flat, solid colors. |
| Floyd-Steinberg | One of the first and most popular image dithering algorithms. Best for most other images. |
Any image pixels that have a transparency (alpha) value less than this threshold will appear as fully transparent in the map file.
If checked, the map file will be automatically downloaded after processing is complete.
Image posted by ThePuzzlemaker at https://minecraft.fandom.com/wiki/Map_item_format?file=Map_colors.png, available under the Creative Commons BY-NC-SA 3.0 license.
