Upgrading to Unreal Engine 5.3#
These instructions apply if you are already using Colosseum on Unreal Engine 4.27. If you have never installed Colosseum, please see How to get it.
Caution: The below steps will delete any of your unsaved work in Colosseum or Unreal folder.
Do this first#
For Windows Users#
- Install Visual Studio 2022 with VC++, Python and C#.
- Install UE 5.3 through Epic Games Launcher.
- Start
x64 Native Tools Command Prompt for VS 2022
and navigate to Colosseum repo. - Run
clean_rebuild.bat
to remove all unchecked/extra stuff and rebuild everything. - See also Build Colosseum on Windows for more information.
For Linux Users#
- From your Colosseum repo folder, run 'clean_rebuild.sh`.
- Rename or delete your existing folder for Unreal Engine.
- Follow step 1 and 2 to install Unreal Engine 5.3.
- See also Build Colosseum on Linux for more information.
Upgrading Your Custom Unreal Project#
If you have your own Unreal project created in an older version of Unreal Engine then you need to upgrade your project to Unreal 5.3. To do this,
- Open .uproject file and look for the line
"EngineAssociation"
and make sure it reads like"EngineAssociation": "5.3"
. - Delete
Plugins/Colosseum
folder in your Unreal project's folder. - Go to your Colosseum repo folder and copy
Unreal\Plugins
folder to your Unreal project's folder. - Copy *.bat (or *.sh for Linux) from
Unreal\Environments\Blocks
to your project's folder. - Run
clean.bat
(orclean.sh
for Linux) followed byGenerateProjectFiles.bat
(only for Windows).
FAQ#
I have an Unreal project that is older than 4.27. How do I upgrade it?#
Option 1: Just Recreate Project#
If your project doesn't have any code or assets other than environment you downloaded then you can also simply recreate the project in Unreal 5.3 Editor and then copy Plugins folder from Colosseum/Unreal/Plugins
.
In your project's *.Target.cs#
-
Change the contructor from,
public MyProjectTarget(TargetInfo Target)
topublic MyProjectTarget(TargetInfo Target) : base(Target)
-
Remove
SetupBinaries
method if you have one and instead add following line in contructor above:ExtraModuleNames.AddRange(new string[] { "MyProject" });
In your project's *.Build.cs#
Change the constructor from public MyProject(TargetInfo Target)
to public MyProject(ReadOnlyTargetRules Target) : base(Target)
.
And finally...#
Follow above steps to continue the upgrade. The warning box might show only "Open Copy" button. Don't click that. Instead, click on More Options which will reveal more buttons. Choose Convert-In-Place option
. Caution: Always keep backup of your project first! If you don't have anything nasty, in place conversion should go through and you are now on the new version of Unreal.