Importing your world from NovelCrafter

If you're migrating from NovelCrafter, The Stream Facility can import your world directly from a NovelCrafter export file.

Export from NovelCrafter

In NovelCrafter, go to your world settings and choose Export. Download the zip file to your computer.

Import to The Stream Facility

1. Open your world in The Stream Facility Codex
2. Click Import in the Codex toolbar
3. Choose NovelCrafter as the source
4. Upload the zip file
5. Review the preview — it shows all entities found in the export, organized by type

What imports

The importer handles 19 NovelCrafter entity types and maps them to the nearest Stream Facility equivalent. Images embedded in the export are extracted and uploaded to Cloudinary automatically.

Duplicate detection

During import, the system checks each entity against your existing Codex. For any entity that might already exist (matched by name), you can choose to:

• Insert — add it as a new entity regardless
• Merge — combine the imported data with the existing entity
• Rename — insert with a modified name to avoid collision

Entities with no match import automatically.

After import

Newly imported entities are flagged with a "Needs Review" badge as a reminder to check and expand the imported content. The flag clears when you edit and save the entity.