Image to Minecraft Map

A web application that converts images to Minecraft NBT map .dat files, allowing such images to be displayed in Minecraft.

How to Use

Live Application: https://frumple.github.io/image-to-minecraft-map

Wiki: https://github.com/Frumple/image-to-minecraft-map/wiki

Features

• Drag-and-drop multiple image files at once and process them simultaneously.
• Split an image into multiple maps horizontally and vertically, into grid patterns such as 2x2, 3x3, etc.
• Download maps as .dat files, or a .zip file containing the .dat files.
• Supports various color difference algorithms: CompuPhase, Euclidean, DeltaE 1976 and 2000, and CMC 1984.
• Supports Floyd-Steinberg dithering.

Future Improvements

• Support Bedrock Edition.
• Support additional dithering algorithms.

Development Setup

Install all dependencies:

yarn install

Start the development server:

yarn start

Dependencies

• color.js - Calculates color difference.
• nbt-ts - Encodes data to the NBT format.
• pako - Compresses NBT files using gzip.
• jszip - Creates zip files for download.

Credits

This application implements the "CompuPhase" color difference algorithm, provided under the Creative Commons BY-SA 3.0 License.

Sample images used in this README:

• "Rainbow-Lorikeet-1" by "John" at https://www.flickr.com/photos/34534185@N00/9004576204, available under the Creative Commons BY-SA 2.0 License.
• "Rubber Duck in Seoul" by "travel oriented" at https://www.flickr.com/photos/99958070@N02/15348035017, available under the Creative Commons BY-SA 2.0 License.

License

Image to Minecraft Map is licensed under the MIT License.

Image to Minecraft Map is not affiliated in any way with Mojang or Microsoft.