Skip to content

Commit 0618b31

Browse files
authored
new installation path (#13948)
* new installation path * update installation flow * edit
1 parent 84ccf5d commit 0618b31

File tree

3 files changed

+14
-19
lines changed

3 files changed

+14
-19
lines changed

gamedev/unreal/get-started/vs-tools-unreal-install.md

Lines changed: 14 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Install Visual Studio Tools for Unreal Engine"
33
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
55
ms.service: visual-studio
66
ms.subservice: unreal-engine-tools
77
ms.topic: get-started
@@ -19,45 +19,40 @@ This article helps you install Visual Studio Tools for Unreal Engine (UE). These
1919
- View and expand UE macros
2020
- View and find references to UE Blueprints<sup>*</sup>
2121

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.
2323

2424
## Prerequisites
2525

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:
2727

2828
- Visual Studio version 17.7 or later. To install, see [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)
2929
- Unreal Engine version 4.27 or 5.0 or later. To install, see [Download instructions](https://www.unrealengine.com/download)
3030

3131
## Installation
3232

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:
3434

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.
3738

38-
To install Visual Studio Tools for Unreal Engine:
39+
Follow these steps to install the tools:
3940

4041
1. In the Windows search box, type "Visual Studio Installer".
4142
1. Look for the installer under the Apps results and double-click it.
4243
1. When the installer appears, select the version of Visual Studio you're using and then select **Modify**.
4344
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.
4550
1. Select the **Individual components** tab at the top of the dialog.
4651
1. Under **Installation details** on the right, expand **Game development with C++**.
4752
1. Ensure that under **Optional** that **Windows 10 SDK 10.0.18362.0**, or higher, is selected.
4853
1. Select **Modify** to complete the installation.
4954

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":::
6156

6257
## Check for updates
6358

52.7 KB
Loading
3.17 KB
Loading

0 commit comments

Comments
 (0)