generate-books

name	generate-books
description	Generate print-ready books from an existing world pack. Creates GM book, player book, bestiary, and campaign setting.
argument-hint	<world-pack-id>
allowed-tools	["Task","AskUserQuestion","mcp__rpg__list_world_packs","mcp__rpg__load_world_pack","mcp__rpg__generate_rulebook","mcp__rpg__save_rulebook_result","mcp__rpg__generate_world_books","mcp__rpg__generate_appendices","mcp__rpg__save_book_result"]

Generate Books Command

Generate print-ready books from an existing world pack.

Usage

/generate-books <world-pack-id>

If no world pack ID is provided, lists available packs.

Output

Creates files in the data directory (configurable via RPG_MCP_DATA_DIR environment variable, defaults to ~/.mythxengine/data/):

data/
├── rules/                    # Shared across all worlds
│   ├── core-rules.txt        # Complete rulebook
│   ├── quick-reference.txt   # One-page reference
│   └── character-sheet.txt   # Printable character sheet
│
└── books/<pack-id>/          # World-specific books (uses pack ID)
    ├── gm-book.txt           # GM-only content (full spoilers)
    ├── player-book.txt       # Player-facing content
    ├── bestiary.txt          # All monsters
    ├── campaign-setting.txt  # World overview
    └── appendices/
        ├── items.txt         # Complete item catalog
        ├── conditions.txt    # Conditions reference
        └── encounters.txt    # Encounter tables

Workflow

Phase 1: World Pack Selection

If no pack ID provided:

1. Call mcp__rpg__list_world_packs() to get available packs
2. Use AskUserQuestion to let user select:

   header: "World Pack"
   question: "Which world do you want to generate books for?"
   options:
     - label: "<pack-name>"
       description: "<pack-tagline>"
     ...
   

Phase 2: Validate Pack

1. Call mcp__rpg__load_world_pack({ packId }) to verify it exists
2. Display world summary:
   • Name and tagline
   • Content counts (archetypes, monsters, locations, etc.)
3. Confirm generation with user

Phase 3: Generate Rulebook (if needed)

1. Call mcp__rpg__generate_rulebook({ force: false })
2. If cached: false:
   • Launch rpg:book-generator subagent for rulebook
   • Wait for completion

Phase 4: Generate World Books (Parallel)

Launch 4 book-generator subagents in a SINGLE message:

Task(subagent_type: "rpg:book-generator",
     prompt: "Generate GM book for pack <id>. Type: gm")
Task(subagent_type: "rpg:book-generator",
     prompt: "Generate player book for pack <id>. Type: player")
Task(subagent_type: "rpg:book-generator",
     prompt: "Generate bestiary for pack <id>. Type: bestiary")
Task(subagent_type: "rpg:book-generator",
     prompt: "Generate campaign setting for pack <id>. Type: setting")

Phase 5: Generate Appendices (Parallel)

Launch 3 book-generator subagents:

Task(subagent_type: "rpg:book-generator",
     prompt: "Generate items appendix for pack <id>. Type: items")
Task(subagent_type: "rpg:book-generator",
     prompt: "Generate conditions appendix for pack <id>. Type: conditions")
Task(subagent_type: "rpg:book-generator",
     prompt: "Generate encounters appendix for pack <id>. Type: encounters")

Phase 6: Report

Display completion summary:

• List of generated files with paths
• Total page/word counts if available
• Instructions for printing

Book Descriptions

Rulebook (Cached)

The core rules, shared across all worlds:

• d20 test system
• 4 abilities (STR/AGI/WIT/CON)
• Difficulty levels (8/12/16/20)
• Combat rules
• Character creation basics

GM Book

Everything the GM needs to run the world:

• Opening scenes and session zero guidance
• Situations with clocks and leads
• Full NPC profiles with secrets
• Location secrets and GM notes
• Encounter tables

Player Book

Safe for players to read:

• World overview
• Full archetype details
• Known locations (no secrets)
• Public NPC information
• Equipment catalog
• Quick reference

Bestiary

All creatures by threat tier:

• Minions (HP 4-6)
• Standard (HP 10-14)
• Elite (HP 18-24)
• Boss (HP 30-40)

Each with full stats, tactics, lore, and descriptions.

Campaign Setting

Deep world-building reference:

• History and lore
• Geography
• Factions and politics
• Cultures
• Magic/technology systems

Appendices

Reference tables:

• Complete item catalog
• All conditions
• Encounter tables by location

Text Format

All books use plain text optimized for zine printing:

• === for major sections
• --- for subsections
• *text* for emphasis
• 50-character max line width
• <<<PAGE>>> for page breaks