You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: gamedev/unreal/get-started/vs-tools-unreal-install.md
+14-19Lines changed: 14 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: "Install Visual Studio Tools for Unreal Engine"
3
3
description: "Learn how to connect Unreal Engine and Visual Studio. Visual Studio Tools for Unreal Engine offers support for writing and debugging C++ Unreal Engine games."
4
-
ms.date: 10/30/2024
4
+
ms.date: 05/27/2025
5
5
ms.service: visual-studio
6
6
ms.subservice: unreal-engine-tools
7
7
ms.topic: get-started
@@ -19,45 +19,40 @@ This article helps you install Visual Studio Tools for Unreal Engine (UE). These
19
19
- View and expand UE macros
20
20
- View and find references to UE Blueprints<sup>*</sup>
21
21
22
-
<sup>*</sup>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.
22
+
<sup>*</sup>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.
23
23
24
24
## Prerequisites
25
25
26
-
You should have the following installed before you install Visual Studio Tools for Unreal Engine:
26
+
Install the following before you install Visual Studio Tools for Unreal Engine:
27
27
28
28
- Visual Studio version 17.7 or later. To install, see [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)
29
29
- Unreal Engine version 4.27 or 5.0 or later. To install, see [Download instructions](https://www.unrealengine.com/download)
30
30
31
31
## Installation
32
32
33
-
This article covers installing two tools that connect Visual Studio and Unreal Engine:
33
+
This article covers installing tools to enhance writing and debugging Unreal Engine code in Visual Studio:
34
34
35
-
-**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.
36
-
-**Unreal Engine Visual Studio Integration Tool plugin** is installed into Unreal Engine via the Unreal Engine Marketplace (now called FAB) 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.
35
+
-**Visual Studio Tools for Unreal Engine**: Add Unreal Engine (UE) classes, modules, view UE logging, see UE macro expansions, find blueprint references, and so on in Visual Studio.
36
+
-**Unreal Engine Test Adapter**: Discover, run, manage, and debug your Unreal Engine tests from within Visual Studio.
37
+
-**Visual Studio debugger tools for Unreal Engine Blueprints**: See information about Unreal Engine Blueprints while debugging.
37
38
38
-
To install Visual Studio Tools for Unreal Engine:
39
+
Follow these steps to install the tools:
39
40
40
41
1. In the Windows search box, type "Visual Studio Installer".
41
42
1. Look for the installer under the Apps results and double-click it.
42
43
1. When the installer appears, select the version of Visual Studio you're using and then select **Modify**.
43
44
1. Select the **Workloads** tab, then select the **Game development with C++** workload.
44
-
1. 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.
45
+
1. In the **Installations details** pane, ensure that under **Game development with C++** > **Optional** that the following are selected:
46
+
-**Visual Studio Tools for Unreal Engine**
47
+
-**Visual Studio debugger tools for Unreal Engine Blueprints**
48
+
-**Unreal Engine Test Adapter**
49
+
- If you work with High-Level Shader Language (HLSL) files, ensure that **HLSL Tools** is also selected.
45
50
1. Select the **Individual components** tab at the top of the dialog.
46
51
1. Under **Installation details** on the right, expand **Game development with C++**.
47
52
1. Ensure that under **Optional** that **Windows 10 SDK 10.0.18362.0**, or higher, is selected.
48
53
1. Select **Modify** to complete the installation.
49
54
50
-
:::image type="content" source="../media/unreal-workload.png" alt-text="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." lightbox="../media/unreal-workload.png":::
51
-
52
-
## Configure Unreal Engine to use Visual Studio
53
-
54
-
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](https://docs.unrealengine.com/using-the-unrealvs-extension-for-unreal-engine-cplusplus-projects/).
55
-
56
-
You can install the Unreal Engine Visual Studio Integration Tool plugin via the [Unreal Engine Marketplace (now called FAB)](https://aka.ms/vsituemarketplace) website. Search for "Visual Studio Integration Tool". The website provides instructions for installing the plugin.
57
-
58
-
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](https://aka.ms/vc-ue-extensions). See the [README](https://github.com/microsoft/vc-ue-extensions#unreal-engine-plugin-for-visual-studio) in the repo for installation instructions. If you have difficulty with the UE plugin, see the [Troubleshooting guide](https://github.com/microsoft/vc-ue-extensions/blob/main/Docs/Troubleshooting.md).
59
-
60
-
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](https://docs.unrealengine.com/en-US/setting-up-visual-studio-development-environment-for-cplusplus-projects-in-unreal-engine/).
55
+
:::image type="content" source="../media/unreal-workload.png" alt-text="Screenshot of the Visual Studio installer. The Game development with C++ workload is selected. In the installation details pane, Visual Studio Tools for Unreal Engine, Visual Studio debugger tools for Unreal Engine Blueprints, HSL Tools, And Windows 11 SDK are selected." lightbox="../media/unreal-workload.png":::
0 commit comments