import_pack
Loads CompendiumPack JSON files to import NPCs, locations, quests, and encounters into active campaigns. Handles name conflicts and regenerates entity IDs with preview mode for dry-run testing.
Instructions
Import a compendium pack into the current campaign.
Loads a CompendiumPack JSON file and imports its entities (NPCs, locations, quests, encounters) into the active campaign. Handles name conflicts via the chosen conflict mode. Regenerates all entity IDs and re-links cross-references.
Use preview=true for a dry-run that shows what would happen without changing anything.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes | Path to the pack JSON file to import | |
| conflict_mode | No | Conflict resolution: 'skip' (keep existing), 'overwrite' (replace), 'rename' (add suffix) | skip |
| preview | No | If true, show what would be imported without making changes | |
| entity_filter | No | Comma-separated entity types to import: npcs, locations, quests, encounters. Omit for all. |