AutoPalette (Client-Side)

Tired of sitting at an easel for hours, clicking pixel-by-pixel with dyes, just to paint a custom image in Minecraft?

AutoPalette is a lightweight, client-side Fabric mod for Minecraft 1.21.8 that automates painting custom images on server-side ArtMap (or DFArt) easels. Simply select your image, check the automatically generated shopping list of dyes, sit down, and let the mod paint for you!

Features

Intuitive In-Game GUI: Press H (customizable) to open a control dashboard inside the game. Browse local images, tweak settings, and watch your image preview change in real-time.
Quantization and Dithering: Choose between direct nearest-color matching or high-fidelity Floyd-Steinberg dithering to make pictures look incredibly crisp on the map.
Max Colors Palette Limiter: Restrict your image's palette to the top Unlimited, 32, 16, or 8 most frequent colors. The GUI preview re-renders instantly to reflect your choice.
In-Game Shopping List: The Materials tab calculates exactly how many dyes, coal, and feathers you need. It even renders live 16x16 Minecraft item icons next to each entry.
Smart Pixel Skipping: The mod reads the canvas state before drawing and automatically skips painting any pixels that already match your image, saving you massive amounts of dye and drawing time.
Coal and Charcoal Interchangeability: The mod intelligently treats coal and charcoal interchangeably for shading and base black steps, utilizing whatever is available in your inventory.
Pixel-Perfect Alignment: Utilizes pre-serialized lookups (east.ser, west.ser, etc.) and a vanilla MapColor database (mappings.json) to guarantee 100% boundary alignment and color accuracy on the canvas.

How to Use

Import Images: Put your image files (PNG or JPG) into the .minecraft/config/autopalette/images/ directory.
Open the GUI: Sit on an ArtMap easel with a canvas, and press H to open the panel.
Set Up: Select your image, toggle dithering, set your drawing delay, and choose your color limit.

GUI in game

Collect Dyes: Click the Materials tab to check your shopping list, and gather the required items in your inventory.

Material List GUI

Draw: Click Start Drawing! The mod will automatically swap tools/dyes into your hotbar, turn your camera, and paint the canvas.

Dependencies and Compatibility

Platform: Fabric
Minecraft Version: 1.21.8 (supports minor releases 1.21.9 through 1.21.11 out of the box).
Dependencies: Fabric Loader and Fabric API only. No other mods required!
Server Compatibility: Works on any server running the ArtMap or DFArt Bukkit/Spigot plugins.

Disclaimer: This is a client-side utility mod. Please check your server's rules before using automated gameplay elements.

Artmap AutoPalette