<div align="center">
</div>
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!
<!-- ## Python Packages & Software -->
HammerBot is built with Discord.py, an API wrapper for Discord.
Other packages/libraries used include:
<!-- ## 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) -->