HammerBot is a discord bot built for an Age of Empire II streamer's discord server. HammerBot features Age of Empires II specific commands, such as !whichciv <techName> which returns a list of civs that get that specific technology in-game.
Specific features include:
- Team civilization randomizer for 2v2s, 3v3s, and 4v4s that takes into account pocket or flank positions
- Finding out if a civilization has a specific technology or unit
- Returning in-game taunts
- Player rank and match commands with info pulled from the aoe2.net API
- And more!
HammerBot is built with Discord.py, an API wrapper for Discord.
Other packages/libraries used include:
- asyncio
- aiohttp
HammerBot currently has a very simple setup, where all features are split into their own cogs.
<!-- ## Contributing to HammerBot --> <!-- After forking the repository: 1. `git clone` HammerBot, and `cd` into the `HammerBot` directory 2. Make a new file called `.env` and fill in the fields based off the `.env.example` file 3. Get a Discord bot token by going to the [Discord Developers](https://discordapp.com/developers/applications) website (you'll have to login) 4. Create an Application & click `Bot` in the left sidebar 5. Create a bot - the name you put will be seen in the servers 6. Copy the token from this page and hold onto it 7. Click `OAuth2` from the left sidebar 8. Under `Scopes`, check `bot` 9. In `Bot Permissions` select `administrator` under `General Permissions` 10. Copy the link from the `Scopes` section and open it in a new tab 11. Select the server you want to add the bot to 12. Setup venv with `pip3 install virtualenv` (mac/linux) or `py -m pip install --user virtualenv` (windows) 13. Then run `virtualenv venv` (mac/linux) or `py -m venv venv` (windows) 14. Enter the virtual environment with `source venv/bin/activate` (mac/linux) or `.\venv\Scripts\activate` (windows) 15. Then let pip get the latest libraries with `pip3 install -r requirements.txt` (mac/linux) or `py -m pip install -r requirements` (windows) 16. Then test run your HammerBot with `python3 -m hammerbot.py` (mac/linux) or `py -m hammerbot.py` (windows) in the main directory 17. The bot should show up in your server and respond to commands such as `!11` --> <!-- 3. Use [poetry](https://python-poetry.org) to install the necessary dependencies with `poetry install` 4. Run HammerBot with either `poetry run python3 hammerbot.py` (mac/linux) or `poetry run py hammerbot.py` (windows) -->