DSA Discord Bot

This bot shall be used for the German P&P role-playing game "The Dark Eye" (German: "Das Schwarze Auge (DSA)") when being played on a Discord-Server.

Included functionality:

• .roll : simple skill-check rolling (with "3d20" / "1W6")
• .check : storing charakter-sheets with attributes & check for skills, auto-filling attributes
• WIP:
  • managing charakter-sheet entries
  • Playing music playlist created before-hand for DM only (Sources: Youtube, Google Play Music)

Setup

Requirements:

• Git
• Python3

Recommended Software:

• VSCode as IDE
• TortoiseGit for easier usage of Git (on Windows)

Getting Started: Use venv to install dependencies, provide config details and start bot.

Initial Setup on Windows:

mkdir .venv
py -m  venv .venv		# create venv
.\.venv\Scripts\activate		# enter venv
pip3 install -r .\requirements.txt		# install dependencies
copy config.yaml.example config.yaml		# make copy of config-file
# add details in config.yaml
python .\bot\bot.py		# start bot

Initial Setup on Linux:

mkdir .venv
python3 -m venv .venv
source .venv/bin/activate
pip3 install install -r ./requirements.txt
cp config.yaml.example config.yaml
# add details in config.yaml
python3 bot/bot.py		# start bot

Developer Information & Tips

Discord-Bot

The discord-bot is built on discord.py (see GitHub). A is much material on working with this library, including a simple Youtube-playlist Tutorial or directly the official documentation.

Python dependencies

Freezing new dependencies into requirements.txt is done by $ pip freeze > requirements.txt.