Migration steps
The steps run in this order. Blueprints runs last, so its compile result is the final state of the project.
| # | Step id | Done automatically | Reported for you | Rule table |
|---|---|---|---|---|
| 1 | project | engine association, target platforms, plugins, .ini rules | plugins unknown to 5.8, features of removed plugins | plugins.json, config.json |
| 2 | assets | load and resave every /Game package older than the engine | packages with load errors, version census | none |
| 3 | input (opt-in) | Input Actions, mapping context, Enhanced Input events | chorded keys, Key pin use, C++ bindings | none |
| 4 | cascade | particle systems converted, references repointed | unsupported modules, trails/beams, references it cannot replace | cascade.json |
| 5 | cpp | regex rules, includes, build settings, project files | non-automatic matches with file:line, build command | cpp.json |
| 6 | rendering | renderer .ini rules (mobile rules on mobile projects) | materials that lost expressions or functions | config.json |
| 7 | physics | physics .ini rules, PhysX vehicles re-parented to Chaos | unmapped tuning, DestructibleMesh, TireConfig, simple vehicles | config.json, physics.json |
| 8 | blueprints | deprecated calls replaced, every Blueprint compiled | compile errors with fix text, non-automatic calls, removed parents | bp_nodes.json |
Rule tables
The rules live in the plugin's Resources/Rules folder as JSON. They are loaded all together (a broken table
stops the migration with an error instead of running half the rules) and validated by the plugin's automation
tests. Every rule records the reason and the engine evidence behind it.
| File | Content | Size |
|---|---|---|
plugins.json | 4.27 plugins removed or replaced in 5.8, target platform renames, plugins required by moved classes | 69 plugins (59 removed, 10 replaced) |
config.json | .ini rules: remove, rename, rename section, set, set if missing, replace value | 67 rules |
cpp.json | per-line source rules plus ensure-include rules | 122 rules (93 automatic, 29 report-only) |
cascade.json | converted asset suffix and spawn call replacements | 2 call replacements |
physics.json | legacy vehicle to Chaos class, member, movement and wheel maps | 22 movement + 11 wheel parameters mapped |
bp_nodes.json | deprecated Blueprint functions, removed node classes, removed parent classes, compile hints | 141 functions, 4 node classes |