Skip to main content

Step 1: Project and config (project)

Updates the .uproject file and the project's .ini files. This step only edits files, so it can also run from another 5.8 project with -target (see Workflow).

Done automatically​

  • EngineAssociation set to 5.8.
  • TargetPlatforms renamed: WindowsNoEditor to Windows, MacNoEditor to Mac, LinuxNoEditor to Linux, LinuxAArch64NoEditor to LinuxArm64.
  • Plugins removed in 5.8 are removed from the .uproject; replaced plugins are swapped for their successor when they were enabled.
  • Disabled entries of plugins that no longer exist are removed.
  • Plugins required by classes that moved to a plugin are enabled (for example XRBase, needed when the project references HeadMountedDisplayFunctionLibrary).
  • Chaos Vehicles is enabled when the project used PhysX Vehicles (this sets restart required).
  • .ini rules of the project group, including the Android and iOS minimums and the packaging denylist keys.

Reported for you​

  • Enabled plugins that 5.8 does not know (usually third-party plugins that need a 5.8 build).
  • Features of removed plugins the project used (Manual: what used them must be rebuilt).

Rule tables​

plugins.json (69 plugins: 59 removed, 10 replaced) and the project rules of config.json.

Examples​

Before (4.27)After (5.8)
plugin PhysXVehiclesChaosVehiclesPlugin
plugin OculusVR, SteamVROpenXR
plugin LightPropagationVolumeremoved (use Lumen or baked lighting)
IniKeyBlacklist in [/Script/UnrealEd.ProjectPackagingSettings]IniKeyDenylist
Android MinSDKVersion below 2626 (the 5.8 minimum)
iOS MinimumiOSVersion=IOS_12IOS_Minimum (4.27 values do not exist in 5.8)
Android bBuildForArmV7removed (32-bit ARM is no longer supported)