Home

Loominary

Turn any image — even an animated GIF — into Minecraft map art that works on any vanilla server.

Loominary is a client-side Fabric mod paired with a browser-based editor. You design and encode your art in the web editor (nothing to install), then the mod renders it in-game as custom map art. No server plugin, no resource pack, no permissions — the data travels inside vanilla game mechanics: colored carpet blocks and named banners.

How it works, in one paragraph

The web editor quantizes your image to Minecraft's map palette, compresses it, and packs the bytes into things a vanilla server happily stores: the colors of a carpet platform (read back through the map itself) and the names of a few banners (registered on the map as markers). Anyone running Loominary who comes within range of your framed map sees the full image — photographs, pixel art, even animations — painted client-side. Everyone else just sees an ordinary map.

What can it do?

• Any image in, map art out — PNG, JPEG, WebP, GIF, BMP; perceptual OKLab color matching and adaptive dithering make the palette stretch surprisingly far
• Animated map art — GIFs become AV1-encoded animations that play back on the map, frame-synced across multi-tile walls
• Giant murals — split one image across an N×M wall of maps, with seamless dithering and automatic byte-budget balancing between tiles (mux)
• Fully autonomous building — /loominary walk print walks your player along the platform and places every carpet for you
• Encrypted art — lock your art with passwords (AES-256-GCM); other players need both the mod and the password
• Archiving — capture any existing framed map art into your own collection
• Shareable — hand your exported files to anyone; their mod renders your art identically

Where to start

1. Installation — the mod, Fabric, and the optional printing setup (5 minutes)
2. Quick Start — your first map art, from image file to framed map (10 minutes)
3. The web editor — the full three-step editor tour

Questions? Check the Troubleshooting & FAQ page or open an issue.

Fun fact: Loominary started life as "Banner Mod" — the original version squeezed entire images into nothing but banner names. That mode still exists and requires no building at all, but the carpet channel carries ~3× the data, so it's now the default.