{"id":130401,"date":"2026-06-07T19:22:04","date_gmt":"2026-06-07T16:22:04","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/recolorfulmap\/"},"modified":"2026-06-07T19:22:04","modified_gmt":"2026-06-07T16:22:04","slug":"recolorfulmap","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/recolorfulmap\/","title":{"rendered":"ReColorfulMap"},"content":{"rendered":"
\n

# ReColorfulMap<\/p>\n

\"\"<\/p>\n

![GitHub Repository](https:\/\/github.com\/ColdeZhang\/ReColorfulMap)
\n![bStats](https:\/\/bstats.org\/plugin\/bukkit\/ColorfulMap\/21443)
\n![Latest Build](https:\/\/github.com\/ColdeZhang\/ReColorfulMap\/releases\/latest)<\/p>\n<\/div>\n

## Description<\/p>\n

ReColorfulMap is a plugin that converts images into image maps, which can be hung on item frames to add decoration.<\/p>\n

This is a remake of the original ColorfulMap plugin. The original plugin leaves a lot of images cache in plugins folder,
\nand need to reload them every time the server starts. Which also increases the server startup time and management
\ndifficulty.<\/p>\n

Both ColorfulMap and ReColorfulMap’s idea are from ImageFrame
\nand ImageMaps.
\nYou can think it is a simplified version of ImageFrame and a high version remake of ImageMaps. Thanks for their great
\nwork.<\/p>\n

## Features<\/p>\n

– Convert images into image maps;
\n– Image scaling;
\n– Automatic placement to item frame matrix;
\n– Support for consuming money to generate map paintings (requires Vault dependency);
\n– Automatic get back maps from item matrix **(new feature)**;<\/p>\n

## Version Support<\/p>\n

– 1.20.1+ (Paper\u3001Folia)<\/p>\n

## Usage<\/p>\n

1. First, you need to upload the image you want to convert to the image bed,
\n so that this plugin can read the image content from the network. After uploading,
\n you will get an url of the image, copy this address.<\/p>\n

2. In the game, enter the command: `\/tomap ` to get a map:<\/p>\n

![](https:\/\/github.com\/ColdeZhang\/ReColorfulMap\/blob\/master\/images\/01.png?raw=true)<\/p>\n

Because one map can only hold an image at the most of 128 x 128 pixels, so ReColorfulMap will split your image into
\n tiles automatically.
\n Don’t worry about handling the tiles, ReColorfulMap will tell you how many item frames you need to place this image
\n maps
\n and place them in the correct order automatically too.<\/p>\n

For this image shown above, it shows 8 x 13, which means you prepare a matrix of item frames 8 in width and 13 in
\n height to place this image.<\/p>\n

3. Place the map in the **bottom-left corner** of the item frame matrix, then the corresponding maps will be placed in
\n the remaining item frames on the wall automatically.<\/p>\n

![](https:\/\/github.com\/ColdeZhang\/ReColorfulMap\/blob\/master\/images\/02.png?raw=true)<\/p>\n

4. If the image is too large or too small, you can try to add a scaling parameter after the command,
\n for example, `\/tomap 0.3` means rendering at 30% of the original size.
\n If you want to fill the image without leaving any white space at the edges of all the maps,
\n you need to ensure that the resolution of your image is a multiple of **128**.<\/p>\n

![](https:\/\/github.com\/ColdeZhang\/ReColorfulMap\/blob\/master\/images\/03.png?raw=true)<\/p>\n

## For Server Owners<\/p>\n

### Commands & Permissions<\/p>\n

> The angle brackets `<>` in the following commands indicate required parameters, and the square brackets `[]` indicate
\n> optional parameters.<\/p>\n

| Function | Command | Permission Node | Default |
\n|————-|———————————|———————|———|
\n| Generate | `\/tomap [scalling]` | recolorfulmap.tomap | true |
\n| Reload | `\/reloadColorfulMap` | recolorfulmap.admin | op |
\n| Clean Cache | `\/cleanColorfulMap` | recolorfulmap.admin | op |<\/p>\n

NOTICE: Don’t run `\/cleanColorfulMap` frequently, it will delete all the images generated but not placed.<\/p>\n

### Configuration Reference<\/p>\n

“`yaml
\n# Do not modify this value.
\nversion: 2
\n# The maximum size of item frame matrix.
\n# 32 x 18 means image can not be larger than 4096 x 2304 pixels.
\n# Don’t set this value too large, it may cause lag.
\nmax-frame-x: 32
\nmax-frame-y: 18
\n# Language of the plugin, see others in the plugins\/FurnitureCore\/languages folder.
\nlanguage: en_us
\n# Enable economy system. (Require Vault and an economy plugin)
\n# If true, players need to pay for each map they create.
\n# This may prevent players from abusing usage of the plugin.
\neconomy:
\n enable: false
\n cost-per-map: 100.0
\n# The whitelist of image url address, use this to prevent players from using inappropriate images.
\n# Leave it empty to allow all addresses.
\naddress-white-list:
\n – ”
\n# Debug mode, if report bugs turn this on.
\ndebug: true
\n“`<\/p>\n

## Support<\/p>\n

Mail: [zhangyuheng@lunadeer.cn](mailto:zhangyuheng@lunadeer.cn)<\/p>\n

GitHub: Issues<\/p>\n

QQ\u7fa4\uff1a309428300<\/p>\n

## bStats<\/p>\n

![bstats](https:\/\/bstats.org\/signatures\/bukkit\/ColorfulMap.svg)<\/p>\n","protected":false},"excerpt":{"rendered":"

ReColorfulMap is a plugin that converts images into image maps, which can be hung on item frames to add decoration.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"recolorfulmap","_minecraft_project_id":"OSGNJlhi","_minecraft_author":"zhangyuheng","_minecraft_license":"MIT","_minecraft_downloads":449,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"recolorfulmap.zip","_minecraft_size_bytes":1489209,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T10:47:16.387223Z","_minecraft_date_created":"2025-01-11T01:20:01.561258Z","_minecraft_date_modified":"2025-09-22T15:47:26.382706Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/recolorfulmap","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-07T16:22:05+00:00","_minecraft_import_hash":"7d1c8e55dbfab857c62bb7b11ceb2cb1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,156,125,127,128,129],"mod_loader":[130,131,132,133,134],"minecraft_version":[36,60,93,94,101,102,62,37],"class_list":["post-130401","mod","type-mod","status-publish","hentry","mod_category-bukkit","mod_category-decoration","mod_category-folia","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1"],"yoast_head":"\nReColorfulMap - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/recolorfulmap\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"ReColorfulMap - Minecraft\" \/>\n<meta property=\"og:description\" content=\"ReColorfulMap is a plugin that converts images into image maps, which can be hung on item frames to add decoration.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/recolorfulmap\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta property=\"og:image\" content=\"https:\/\/ssl.lunadeer.cn:14437\/i\/2024\/02\/21\/65d5e0d10b7d5.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/recolorfulmap\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/recolorfulmap\\\/\",\"name\":\"ReColorfulMap - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/recolorfulmap\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/recolorfulmap\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/ssl.lunadeer.cn:14437\\\/i\\\/2024\\\/02\\\/21\\\/65d5e0d10b7d5.png\",\"datePublished\":\"2026-06-07T16:22:04+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/recolorfulmap\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/recolorfulmap\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/recolorfulmap\\\/#primaryimage\",\"url\":\"https:\\\/\\\/ssl.lunadeer.cn:14437\\\/i\\\/2024\\\/02\\\/21\\\/65d5e0d10b7d5.png\",\"contentUrl\":\"https:\\\/\\\/ssl.lunadeer.cn:14437\\\/i\\\/2024\\\/02\\\/21\\\/65d5e0d10b7d5.png\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/recolorfulmap\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"ReColorfulMap\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"ReColorfulMap - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/recolorfulmap\/","og_locale":"en_US","og_type":"article","og_title":"ReColorfulMap - Minecraft","og_description":"ReColorfulMap is a plugin that converts images into image maps, which can be hung on item frames to add decoration.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/recolorfulmap\/","og_site_name":"Minecraft","og_image":[{"url":"https:\/\/ssl.lunadeer.cn:14437\/i\/2024\/02\/21\/65d5e0d10b7d5.png","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/recolorfulmap\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/recolorfulmap\/","name":"ReColorfulMap - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/recolorfulmap\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/recolorfulmap\/#primaryimage"},"thumbnailUrl":"https:\/\/ssl.lunadeer.cn:14437\/i\/2024\/02\/21\/65d5e0d10b7d5.png","datePublished":"2026-06-07T16:22:04+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/recolorfulmap\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/recolorfulmap\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/recolorfulmap\/#primaryimage","url":"https:\/\/ssl.lunadeer.cn:14437\/i\/2024\/02\/21\/65d5e0d10b7d5.png","contentUrl":"https:\/\/ssl.lunadeer.cn:14437\/i\/2024\/02\/21\/65d5e0d10b7d5.png"},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/recolorfulmap\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"ReColorfulMap"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/130401","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=130401"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=130401"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=130401"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=130401"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}