ATLAS is an open-source, AI-powered Discord bot designed to help StarCraft II players analyze their replays and improve their gameplay. As a new developer and StarCraft II player, I wanted to create something that could help others learn and grow in the game.

Click the image to watch the video. (v1.0.0)

• Open-Source: The bot is completely open-source, meaning anyone can download, modify, and host it themselves using their own OpenAI API key.
• Future Plans: If ATLAS gains enough traction, I plan to introduce AI to the hosted version of the bot amongst other features.

• Star the Repo: Show your support by starring the repository!
• Contribute: If you’re a developer, feel free to fork the repo and submit pull requests.
• Donate: Support the project on Patreon to help fund future development.

• Automated Replay Analysis: ATLAS detects new replays and analyzes them in real-time.
• Build Order Breakdown: Get a detailed breakdown of your build order and your opponent's.
• Tactical Insights: Learn what you did well and where you can improve.
• Counter-Strategies: Receive tailored advice on how to counter your opponent's strategy.
• Recommendations: What to do moving forward in to future games.

1. Python 3.8+: Install from python.org.
2. Discord Bot Token: Create a bot on the Discord Developer Portal.
3. OpenAI API Key: Sign up at OpenAI and get an API key.

1. Clone the Repository:

   git clone https://github.com/jaycujoh/atlas-bot-public.git

2. Navigate to the directory:

   cd atlas-bot-public

3. Install Dependencies:

    pip install -r requirements.txt

4. Edit 'settings.py' in the 'config' directory with your credentials:

    DISCORD_BOT_TOKEN = "your-discord-bot-token"
    OPENAI_API_KEY = "your-openai-api-key"
    REPLAYS_FOLDER = "path/to/replays/folder"
    DISCORD_CHANNEL_ID = "your-discord-channel-id"

5. (Optional) Open 'openai_integration.py' in the 'bot' directory and replace the GPT model:

   model="gpt-4o",  # Replace with your model

6. Run the Bot:

    python main.py

For users who prefer a ready-to-use solution without AI functionality, a hosted version of ATLAS is available. This version focuses on replay parsing and build order extraction.

• Replay Upload: Upload a replay file, and the bot will automatically process it.
• Build Order Table: The bot will post a formatted build order table showing time, supply, and units/buildings created.
• No AI Analysis: This version does not include AI-generated insights or recommendations.

1. Invite the bot to your server using this link.
2. Upload a replay file to the designated channel.
3. The bot will post the build order table.

If you find ATLAS helpful, consider supporting its development! Your donations help keep the bot running.

🔗 Support me on Patreon

• Removed RESOURCES Section: Focus on actionable advice without external links.
• Enhanced Data Analysis: Tracks unit production, counts units, validates data, and updates AI prompts.

• Added Build Order Table: Formatted table with grouped units.
• Improved Error Handling: Handles single-player replays and logs unsupported units.
• Enhanced AI Analysis: Detailed prompts and increased max_tokens.

• Re-Adding RESOURCES Section: Web-browsing for tailored recommendations.
• Adding Commands: !analyze, !buildorder, !resources.
• Creating an .exe File: Easier installation for non-coders.
• Add More Metrics: Resource rates, APM, unit losses.
• Support More Replay Types: Team games (2v2, 3v3), custom modes.
• User Customization: Adjust analysis format and detail level.

This project is licensed under the MIT License. See LICENSE for details.

Contributions are welcome! If you have any ideas, bug reports, or feature requests, please join my discord and I will be happy to help! Discord