jsntm/umatt_discordbot

This is a Discord bot designed for players of Umamusume, a Japanese mobile game about horse-girl racing. Specifically, it helps players who participate in team trials, a competitive mode where you build a team and track scores across multiple rounds. The bot automates a process that players would otherwise handle manually: reading score numbers from in-game screenshots and organizing them into structured data. The core feature is OCR, which stands for optical character recognition, the technology that reads text from images. After a team trial match, a player takes two screenshots of the results screen, one of the top portion and one of the bottom, then sends both to the bot via Discord slash commands. The bot extracts the numerical scores from those images and saves them as CSV files on the host machine. By default it uses OpenAI's vision model for this, but it also falls back to two open-source alternatives, EasyOCR and Tesseract, if no API key is available. Once scores are recorded, the bot offers analysis and editing commands. Players can view a statistical summary of their team, generate a box-and-whisker chart of score distributions, and export their data as CSV files. If the OCR reads a number incorrectly, correction commands let a player replace, add, or delete specific records without starting over from scratch. Data is stored locally in a folder organized by Discord user ID, so multiple players can share the same bot instance without their records mixing. The folder can be copied to preserve data between restarts or when moving the bot to a different machine. Running the bot requires Python, a Discord bot token, and optionally an OpenAI API key for better OCR accuracy. The README's setup instructions are written for Windows, though the underlying Python code is not inherently platform-specific.