Project Setup
This describes the procedure and tools required to enable development on the various IDE’s and platforms that Goofish supports, in particular Visual Studio Professional
and Jetbrains Rider
, for Unreal Engine source, and Project builds.
Unreal Engine 4.27 Source Project configuration
Since Visual Studio 2022+, the procedure to compile the Engine source is no longer viable using Visual Studio 2017 as Epic's GitHub page describes in the readme.md
This is because the msbuild
that is used to generate the project files chosen by vswhere
from the GenerateProjectFiles.bat is returning the current version of msbuild
, and not version 15. ( Visual Studio 2017 )
Certain steps need to be taken as we can not uninstall Visual Studio 2022 as it is used for other projects.
The general steps to build the engine source ( 4.26+ ) is as follows, we are using Jetbrains Rider ( latest version ) for this with specific settings to build for msbuild
version 16 ( Visual Studio 2019 ), as we have found using msbuild
version 15 ( vs2017 ) no longer works when using Visual Studio.
Ensure the custom Engine plugins have been removed first before running these steps, as it will cause duplicate plugins to exist and generally be a pain to debug as such, do this by running OptimizationPlugin\removeplugins.bat
from the OptimizationsPlugin project first, before doing these.
Ensure the correct branch of the Unreal Engine source and/or tag has been checked out from GitHub.
Either release 4.26, or 4.27 ( preferably 4.27 )
Ensure the following versions of Visual Studio is installed ( you can use build tools only, but don’t as we also use them for other projects )
Visual Studio 2015 Community Edition
Visual Studio 2017 Professional
Visual Studio 2019 Professional
Visual Studio 2022+ Professional
Ensure the latest version of Jetbrains Rider is installed.
Go to the Windows Start, and type ‘developer command’, choose Developer Command Prompt for VS2019
Enter this command prompt, and change directory to the engine source, then run the GenerateProjectFiles.bat
from within the command prompt.
Open the solution in Rider, and let it do it's thing, it takes a few years but eventually the progress bar will stop progressing and the project will be open ( specially the first time, go have a starbucks or something )
Navigate to the msbuild
version setting ( it may change or vary depending on rider version, just use settings search [CTL+ALT+S
] and type 'msbuild' )
Ensure Rider MSBuild version is set to 16.0 ( VS2019 Professional )
Ensure the platform is set to
Development Editor|Win64
then build (CTL+SHIFT+F7
) the UE4 project only, it will build any dependencies required.About 9 years after this build is done ( specially the first time ) navigate to:
UnrealEngine\Engine\Binaries\Win64\UnrealVersionSelector-Win64-Shipping.exe
Run that as administrator, and say yes to everything.
UE4.27 Project Configuration
If this is the GoofishOptimization project, ensure the custom Engine plugins have been removed first before running these steps, as it will cause duplicate plugins to exist and generally be a pain to debug as such, do this by running OptimizationPlugin\removeplugins.bat
Right click the .uproject file and choose
Switch To Engine Version
If the above steps were followed the Engine Source build will be the default option.
This will also re generate the project files.
Open the solution in Rider, and set the MSBuild version to 16.0 ( vs2019 Pro )
Ensure the platform config is set to
Development Editor|Win64
Build the game project only
CTL+SHIFT+F7
.
If this is the GoofishOptimization project, ensure the custom Engine plugins have been updated first after running these steps, as it will cause builds to fail due to missing changes/old code, do this by running OptimizationPlugin\deployplugins.bat
This is mostly specific to Goofish’s workflow, but this may apply to third party/external projects as well.