Skip to content

Fun with friends Discord Bot capable of running on a self hosted server (e.g. raspberry pi). See README for full list of bot capabilities!

License

Notifications You must be signed in to change notification settings

bthomas2622/freeBrunch-discord-bot

Repository files navigation

freeBrunch's Discord Bot

A simply fun Discord bot for your Discord server.

Bot Commands

  • /help -> List bot commands
  • /apex-not-my-main -> "Not My Main", generates a random Apex Legends champion
  • /pick-one-> Input a comma separated list of options and pick one randomly
  • /coin-flip -> Flip a coin
  • /d6 -> Roll a d6
  • /d20 -> Roll a d20
  • /d-num -> Roll a die with input number of sides
  • /get-rankings -> Get various game rankings of server members
  • /get-game-info -> Get your information about a game from the RAWG API

Bot Scheduled Messages

  • Post weekly free Epic Games Store games every Thursday to #general channel. Logic in bot-scripts/epic-free-games.
  • Each morning check for server members who ranked up and post to #general channel. Logic in bot-scripts/daily-rankings.
  • On the first of every month post a message to the #the-feed channel with server stats from the previous month. Logic in bot-scripts/message-history.

Bot Reactions

  • If certain keywords are used in a message (like "dog"), the bot will react with the related emoji (like 🐶). Logic in bot-scripts/specialEmojis.js.

Setup Guide

Resources

Core NPM Packages:

APIs:

Prerequisites

  1. Create your bot and invite to your discord server (this bot will be what is running "freeBrunch-discord-bot", will be source of tokens, clientids, etc.)

Self Host

Deployment and bot slash command update automated through GitHub Actions stored in this repo for Prod/Dev Discord servers.

  1. Obtain dedicated self hosted server. In my case a Raspberry Pi 4.
  2. Setup SSH auth to self hosted server and ensure server is accessable via internet.
  3. git clone freeBrunch-discord-bot to home directory (or directory you will cd into in .github/workflows/deploy-bot.yml).
  4. cd to directory and run:

Now the self hosted server is ready for the deploy-bot.yml github action to pull latest changes and restart the bot.

Cloud Host

  1. Many options

About

Fun with friends Discord Bot capable of running on a self hosted server (e.g. raspberry pi). See README for full list of bot capabilities!

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks