dnd-dm-planner

D&D DM Session Planner

A Claude Code plugin for Dungeon Masters to plan engaging D&D sessions with spotlight moments for each party member.

Features

• Session Templates for different session types:

  • Combat-focused sessions
  • Roleplay/Social sessions
  • Exploration/Dungeon sessions
  • Stealth/Heist sessions
  • Mystery/Investigation sessions

• Character Spotlight System: Design sessions that let specific party members shine based on their race, class, and abilities

• Custom Race/Class Support: Add homebrew races and classes with their own spotlight opportunities

• Agents for specialized assistance:

  • Session Planner
  • Encounter Balancer
  • NPC Creator

Installation

From GitHub Packages

1. Create a GitHub Personal Access Token with read:packages scope
2. Configure npm to use GitHub Packages:

# Add to ~/.npmrc
//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN
@sambailey6194:registry=https://npm.pkg.github.com

3. Install the package:

npm install @sambailey6194/dnd-dm-planner

As a Claude Code Plugin

Add to your Claude Code settings:

{
  "plugins": [
    "@sambailey6194/dnd-dm-planner"
  ]
}

Usage

Session Templates

const { generateSession, SESSION_TYPES, designSpotlightMoment } = require('@sambailey6194/dnd-dm-planner');

// Get spotlight suggestions for a character
const spotlight = designSpotlightMoment(SESSION_TYPES.COMBAT, {
  race: 'Dwarf',
  class: 'Fighter'
});

// Generate a session document
const session = generateSession(SESSION_TYPES.COMBAT, sessionData);

Adding Custom Races/Classes

const { addCustomRace, addCustomClass } = require('@sambailey6194/dnd-dm-planner');

// Add a homebrew race
addCustomRace('Mousefolk', {
  source: 'Homebrew',
  traits: ['Keen Smell', 'Nimble Escape', 'Squeeze'],
  spotlights: ['tight spaces', 'scent tracking', 'quick escapes']
});

// Add a custom class
addCustomClass('Blood Hunter', {
  source: 'Critical Role',
  features: ['Blood Rite', 'Hunter\'s Bane', 'Crimson Rite'],
  spotlights: ['monster hunting', 'blood magic', 'tracking supernatural']
});

Commands

• /plan-session [number] - Start planning a new session

License

MIT