Artmatica is a client-side Fabric mod for building Artmap-style pixel art in Minecraft.

Load .oxs pattern files, select a 32x32 tile, and project it as an in-world overlay onto the nearest Artmap canvas.
Artmatica is designed to make large Artmap projects easier by showing exactly which color goes where while you build.

Features
- Client-side overlay for .oxs pixel art patterns
- Config GUI opened with N
- Select pattern files from an in-game list
- Select specific 32x32 tiles from multi-tile patterns
- Live preview for patterns and tiles
- Hover previews in selection menus
- Adjustable overlay opacity
- Single-color focus mode
- Color picker sorted by palette H value
- Shows hovered pixel color name in-game
- Refresh button to rescan .oxs files without restarting
- Open pattern folder button
- Button to open the Artmatica blockmap generator
- Saves selected pattern and tile between sessions
- Optional keybinds available for users who want shortcuts
- Automatically parses larger .oxs files into individual tiles

Installation Instructions:
1: Install Fabric 0.19.1 or newer for Minecraft 1.21.8
2: Place artmatica.jar inside your .minecraft/mods folder

Usage Instructions:
1: Upload an image to the .oxs generation tool (accessible in-game via the config menu)
2: Set your aspect ratio (in canvas size, 1x1=32x32 canvas)
3: Select what parts of the image you would like in the canvas
4: Approve crop
5: Adjust brightness/contrast/saturation/dithering
6: Download your .oxs file
7: Place .oxs inside your .minecraft/config/artmatica folder (accessible in-game via the config menu)
8: Open your config menu in game (default: N)
9: Refresh patterns
10: Select your .oxs pattern and tile (if applicable) and enable overlay

Notes
- Requires Fabric Loader and Fabric API.
- Uses Mojang-mapped Minecraft 1.21.8.
- Client-side only.
- Not compatible with Sodium.