Skip to content

Monster Command

Look up monsters from the Shadowdark RPG bestiary, manage custom collections, and roll monster attacks.

Usage

The /monster command has several subcommands:

/monster search name:<name>
/monster add source:<source>
/monster delete name:<name>
/monster edit name:<name>
/monster attack name:<name>

Subcommands

Search for a monster by name. As you type, autocomplete suggestions appear showing "Name (Source)" to help you pick the right one.

/monster search name:goblin
/monster search name:fire giant

The result displays detailed monster information including: - Basic stats (HP, AC, movement) - Ability scores - Attacks and damage - Special abilities and talents - Alignment and level - Source information

/monster add

Add a custom monster to your server's collection. Select a source from the autocomplete list (or type a new one), then a modal/form opens where you paste the monster text in Shadowdark format.

/monster add source:Homebrew
/monster add source:Custom Campaign

After submitting, you'll see a preview with Approve/Reject buttons. Unapproved monsters are automatically deleted after 5 minutes.

See the Monster Text Format section below for details on the expected format.

/monster delete

Delete one of your custom monsters. Autocomplete shows your available custom monsters. You'll be asked to confirm before the monster is removed.

/monster delete name:Assassin

/monster edit

Edit one of your custom monsters. Autocomplete shows your available custom monsters. A modal opens pre-filled with the monster's existing text so you can make changes.

/monster edit name:Assassin

/monster attack

Roll a monster's attack during initiative. Autocomplete shows available monsters and their attacks in the format "Monster -- Attack (bonus / damage)".

/monster attack name:Goblin -- shortsword (+4 / 1d6+2)

Features: - Rolls both attack and damage - Automatically handles critical hits by doubling damage dice - Supports multi-attacks with separate embeds for each attack - Handles special effects (e.g., poison)

Monster Text Format

The monster text should follow the Shadowdark monster format:

Monster Name
Flavor text description.

AC 15, HP 38, ATK 2 poisoned dagger (close/near) +6 (2d4), MV near (climb), S 2, D 4, C 2, I 2, W 3, Ch 3, AL C, LV 8

Talent 1. Description of the first talent.

Talent 2. Description of the second talent.

It's critical to separate the stat block and talents with blank lines. This allows the stat block and talent descriptions to span multiple lines and makes copy/pasting from PDFs easier.

The parser handles: - Multi-line descriptions and flavor text - Complex stat blocks with ability scores - Multiple talents and abilities - Hyphenated words across line breaks - Various attack formats

Notes

  • The search is case-insensitive
  • Results are color-coded by alignment (Blue for Lawful, Grey for Neutral, Red for Chaotic)
  • Custom monsters are only visible in the server where they were created
  • Core monsters (source: "CR") are available everywhere
  • Only the user who created a monster can edit or delete it

Sources

The source can be any descriptive string you like. When multiple monsters match the search query, they are listed with their source in quotes. This is just a descriptive name to describe which book or resource this monster came from.

The data for core monsters came from the Unoffical Shadowdark Monster List by Michael Putlack of Night Noon Games.

Legacy Prefix Commands

The following prefix commands still work but will be removed in a future update:

Prefix Command Slash Equivalent
!monster <name> /monster search name:<name>
!add-monster <source> /monster add source:<source>
!ma <monster> <attack> /monster attack name:<name>
!monster_attack <monster> <attack> /monster attack name:<name>