Artmatica

## 1.2.0 — 2026-08-03

### Added

- Added automatic in-game color picking.

  - Target a pixel on the overlay and use the **Pick Targeted Color** keybind to select its corresponding Minecraft item.

  - Item IDs are read from the palette entry's `.oxs` `misc1` field.

  - Artmatica will automatically navigate through multiple ArtMap color pages to find the picked color.

  - After searching, Artmatica returns the ArtMap color inventory to page 1.

  - Selection stops safely if the server inventory does not update within 100 ticks.

- Added support for the `.oxs` `printcolor` field.

  - In single-color mode, non-target pixels now use the selected palette color's `printcolor`.

  - Patterns without `printcolor` retain the previous opposite-color fallback.

- Hovered overlay pixels now display both the palette ID and color name as `[id] [ColorName]`.

- Added a scrollable **Pattern Errors** screen that shows rejected `.oxs` filenames and their validation errors.

- Overlay opacity is now saved between sessions.

### Fixed

- The color-selection screen now lists only colors present in the currently selected 32×32 tile instead of every color in the complete pattern.

- Changing tiles now clears the previous color selection, preventing the same list index from selecting an unrelated color on another tile.

- Palette entries with identical RGB values now retain their separate IDs, names, item mappings, and `printcolor` values.

- A malformed `.oxs` file no longer prevents other valid patterns from loading.

### Improved

- Pattern files are now loaded in predictable alphabetical order.

- Pattern refreshes report how many files loaded successfully and how many were rejected.

- `.oxs` validation now provides clear errors for invalid dimensions, colors, item IDs, palette references, and stitch coordinates.

- Unsafe XML features, including external entities and DTDs, are disabled.

- Wall-sign discovery no longer scans the full nearby area every rendered frame.

  - Artmatica caches and validates the active canvas.

  - Full searches now occur only when necessary.

  - The overlay remains anchored to the same valid canvas instead of jumping between nearby signs.

- ArtMap page navigation now waits for an actual inventory-content update instead of relying on a fixed delay.

- Disconnecting safely cancels an active automatic color-selection operation.

- Configuration screens and player-facing messages are now localization-ready.

### Compatibility Notes

- Pattern dimensions must be positive multiples of 32.

- Older `.oxs` patterns without `printcolor` or `misc1` remain supported, but the corresponding newer features use fallback behavior or are unavailable.

- Minecraft 1.21.8, Fabric Loader 0.19.1 or newer, Fabric API, and Java 21 are required.

- Artmatica remains client-side only.

- Sodium remains unsupported.