Skip to content

jpeterik12/image-map

 
 

Repository files navigation

Image Map

This is a simple Windows application that converts images to Minecraft maps using the latest colors. It works for both Java Edition and Bedrock Edition (also known as the inferior Windows 10 version).

How to Use

Firstly: download, unzip, and run the application. Click the button that corresponds to the edition you're using, or drag the world folder right onto the form.

Existing Maps

This tab shows maps that are currently in your world. Click on a map to select it, and again to deselect. Right-click to open the options menu:

If your world has tons of maps, not all of them are loaded at once, for performance reasons. You can press these buttons to continue loading in maps, if you wish to preview them:
 
Note that even if some maps aren't loaded, the app will still detect and warn about transfer conflicts if you try to change the ID of a map to one that's already taken.

Import Maps

This tab shows maps that you want to import into your world. Click Open to browse for images to convert into maps, or drag files right onto the form. You can also use CTRL-V to paste if there is image data on your clipboard, such as a screenshot.

You'll be able to control a few settings about your imported images:


 
Press this to rotate the image by 90 degrees clockwise.


If your image isn't exactly 128x128 pixels, it needs to be resized.
  Use this scaling (nearest neighbor) to keep pixels looking sharp.
 
  Use this scaling to keep lines looking smooth.


 
You can split your image into a grid of multiple maps, to put into item frames.
 
Check to fill the entire space with your image. Leave it unchecked to maintain your aspect ratio.


Java Edition has a limited color palette for maps, so there are a few options to help your images look accurate. I use the Good Fast Algorithm with dithering most of the time, but feel free to try other algorithms to look for a better result. Dithering improves color accuracy, but introduces noise.

 
 
 
 

 
 
 
 


Large item frames and slow algorithms may take some time to process. Maps that are still loading will appear with this icon:

You can hover over any map to see the original image. Click on a map to select it, and again to deselect. Right-click to open the options menu:

You can also send all of your maps to the world at once with this button:

If is checked, a chest will be added to your singleplayer inventory containing all the maps you sent. Ensure your world isn't open in Minecraft, or this won't work!

Version Palettes

This program supports all of the map color palettes Java Minecraft has had throughout its history, up to the most recent changes in 1.17. Note that Bedrock Minecraft supports full RGB for its maps, so there is no limited palette. Here are all the supported palettes:

Beta 1.8+
 
13w42a
 
13w43a (1.7)+
 
1.8.1-pre1+
 
17w17a (1.12)+
 
1.16 pre-6+
 
21w15a
 
21w16a (1.17)+
 

About

Converts image to maps for Minecraft Java and Bedrock. Download: https://github.com/tryashtar/image-map/releases

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 100.0%