How do I import content from virtual tabletops?

SwiftPrep can import campaign data from virtual tabletop platforms. Bring your existing NPCs, locations, items, and notes into SwiftPrep without recreating everything from scratch.

Currently Supported Platforms

[!INFO] Fantasy Grounds is fully supported today. See the dedicated Fantasy Grounds import guide for detailed instructions.

Why Import Your VTT Data?

Save Hours of Work

If you have built campaigns in a VTT, you already have valuable data. NPCs with descriptions, items with properties, notes and story entries. Importing brings all of that into SwiftPrep so you can:

• Enhance content with AI-powered features
• Build relationships between entities
• Use Super Swift to generate new content that fits your existing world
• Search across your entire campaign instantly

Better Prep Tools

VTTs are great for running games. SwiftPrep is built for preparing them. Import your VTT data to get:

• Campaign-wide search across all content
• Relationship visualization with the graph view
• AI generation that knows your world
• Session planning linked to your content

Keep Using Your VTT

Import does not mean abandoning your VTT. Use SwiftPrep for prep and organization, then run your sessions in whatever VTT you prefer.

What Imports

Import coverage varies by platform, but generally includes:

Content Types

Data Fields

What Does Not Import

Some content stays in your VTT:

• Maps - SwiftPrep does not have a map viewer; keep maps in your VTT
• Character sheets - Detailed PC mechanics stay in your VTT
• Automation and macros - VTT-specific scripting
• Audio and video - Multimedia assets

SwiftPrep focuses on narrative content. The people, places, and stories. Not tactical game mechanics.

Import Process Overview

All imports follow this general workflow:

Step 1: Locate Your Campaign Data

Find your VTT's campaign files:

• Fantasy Grounds: Campaign folders in the SmiteWorks directory
• Foundry VTT: World data in your Foundry user data folder
• Roll20: Export functionality when supported

Step 2: Start the Import Wizard

1. Open SwiftPrep
2. Go to Settings > Import
3. Select your VTT platform
4. Navigate to your campaign data

Step 3: Preview and Configure

SwiftPrep shows what will be imported:

• Review entity counts by type
• See any warnings or conflicts
• Configure import options (what to include)

Step 4: Import

Click Import and wait. Large campaigns may take a minute or two depending on the amount of content.

Step 5: Review and Organize

After import completes:

• Check imported entities for accuracy
• Add tags to organize content
• Create relationships between entities
• Fill in any gaps with AI generation

Post-Import Best Practices

Clean Up Imported Data

VTT data often has quirks that need attention:

• Duplicate entries - Merge or delete duplicates
• Incomplete entries - Add missing details or generate with AI
• Naming inconsistencies - Standardize names for easier searching

Add Relationships

VTTs do not export relationship data. Build your web in SwiftPrep:

1. Open key NPCs
2. Add relationships to other NPCs, locations, and factions
3. Use the graph view to see connections forming

Use Tags for Organization

Import does not know your organizational system. Add tags:

• imported - Track what came from the VTT
• Story arc tags - Group by plot line
• Status tags - needs-review, cleaned-up

Enhance with AI

On Companion and Power tiers:

• Generate missing content for sparse entries
• Let AI suggest relationships
• Use Session Companion to flesh out imported NPCs

[!TIP] Tag all imported content with something like imported-fg so you can easily find and review content that came from your VTT.

Troubleshooting Imports

Import Fails Completely

• Verify you selected the correct campaign folder
• Check that the campaign data is not corrupted
• Try exporting from your VTT first, then importing the export

Missing Content

• Some VTT data may not map to SwiftPrep entities
• Check VTT-specific documentation for known limitations
• Manually create what did not import

Garbled Text

• Character encoding issues can occur during import
• Special characters may not survive the conversion
• Edit affected entries manually in SwiftPrep

Duplicates

• Import creates new entries by default
• Use search to find and merge duplicates
• Consider tagging imports to identify them later

Related Articles

• How do I import from Fantasy Grounds?
• How do I import from Foundry VTT?
• How do I import from Roll20?
• What export formats does SwiftPrep support?