Foundry VTT D&D 5e Data Structure
Overview
This documentation describes the structure and organization of D&D 5e content in Foundry VTT, specifically focusing on the 2024 editions of the Player's Handbook and Dungeon Master's Guide.
Installation Location
- Base Path:
/mnt/data/foundry/ - Data Directory:
/mnt/data/foundry/Data/ - Modules:
/mnt/data/foundry/Data/modules/ - Systems:
/mnt/data/foundry/Data/systems/dnd5e/
Active D&D Content
Player's Handbook (2024)
- Module ID:
dnd-players-handbook - Version: 2.1.0
- Size: ~90 MB
- Path:
/mnt/data/foundry/Data/modules/dnd-players-handbook/
Dungeon Master's Guide (2024)
- Module ID:
dnd-dungeon-masters-guide - Version: 2.0.0
- Size: ~266 MB
- Path:
/mnt/data/foundry/Data/modules/dnd-dungeon-masters-guide/
D&D 5e System (Core)
- System ID:
dnd5e - Version: 5.1.10
- Path:
/mnt/data/foundry/Data/systems/dnd5e/ - Note: SRD 5.1 and 5.2 content disabled to avoid duplication with 2024 books
Data Storage Format
Compendium Packs
All game content is stored in LevelDB databases:
- Format: Binary key-value store
- Location: Within each module's /packs/ subdirectories
- Files: .ldb files (e.g., 000005.ldb, 000010.ldb)
- Metadata: CURRENT, MANIFEST, LOG files for database management
Configuration Files
- module.json: Module metadata, dependencies, and pack definitions
- system.json: System configuration and rules framework
- Format: Standard JSON
Asset Files
- Images: WebP, JPEG, PNG, SVG formats
- Maps: Stored in
/assets/scenes/directories - Icons: Item and spell icons in various formats
Content Organization
Player's Handbook 2024 Packs
Located in /mnt/data/foundry/Data/modules/dnd-players-handbook/packs/:
| Pack | Type | Description |
|---|---|---|
content |
JournalEntry | Rules and reference content |
classes |
Item | Character classes and subclasses |
origins |
Item | Character origins (backgrounds/species) |
feats |
Item | Character feats |
spells |
Item | Spell compendium |
equipment |
Item | Weapons, armor, gear |
tables |
RollTable | Random tables |
actors |
Actor | Pre-generated characters |
Dungeon Master's Guide 2024 Packs
Located in /mnt/data/foundry/Data/modules/dnd-dungeon-masters-guide/packs/:
| Pack | Type | Description |
|---|---|---|
content |
JournalEntry | DM rules and guidance |
equipment |
Item | Magic items and treasures |
features |
Item | Special features and abilities |
bastions |
Item/JournalEntry | Bastion system content |
tables |
RollTable | DM random tables |
actors |
Actor | NPCs and monsters |
scenes |
Scene | 23 battle maps |
Database Structure
LevelDB Overview
- Engine: Google's LevelDB (key-value storage)
- Compression: Snappy compression by default
- Structure: Log-structured merge-tree (LSM)
- Access: Requires LevelDB library or specialized tools
Typical Entry Structure
Each database entry contains: - Key: UUID or system identifier - Value: JSON object with game data - Metadata: Version, flags, permissions
Localization
- Language Files:
/lang/directories - Supported: Multiple languages via JSON files
- Default: English (en.json)
Source Identifiers
Content is tagged with source books:
- SOURCE.BOOK.PHB2024: Player's Handbook (2024)
- SOURCE.BOOK.DMG2024: Dungeon Master's Guide (2024)
Next Steps
- Install tools to read LevelDB databases
- Create extraction scripts for specific content types
- Build reference system for quick rule lookups