https://github.com/wardlt/play-by-post-helper

A Bot to assist playing RPGs on Discord
https://github.com/wardlt/play-by-post-helper

Last synced: 19 days ago
JSON representation

A Bot to assist playing RPGs on Discord

• Host: GitHub
• URL: https://github.com/wardlt/play-by-post-helper
• Owner: WardLT
• License: mit
• Created: 2020-02-23T23:13:46.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2026-03-30T00:24:41.000Z (3 months ago)
• Last Synced: 2026-03-30T01:39:11.301Z (3 months ago)
• Language: Python
• Homepage:
• Size: 1.25 MB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 12
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
# Play-by-Post Helper

[![CI](https://github.com/WardLT/play-by-post-helper/actions/workflows/python-app.yml/badge.svg)](https://github.com/WardLT/play-by-post-helper/actions/workflows/python-app.yml)

[![Coverage Status](https://coveralls.io/repos/github/WardLT/play-by-post-helper/badge.svg?branch=master)](https://coveralls.io/github/WardLT/play-by-post-helper?branch=master)

The Play-by-Post Helper (Modron) is a Discord bot that assists playing Role Playing Games (RPGs) on Discord.

Modron can do common tasks for D&D and other TTRPG games, including:

- Messaging the channel to remind people if play has stalled

- Performing rolls according to D&D 5e rules

- Keeping track of character ability and health

## Setting Up Modron

Modron is a Python-based web server that you will need to install and then register with Discord.

The [installation guide](./docs/installation.md) describes how to install it for your Guild.

## Using Modron

Modron is a collection of Discord slash commands and persistent services. 

We briefly introduce them here and refer you to the [user guide](./docs/user-guide.md)

for the full documentation. 

### Rolling Dice

![rolling_dice](docs/img/roll-command.png)

Modron supports the D&D 5e rules for dice rolling, such as advantage and re-rolling ones.

A few examples include:

   - `$roll 1d20+5`: Rolling a single D20

   - `$roll 4d6 -1`: Roll 4d6 and re-roll any dice that are 1 on the first roll

### Tracking HP and Character Sheets

![HP Tracking](./docs/img/manage-hp.png)

Modron can look up values from a character sheet for each player and change its HP over time.

### Channel Reminders

![reminder](docs/img/reminder.png) 

Modron will issue reminders if play stalls for more than a configurable amount.