Details

MapArt - Minecraft Map Art Plugin

Name: MapArt
Author: DreamArk Studio

A map art plugin for Purpur/Paper servers that allows players to convert custom images into in-game map paintings.

Features

Supports PNG, JPG, GIF, BMP image formats
Auto-scales and crops images to fit map dimensions
Large images automatically split into multiple maps
Async processing, no server lag
Folia architecture support

Installation

Place MapArt-1.0.0.jar into your server's plugins directory
Restart the server
Place images into plugins/MapArt/images/ directory

Usage

Command	Description
`/mapart apply <image file>`	Convert an image to map art
`/mapart clear`	Clear all map art
`/mapart info`	View number of maps you hold
`/mapart list`	List available image files

Example:

/mapart apply myimage.png

Recommended Image Size

Standard Single Map

Recommended size: 128x128 pixels
Exactly matches one map's 128x128 pixel display area, one-to-one pixel mapping with no scaling distortion

Size Comparison

Image Size	Map Count	Description
128x128	1 map	Recommended, pixel-perfect mapping
256x256	1 map	Auto-scaled down to 128x128
512x512	1 map	Auto-scaled down to 128x128
1024x1024	1 map	Auto-scaled down to 128x128
2048x2048	1 map	Auto-scaled down to 128x128
256x128	2 maps	Horizontal split, auto-divided
512x256	8 maps	4x2 map grid

Important Notes

Minecraft maps only have a 128x128 pixel display area
Using a 128x128 image gives you precise pixel-by-pixel control, WYSIWYG
Images larger than 128x128 are automatically split into multiple maps
Images smaller than 128x128 are auto-scaled to fill

Color Limitations

Minecraft maps only have 128 available colors
Use images with high color contrast for best results
Avoid images with excessive gradients
Pixel art style images work best

Configuration

plugins/MapArt/config.yml:

# Maximum image width (pixels)
max-image-width: 2048

# Maximum image height (pixels)
max-image-height: 2048

# Map size (pixels), standard map is 128x128
map-size: 128

# Enable async processing
async-processing: true

# Maximum concurrent tasks
max-concurrent-tasks: 4

Permissions

Permission	Description	Default
`mapart.use`	Use map art commands	OP
`mapart.admin`	Admin permissions	OP

Building

mvn clean package

Build output is located at target/MapArt-1.0.0.jar

Dependencies

Purpur 1.21+ or Paper 1.21+
Java 21+

Telemetry

This plugin collects anonymous usage data to help improve the project. A unique UUID is generated on first launch and stored in DreamArk/server-uuid.txt. Heartbeat data is sent every 60 seconds to our telemetry server. No personal or server content data is collected.

By using this plugin, you agree to our Privacy Policy and Terms of Service.

Credits

Developed by DreamArk Studio

MapArt