JayJokerr/arknights-pixel-autofill

What it solves

It automates the tedious process of creating 24x24 pixel art within the game Arknights. Instead of manually selecting colors and clicking each grid cell, this tool converts images into the game's specific 40-color palette and automatically fills the in-game canvas.

How it works

• Image Conversion: The tool imports standard images, 24x24 bitmaps, or official share cards. It uses resampling algorithms (Lanczos, BOX, Bicubic, Nearest) and color matching (RGB or OKLab) to map the image to the game's 40-color palette.
• Image Enhancement: It includes features to reduce transition colors (limiting to 16 colors) and a "structure enhancement/de-shadowing" slider to improve clarity in photographic materials.
• Visual Recognition: The software dynamically identifies the game's 24x24 canvas and the 40-color palette on the screen using computer vision, ensuring it works across different resolutions and UI scales (90%-100%).
• Automation: Once the canvas is located, the tool simulates mouse clicks to select the correct colors from the palette and fill the corresponding cells on the game canvas.

Who it’s for

Players of Arknights on Windows (PC official client or MuMu emulator) who want to create custom pixel art without manual labor.

Highlights

• Dynamic Canvas Detection: Uses dual visual detectors to find the grid and palette, removing reliance on fixed coordinates.
• Flexible Import: Supports standard images, direct 24x24 PNG imports, and automatic recovery of art from official share cards (avoiding UID watermarks).
• Responsive UI: Built with PySide6/Qt 6 to support various DPIs and window sizes.
• Safety Controls: Includes an emergency stop key (F8) and restricts mouse movement to the game's client area to prevent erratic behavior.