Skip to main content

Unreal Engine Absolute Project Migrator

Unreal Engine Absolute Project Migrator (UEAPM), by MNZ Sistemas, is an editor plugin for Unreal Engine 5.8 that migrates a project authored with Unreal Engine 4.27. It does as much as possible automatically and writes a complete report of what it changed and what is left for you to do.

What it does​

The migration runs in eight steps, always in the same order:

#StepIn short
1Project and config.uproject, plugins, target platforms, .ini settings
2Assets resaveloads and resaves every /Game package in the 5.8 format
3Enhanced Input (opt-in)legacy input mappings and events to Enhanced Input
4Cascade to Niagaraconverts particle systems and repoints references
5C++ sourcerule-based source fixes, build settings, project files
6Rendering and mobilerenderer settings, material checks
7Physics (PhysX to Chaos)physics settings, PhysX vehicles to Chaos vehicles
8Blueprintsdeprecated calls replaced, every Blueprint compiled

Each step runs three phases:

  • Analyze finds what needs to change. It never modifies anything.
  • Apply makes the automatic changes (skipped in a dry run).
  • Verify checks again and lists what is left.

Automatic versus reported​

UEAPM only changes what it can change safely and with a known result. Everything else goes into the report as an open item with its location and a precise fix. Examples:

  • Automatic: the engine association, removed plugins, renamed .ini keys, header moves in C++, particle system conversion, deprecated Blueprint calls with a direct replacement, PhysX vehicle Blueprints re-parented to Chaos.
  • Reported: plugins unknown to 5.8, C++ code that needs a human decision (PhysX, Matinee), Cascade modules the converter does not support, vehicle tuning parameters without a Chaos equivalent, Blueprint compile errors.

There are no hidden fallbacks: when an operation cannot be done, the report says so with an Error or Manual item and the fix to apply.

Requirements​

  • Unreal Engine 5.8 on Windows.
  • A project authored with Unreal Engine 4.27.
  • The project must be a copy or be under version control. UEAPM backs up every file it modifies, but it works in place: always keep the original 4.27 project untouched.
  • For C++ projects: the Visual Studio toolchain required by UE 5.8.

Next steps​

  1. Install the plugin.
  2. Follow the workflow for a Blueprint-only or C++ project.
  3. Read the report and work through the open items.

To see a complete real migration, read the Action RPG case study.