Tools

Migration Assistant

User-facing reference for the Migration Assistant tool.

v0.9.4Godot 4.7 stable4.6.3 supportedReference
Tool pages are written for users and buyers; they explain what to use, what to avoid, and where v0.9.4 boundaries are.

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

  1. Open the tool from Dreamcatcher.
  2. Start with one tiny project-owned output.
  3. Save or apply only one change.
  4. 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.

v0.9.4 boundary: use this tool through visible Dreamcatcher UI, generated assets, resources, templates, and validation workflows. Avoid editing plugin scripts directly unless official advanced documentation specifically tells you to.