Overview

Winning Tracker is a Discord bot that follows OwO bot mini-game results and turns them into session statistics. It watches channels for coinflip, blackjack and slots messages, parses both message text and embeds and calculates bets, wins, losses and net profit.

The appeal of the OwO bot is the loop of quick games, but the built-in history is not designed for analysis. Winning Tracker adds the missing ledger: start a session, play, end the session and get a summary that is saved for later.

How tracking works

The bot listens for OwO bot messages in channels where it has permission. It recognises coinflip, blackjack and slots outcomes, extracts the bet and result and updates the current session. Ties, busts, ignored rounds and other edge cases are handled explicitly so the totals stay accurate.

Sessions are started and ended by the user. When a session ends, the bot displays a summary and writes it to MongoDB for long-term analysis. Because the bot only reacts to game messages, it stays out of the way during normal conversation.

Commands

• /initialize - starts a new tracking session in the channel.
• /result - ends the session, displays a summary and saves it to the database.

Setup

The recommended setup is Docker Compose. Create a .env file with your Discord token, then run:

docker-compose up --build -d

For local development, start MongoDB, set DISCORD_TOKEN and MONGO_URI in .env, install the dependencies from requirements.txt and run python bot_track.py.

The bot needs Send Messages, Read Message History and View Channels permissions, plus the applications.commands scope so slash commands register.