Loominary

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

🎨 Open the web editor → · 📖 Read the wiki → · ⬇ Releases

Loominary is a client-side Fabric mod (Minecraft 1.21.4) paired with a browser-based editor. You design and encode your art in the web editor, place a carpet schematic in-game, and scan it with a map. Everyone running Loominary then sees your image painted on that map, while players without the mod just see an ordinary map of some carpet. There is no server plugin and nothing to install server-side; the data travels inside vanilla mechanics (carpet colors and banner names).

Highlights

• Any image in: PNG, JPEG, WebP, GIF, or BMP, with perceptual OKLab color matching and optional dithering
• Animated map art: GIFs become AV1-encoded animations that play back on maps, frame-synced between viewers
• Murals: split one image across an N×M wall of maps, with seamless dithering and automatic byte-budget balancing
• Autonomous building: /loominary walk print walks your player along the platform and places every carpet
• Encrypted art: AES-256-GCM password protection with multiple key slots
• Shareable: export files anyone can rebuild from, or archive art straight out of the world

Getting started

1. Drop the release jar and Fabric API into mods/ (full install guide)
2. Follow the Quick Start to make your first map art in about ten minutes

The wiki covers the rest: the web editor, placement, animation, murals, encryption, and a full command reference.

Credits & license

Built with zstd-jni, Chicory, and libaom. Vibe-coded almost entirely by Claude.

MIT