A Discord bot made in honor of Mr. Widmark.
Main dependencies:
- Python 3.9
- Pipenv - used to manage misc. dependencies and run the bot
- Pycord - a discord.py fork for interacting with the Discord API
- Async PRAW - interacting with the Reddit API
- Web3py - interacting with the blockchain
- Discord bot hosting service
wid-bot comes with a variety of amazing and fun commands to use, including, but not limited to...
| Command | Description |
|---|---|
/csstats |
Retrieve a user's Counter Strike stats |
/wordle |
Play a game of Wordle |
/aita |
Guess whether a Redditor is TA or not (very hard) |
/mint |
Mint an NFT on the Widcoin blockchain |
Please read CONTRIBUTING.md for information on how to contribute.
Note: wid-bot is intended for small private server use only because it uses the "message content" privileged intent. It will not work as a larger bot (100+ servers) without modification.
- Create your own Discord Application. Make a Reddit API account as well.
For the NFT functionality, a Moralis API key and Infura gateway token for the Ropsten testnet are required to access the blockchain. Furthermore, the NFT functionality uses real (test) Ethereum, so a Metamask (or similar) wallet with Ropsten Ethereum is required.
Access to the original ("OG") wid-bot application is restricted to members of Widmark Clan only.
Make a Discord bot account for the application then add it to your server.
- Enable the "Message content intent"
- Scopes:
applications.commandsandbot - Recommended permissions integer:
415038303296
Keep the Discord bot token and Reddit secret/ID handy.
- Set up the code environment.
git clone this repository, and make sure you have followed the instructions above. Pipenv will take care of the dependencies.
Run the following commands inside the base directory of the project, which will store your keys in a hidden file named .env. This is where sensitive information like the bot token and API keys will go. Replace the values below with your own personal values.
$ echo TOKEN=qwertyuiop >> .env
$ echo GUILD_ID=12345678 >> .env
$ echo REDDIT_SECRET=asdfghjkl >> .env
$ echo REDDIT_ID=zxcvbnm >> .env
$ echo INFURA_GATEWAY=ROPSTEN_GATEWAY_TOKEN >> .env
$ echo MORALIS_KEY=MORALIS_API_KEY >> .env
$ echo WID_ADDR=WALLET_PUBLIC_KEY >> .env
$ echo PRIVATE_KEY=WALLET_PRIVATE_KEY >> .env
These values are read and set up in config.py. You can put them directly in the file instead, but make sure that those keys are never shared publicly because they can and will be stolen.
Install chromedriver 97.0.4692.71 for asynchronous headless browsing with arsenic. Either put the binary on PATH or in the base project directory. You may also need to install Google Chrome itself.
Finally, install the dependencies outlined in Pipfile and Pipfile.lock.
$ pipenv sync
- Host and run the bot.
Use some hosting service to host the code of your bot. There's plenty of options out there. If you followed the steps above, wid-bot should be able to run right away.
$ pipenv run python3 bot.py
If everything works as it should, it should show something like this:
Loading .env environment variables…
wid is loading...
loading extension.[filename]... done (for all files in extension folder)
wid is ready!
and the bot should be online. Woo!