Repository navigation
Prepare Visual Studio (Windows)
Microsoft sometimes forces Visual Studio to update through Windows Update.
For Unreal Engine 5.4, you need Visual Studio 17.8 or, at a minimum, the libraries from version 17.8.
If you have a paid Enterprise or Professional license:
Download Visual Studio from the release history page. Install and use Visual Studio 17.8.
If you use the Community edition, Microsoft forces you to use version 17.14, which causes the build to fail. You can work around this with the following steps:
- Uninstall Visual Studio and Visual Studio Installer if they are already installed.
- Download and start installing Visual Studio 17.14 Community from the release history page.
-
At installation, select the following workloads:
- .NET Multi-platform App UI development
- .NET desktop development
- Desktop development with C++
- Game development with C++
-
In Installation Details -> Game development with C++, enable the following options:
- C++ profiling tools
- C++ AddressSanitizer
- Windows 10 and 11 SDK
- Unreal Engine installer
- Unreal Engine Test Adapter
- In the Individual components tab, search for
MSVC. - Select
MSVC v143 - VS 2022 C++ x64/x86 build tools (v14.38-17.8). This fixes the build failure caused by using Visual Studio 17.14 instead of 17.8.
Warning: The component name may vary depending on the Visual Studio language.
- In Language packs, select English and deselect all other languages to avoid Visual Studio issues.
- Click Install in the lower-right corner.
During installation, you may see a warning about an unsupported version. Ignore it and click Continue.
Windows Update may install the wrong version of the GitHub Protocol Handler, causing an error or crash when you try to connect your GitHub account in Visual Studio.
- Check whether the path
C:\Program Files (x86)\Microsoft Visual Studio\Shared\GitHubProtocolHandlerexists. If it does, skip the following steps and continue with the Generate Project Files step.
For Visual Studio 17.14, Windows should install Microsoft.VisualStudio.GitHubProtocolHandler.Msi,version=17.14.36015.10.
However, it may install Microsoft.VisualStudio.GitHubProtocolHandler.Msi,version=18.3.11407.131 instead, which causes the GitHub Protocol Handler to fail.
You can check the installed package under %ProgramData%\Microsoft\VisualStudio\Packages\.
- To fix this, manually add the GitHub Protocol Handler files for version 17.14 to the correct path.
DownloadGitHubProtocolHandler.zipfrom GitHub and extract theGitHubProtocolHandlerfolder intoC:\Program Files (x86)\Microsoft Visual Studio\Shared\.
This may require administrator permissions.
--> GitHubProtocolHandler.zip
- Visual Studio for Unreal Engine (Windows):
https://dev.epicgames.com/documentation/en-us/unreal-engine/setting-up-visual-studio-development-environment-for-cplusplus-projects-in-unreal-engine - Build Unreal Engine from source for VS Code (Windows / Linux):
https://voithos.io/articles/building-unreal-engine-from-source-for-vscode/ - Issue about Visual Studio version for Unreal Engine 5.4 (Windows):
https://forums.unrealengine.com/t/help-visual-studio-preferred-version-in-5-4/2001249 - Issue with GitHubProtocolHandler in Visual Studio (Windows):
https://github.com/orgs/community/discussions/159838
https://developercommunity.visualstudio.com/t/Problem-signing-in-to-Github-Copilot/10909254?moreInfo=true&viewtype=all
Launch Visual Studio Installer in English:
cd "C:\Program Files (x86)\Microsoft Visual Studio\Installer"
vs_installer.exe --locale en-USReturn to Dev Notes