Encounters.dev RPG Document Schemas

JSON Schema specifications for structuring tabletop RPG encounters and adventures

Encounter Schema

The Encounter Schema defines the structure for individual RPG encounters. It includes:

  • Basic encounter information (name, description, level)
  • Location and environment details
  • Creatures and NPCs present
  • Treasure and items
  • Special rules and conditions

Adventure Schema

The Adventure Schema defines the structure for complete RPG adventures. It includes:

  • Adventure metadata and setting information
  • Monster and NPC templates
  • Multiple linked encounters
  • Adventure-wide items and locations
  • Timeline and event tracking

Dictionary Schema

The Dictionary Schema provides common definitions used across both encounters and adventures. It includes:

  • Monster and NPC definitions
  • Combat statistics (AC, HP, etc.)
  • Treasure and item structures
  • Environment and hazard types
  • Special abilities and rules

Example Implementation

Check out our example implementation of "The Hole in the Oak", a classic dungeon crawl adventure converted to follow these schemas: