Repository files navigation

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-gametaunts
• Player rank and match commands with info pulled from theaoe2.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.

If a bug or any unintended behavior is discovered, please report it by creating an issuehere.

If you'd like to contribute code to HammerBot, please:

1. Follow the setup guidelines & fork the repository
2. Make any contributions in your fork
3. Create apull request

Your pull request will then be reviewed. Please read theContributing Guidelines before creating your first pull request.

1. Get a Discord bot token by going to theDiscord Developers website (you'll have to login)
2. Create an Application & clickBot in the left sidebar
3. Create a bot - the name you put will be seen in the servers
4. Copy the token from this page and hold onto it

5. ClickOAuth2 from the left sidebar
6. UnderScopes, checkbot
7. InBot Permissions selectadministrator underGeneral Permissions
8. Copy the link from theScopes section and open it in a new tab
9. Select the server you want to add the bot to

10. Fork this repository
11. git clone HammerBot, andcd into theHammerBot directory
12. Make a new file called.env and fill in the fields based off the.env.example file

13. Setup venv withpip3 install virtualenv (mac/linux) orpy -m pip install --user virtualenv (windows)
14. Then runvirtualenv venv (mac/linux) orpy -m venv venv (windows)
15. Enter the virtual environment withsource venv/bin/activate (mac/linux) or.\venv\Scripts\activate (windows)
16. Then let pip get the latest libraries withpip3 install -r requirements.txt (mac/linux) orpy -m pip install -r requirements (windows)
17. Then test run your HammerBot withpython3 -m hammerbot.py (mac/linux) orpy -m hammerbot.py (windows) in the main directory
18. The bot should show up in your server and respond to commands such as11