Migration Assistant
User-facing reference for the Migration Assistant tool.
Reviewed binding promotion
Migration Assistant keeps older migration behavior and adds a reviewed v0.9.4 assignment-promotion dry run plus selected batch apply for supported v0.9.5 bindings. Rows distinguish Create Binding, Keep Existing, Add as Variant for audio, Replace Existing, No Change, and unresolved context. Apply-time reclassification, transactional persistence, rollback, and idempotent re-runs are designed to avoid stale or silent mutations.
Migration Assistant
Status: Stable
Category: System
Use it when: you are opening older Dreamcatcher projects or schemas.
First task
Back up, run migration check, then validate older resources.
Inputs
A backed-up older project/resource set.
Outputs
Migration report and updated resources where supported.
How it connects
Use before editing old projects heavily.
Common mistakes
Migrating without backup; skipping validation after migration.
Validation
Open affected scenes/resources and run Content Validator.
First safe task
- Open the tool from Dreamcatcher.
- Start with one tiny project-owned output.
- Save or apply only one change.
- Run Content Validator or Quick Play before expanding.
Success looks like
The output exists in the expected project location, related references are visible in the Inspector/tool UI, and no validator error points to a missing path or deleted resource.
Common mistake
Stacking several generated outputs or gameplay connections before checking one simple result first.
