Install Visual Studio Tools for Unreal Engine

This article helps you install Visual Studio Tools for Unreal Engine (UE). These tools allow you to do the following from within Visual Studio:

  • Add UE classes
  • View UE logging
  • View and expand UE macros
  • View and find references to UE Blueprints*

*As of Visual Studio 2022 version 17.7, you no longer need the Unreal Engine Visual Studio Integration Tool plugin to view UE Blueprints in Visual Studio. However, you do need the plugin to use the Unreal Engine test adapter in Visual Studio.

Prerequisites

You should have the following installed before you install Visual Studio Tools for Unreal Engine:

Installation

This article covers installing two tools that connect Visual Studio and Unreal Engine:

  • Visual Studio Tools for Unreal Engine are installed into Visual Studio with the Visual Studio installer. It lets you add UE classes, view UE logging, and more--all from within Visual Studio.
  • Unreal Engine Visual Studio Integration Tool plugin is installed into Unreal Engine via the Epic Games marketplace (now called HAB) or from source. It supports the Unreal Engine test adapter in Visual Studio, which lets you discover, run, manage, and debug your Unreal Engine tests from within Visual Studio. As of Visual Studio 2022 17.10, you no longer need the plugin to view UE Blueprints in Visual Studio. But you do need it to use the Unreal Engine test adapter in Visual Studio.

To install Visual Studio Tools for Unreal Engine:

  1. In the Windows search box, type "Visual Studio Installer".

  2. Look for the installer under the Apps results and double-click it.

  3. When the installer appears, select the version of Visual Studio you're using and then select Modify.

  4. Select the Workloads tab, then select the Game development with C++ workload.

  5. In the Installations details pane, ensure that under Game development with C++ > Optional that Visual Studio Tools for Unreal Engine is selected. If you work with High-Level Shader Language (HLSL) files, ensure that HLSL Tools is also selected.

  6. Select the Individual components tab at the top of the dialog.

  7. Under Installation details on the right, expand Game development with C++.

  8. Ensure that under Optional that Windows 10 SDK 10.0.18362.0, or higher, is selected.

  9. Select Modify to complete the installation.

    Screenshot of the game development with C++ workload selected in the installer. In the installation details pane, IDE support for Unreal Engine and HLSL Tools are checked.

Configure Unreal Engine to use Visual Studio

The UnrealVS extension provides convenience features in Visual Studio such as making it easier to build UE projects, switching between startup projects, set command-line arguments, batch build projects, and so on. The UnrealVS extension isn't required to use Visual Studio Tools for Unreal Engine. For more information, see UnrealVS Extension.

You can install the Unreal Engine Visual Studio Integration Tool plugin via the Unreal Engine Marketplace (now called FAB) website. Search for "Visual Studio Integration Tool". The website provides instructions for installing the plugin.

If you build Unreal Engine from source, or if your project isn't compatible with Unreal Engine Marketplace plugins, install the plugin manually by cloning and installing the plugin from the GitHub vc-ue-extensions repo. See the README in the repo for installation instructions. If you have difficulty with the UE plugin, see the Troubleshooting guide.

For more information about customizations you can make to the Visual Studio IDE to work well with Unreal Engine, see the Recommended Settings section at Setting Up Visual Studio for Unreal Engine.

Check for updates

We recommend that you keep Visual Studio updated for the latest bug fixes, features, and Unreal Engine support. Updating Visual Studio doesn't require an update of Unreal Engine.

  1. From the Visual Studio main menu, select Help > Check for Updates.

    Screenshot of the Check for Updates menu in Visual Studio Help menu.

  2. If an update is available, the Visual Studio Installer shows a new version. Select Update.

    Screenshot of Visual Studio Installer with the Updates.

Next steps

Try out some of the features of the Visual Studio Tools for Unreal Engine:

Quickstart: Use Visual Studio Tools for Unreal Engine
Add Unreal Engine classes, modules, and plugins in Visual Studio
View Unreal Engine Blueprints in Visual Studio
View Unreal Engine logging in Visual Studio
View Unreal Engine macros in Visual Studio