It's based on the Aracred & the Metagame bots. The changes made to suit the needs of SourceCred are:

• the addition of 3 handlers : !read !watch !listen.

  • This will enable the bot to provide links to resources for newcomers
  • The links can be edited easily by the community in order to update the links

• the simplification of the handler : "!" instead of "!ac"

• some minor design & typo changes

^^ Click here to deploy!

Interacting with the bot is simple; it offers a command with the ! flag:

• "!help": Shows the available commands

npm run dev will launch the bot locally, with hot reloading included.

There are a few other scripts provided:

• start: Starts up the bot without hot reloading; used for the heroku deployment described below.
• lint: Lints the project with ESLint.
• test: Runs all the tests! (If you contribute some code, please do write tests for it ⌨️!)

For the bot to run properly, it needs these variables, laid out in the .env.sample file:

• DISCORD_API_TOKEN: Your discord API token. See this guide on how to obtain one.
• GITHUB_API_TOKEN: Your github API token. This will tie the bot's contributions to your profile.
• GITHUB_FILE_PATH: The "file path" to the project.json folder, laid out with the format described here.
• GITHUB_ADDRESS_FILE_PATH: The "file path" to the addressbook.json folder, laid out with the format described here.
• WHITELISTED_CHANNELS: The whitelisted channels for the bot to read messages from, in the form of comma separated words, as in bot,general,channel. If you want the bot to listen to all channels, set this variable to *.

You'll need a service to host this bot 💆‍♀️ but do not despair! There's an easy, already configured way of doing this by deploying it to heroku! Just go through these steps:

• Create a new Heroku app and link it to GitHub
• Search for the repo and connect it
• Enable "automatic deploys" for the app
• BONUS: If you want to be able to run this bot 24/7, you can add link your billing info to Heroku, and will give you a 1000 hours for free, enough for a bot instance.

Don't be shy to contribute even the smallest tweak. 🐲 There are still some dragons to be aware of, but we'll be here to help you get started!