March7thAssistant

March7thAssistant is a Python tool that automates repetitive daily and weekly tasks in the game Honkai: Star Rail. The README is written in Chinese. The name comes from March 7th, a character in the game. The tool is designed for players who find it tedious to log in every day to complete routine in-game chores.

The daily tasks it handles include spending the game's stamina currency, completing training missions, collecting login rewards, running delegation assignments, and fighting in the Forgotten Hall. Weekly tasks include Echo of War battles, the Cosmoverse mode, and other recurring game modes. After finishing everything, the tool can play a sound to notify the user, then automatically close the game or even shut down the computer.

The tool watches for when tasks become available again (either on a daily reset schedule or when the in-game stamina meter refills to a set value) and starts itself automatically. It also supports sending notification messages to the user's phone or messaging app when tasks finish. For players who want to run it unattended, it supports background operation without a visible game window and can also run inside Docker.

Under the hood, the tool works by taking screenshots and using image recognition libraries (OpenCV, PyAutoGUI) along with optical character recognition to read what is on screen and click the right things. It includes a small utility panel for features like auto-advancing dialogue, unlocking the frame rate cap, and redeeming gift codes. Gacha pull history can be exported in the UIGF and SRGF standard formats, which are community-defined data formats for this purpose.

Installation is available as a Windows executable for non-technical users, or from source using Python 3.12 and pip for those who prefer that approach.