Artmatica

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.