Skip to content

Initiative Command

Manage initiative order and combat turns.

Usage

!initiative [subcommand] [args...]

Subcommands

  • begin - Start a new initiative order
  • madd <monster name> - Add a combatant to initiative
  • join - Players can join with their selected character
  • remove <name> - Remove a combatant from initiative
  • next - Move to the next turn
  • list - Show the initiative tracker list
  • end - End the current initiative and delete all associated data

Description

The initiative command allows you to: - Create and manage initiative order - Add and remove combatants - Track turns in combat - View the current initiative order

Examples

Start a new initiative order: 

!i begin

You can also specify a turn order mode: 

!i begin rolled
!i begin fixed

  • rolled (default): Combatants act in order of their initiative rolls
  • fixed: Combatants act in the order they join initiative. This simulates the Shadowdark rule of initiative going around the table.

The initiative will start at round 0. The player that used the begin command will be the DM. Only one initiative can be active in a channel.

The response to the begin command is a "sticky" message that gets updated with each turn advance. It's helpful to pin this message to the channel.

Add combatants: 

!initiative madd Goblin
!i madd gob boss
!i madd fire dragon

Only the DM can add monsters with madd. Fuzzy matching is used on monster names. To keep monsters unique, a random adjective is given to each monster: "Hungry Goblin", "Clever Hobgoblin", etc.

Players join:

!i join

The DM can join with a character as well. Players can join with multiple characters by selecting a character, joining, then selecting the next character. The character's names are used in the initiative tracker.

When all combatants (or at least all of them for round 1), the DM can advance the turn 

!initiative next

This will send an @mention to the user of the first combatant (either DM or Player) notifying them of their turn.

Each player can then advance the turn when they are done:

!i next

The DM can always advance the turn.

The DM can remove combatants from the initiative:

!i remove goblin

Notes

  • Initiative is rolled automatically when adding combatants (in rolled mode)
  • The command supports both players and NPCs/monsters
  • Initiative order is maintained until cleared
  • Combatants can be added or removed at any time
  • Turn order can be either rolled (default) or fixed based on join order