Image2Map Mod FAQ

Run /image2map preview to see how your image will look before committing anything. Once you're happy with the result, use /image2map create to turn it into an actual map item.

You provide the image as a URL, so any image the game can fetch from that link works. Direct image links (ending in a file extension) are the most reliable; image-hosting pages that wrap the image in HTML usually won't work.

The most common causes are a broken or indirect URL, an image that's too large to fetch, or a server that blocks the request. Try a direct link to a smaller image first, then scale up once it works.

One map holds a single 128x128 pixel tile, so anything bigger gets split across multiple maps. Use /image2map create to specify the full pixel dimensions, and the mod will divide it into the right number of map tiles.

Create the image at the full width and height you want, then place each resulting map into item frames in the same grid layout the mod generated. Keep the frames adjacent and in order, or the picture will look scrambled.

Dither mixes pixels to fake extra colors and gradients, which helps photos and smooth shading look better. No dither keeps flat, solid colors crisp, which suits logos, pixel art, and simple graphics.

While in preview mode, run /dither to switch between the two modes and see the result update. Once it looks right, save it as a map item.

Yes, the maps are vanilla-compatible, so anyone on the server can view them normally. They just need the map item itself; they don't need the mod installed to see the image.

The maps render as standard vanilla maps, so players without the mod can still see them. The command itself is what generates the map, so whoever runs it needs the mod available.

Very large images mean many map tiles, which can add up in item frames and map data. Start with a modest size, check performance, and only scale up if things stay smooth.