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-blueprint-debugger.md
+18-15Lines changed: 18 additions & 15 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: "Debug Unreal Engine Blueprints in Visual Studio"
3
3
description: "Learn how to use Visual Studio's Blueprint debugger to debug Unreal Engine Blueprint code alongside C++ code."
4
-
ms.date: 06/13/2025
4
+
ms.date: 06/16/2025
5
5
ms.topic: how-to
6
6
ms.service: visual-studio
7
7
ms.subservice: unreal-engine-tools
@@ -14,28 +14,31 @@ manager: Coxford
14
14
15
15
# Debug Unreal Engine Blueprints in Visual Studio
16
16
17
-
Visual Studio improves debugging Unreal Engine projects by showing information about Unreal Engine Blueprints in the call stack and locals variable windows. This feature lets you debug Blueprint code alongside your C++ code in a unified debugging session.
17
+
Visual Studio improves debugging Unreal Engine projects by showing information about Unreal Engine Blueprints in the call stack and local variables windows. This feature lets you debug Blueprint code alongside your C++ code in a one debugging session. With this functionality, you can easily track interactions between Blueprints and C++ code, making it simpler to identify and fix bugs.
18
18
19
-
The Visual Studio Blueprint debugger support provides:
19
+
Blueprints are a visual scripting technology available in Unreal Engine for rapid prototyping and development. They can interact with C++ code and in many cases games are originally designed as Blueprints and later converted to C++ to improve performance. If you spend time converting Blueprints to C++, this functionality lets you analyze Blueprints together with C++ code to help with the conversion. This reduces the need to switch between Visual Studio and the Unreal Editor, providing a seamless debugging experience and reducing context-switching.
20
+
21
+
Visual Studio Blueprint debugger support provides:
20
22
21
23
-**Integrated call stack**: Blueprint frames appear in the same call stack as C++ frames.
22
-
-**Variable inspection**: View Blueprint node pins and their values in the Locals window.
24
+
-**Variable inspection**: View Blueprint node pins and their values appear in the local variables window.
23
25
-**Unified debugging experience**: Debug Blueprint and C++ code in the same session.
26
+
-**Breakpoint support**: Set breakpoints in C++ code called by Blueprints. This is useful when you have multiple Blueprints that can call C++ code, but you are not sure which ones do and why.
24
27
25
28
## Prerequisites
26
29
27
-
- Visual Studio 2022 with the **Game development with C++** workload and **Visual Studio debugger tools for Unreal Engine Blueprints** component installed.
30
+
- Visual Studio 2022 17.14 or later with the **Game development with C++** workload and **Visual Studio debugger tools for Unreal Engine Blueprints** component installed.
28
31
- Unreal Engine installed with debug symbols.
29
32
30
33
## Install prerequisites
31
34
32
-
Run the Visual Studio Installer to ensure you have the required components installed to debug Unreal Engine Blueprints. For more information on installing Visual Studio Tools for Unreal Engine, see [Get started with Visual Studio Tools for Unreal Engine](vs-tools-unreal-quickstart.md).
35
+
Run the Visual Studio Installer to install the required components to debug Unreal Engine Blueprints. For more information on installing Visual Studio Tools for Unreal Engine, see [Get started with Visual Studio Tools for Unreal Engine](vs-tools-unreal-quickstart.md).
33
36
34
-
1. On the **Workloads** pane, make sure the **Game development with C++** workload is installed:
37
+
1. On the **Workloads** pane, make sure the **Game development with C++** workload is installed.
35
38
36
39
:::image type="content" source="../media/vs-installer-unreal-engine-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/vs-installer-unreal-engine-workload.png":::
37
40
38
-
1. On the **Individual components** pane, also make sure the Visual Studio debugger tools for Unreal Engine Blueprints is installed:
41
+
1. On the **Individual components** pane, make sure **Visual Studio debugger tools for Unreal Engine Blueprints** is installed:
39
42
40
43
:::image type="content" source="../media/vs-unreal-engine-install-blueprints-debug-tools.png" alt-text="Screenshot of the Visual Studio installer Individual components pane. Visual Studio debugger tools for Unreal Engine Blueprints is selected.":::
41
44
@@ -44,7 +47,7 @@ Run the Visual Studio Installer to ensure you have the required components insta
44
47
Install debug symbols for each version of Unreal Engine you debug with Visual Studio:
45
48
46
49
1. Open the **Epic Games Launcher**.
47
-
1.Go to the **Unreal Engine** pane on the left and the **Library** pane at the top.
50
+
1.Select the **Unreal Engine** pane on the left and the **Library** pane at the top.
48
51
1. Select the dropdown menu for your engine version, then choose **Options**:
49
52
50
53
:::image type="content" source="../media/unreal-engine-options.png" alt-text="Screenshot of the Epic Games installer. The Launch dropdown is selected and Options is highlighted.":::
@@ -57,21 +60,21 @@ Install debug symbols for each version of Unreal Engine you debug with Visual St
57
60
58
61
## Set up a test project
59
62
60
-
To test the Blueprint debugger functionality, create a project that uses Blueprints and has C++ code. The Unreal Engine **First Person** template works well.
63
+
To test the Blueprint debugger functionality, create a project that contains Blueprints and C++ code. The Unreal Engine **First Person** template works well.
61
64
62
-
1. Open the Unreal Engine Editor and create a new **First Person Shooter** project.
65
+
1. Open the Unreal Engine Editor and create a new **First Person** project.
63
66
1. Ensure that **C++** is selected:
64
67
65
68
:::image type="content" source="../media/unreal-engine-new-project-first-person.png" alt-text="Screenshot of the Unreal Engine editor new project dialog. First Person is selected, and the BlueEpic Games installation options. Editor symbols for debugging is selected.":::
66
69
67
70
1. After creating the project, close all Unreal Editor instances.
68
-
1.Open the generated Visual Studio solution file (*.sln*).
71
+
1.In Visual Studio, open the generated Visual Studio solution file (*.sln*).
69
72
70
73
## Debug Blueprints
71
74
72
75
Follow these steps to set a breakpoint, inspect a Blueprint function, and view its node pin values:
73
76
74
-
1. In Visual Studio, locate the `AttachWeapon` method in your weapon component class. For example, if you named your project `FirstPerson`, the function is in`FirstPersonWeaponComponent.cpp`.
77
+
1. In Visual Studio, locate the `AttachWeapon` method in the weapon component class. For example, if you named your project `FirstPerson`, the function would be in the file`FirstPersonWeaponComponent.cpp`.
75
78
1. Add a breakpoint at the start of the `AttachWeapon` method. This method is called when the player picks up a weapon in the game:
76
79
77
80
:::image type="content" source="../media/vs-unreal-engine-attach-weapon-breakpoint.png" alt-text="Screenshot of the AttachWeapon function in Visual Studio. A breakpoint is on the first line of the function." lightbox="../media/vs-unreal-engine-attach-weapon-breakpoint.png":::
@@ -83,9 +86,9 @@ Follow these steps to set a breakpoint, inspect a Blueprint function, and view i
83
86
1. In Visual Studio, compile and run the project to open the Unreal Editor.
84
87
1. In the Unreal Editor, select the green **Play** button to start the game.
85
88
1. In the running game, press the <kbd>W</kbd> key to move forward until you collide with the weapon and trigger the breakpoint.
86
-
1. When the breakpoint is hit, examine the **Call Stack** window. Blueprint stack frames appear among your C++ stack frames:
89
+
1. When the breakpoint is hit, examine the **Call stack** window. Blueprint stack frames appear among your C++ stack frames:
87
90
88
-
:::image type="content" source="../media/vs-unreal-engine-blueprint-call-stack.png" alt-text="Screenshot of the callstack window in Visual Studio. The breakpoint in AttachWeapon is at the top of the callstack. Two Blueprint entries are highlight in the callstack for BP_PickUp_Rifle::ExecuteUbergraph_BP_PickUp_Rifle and BP_PickUp_Rifle::BndEvt___BP_PickUp_Rifle_TP_PickUp_K2Node_ComponentBoundEvent_1_OnPickUp_DelegateSignature." lightbox="../media/vs-unreal-engine-blueprint-call-stack.png":::
91
+
:::image type="content" source="../media/vs-unreal-engine-blueprint-call-stack.png" alt-text="Screenshot of the call stack window in Visual Studio. The breakpoint in AttachWeapon is at the top of the call stack. Two Blueprint entries are highlight in the call stack for BP_PickUp_Rifle::ExecuteUbergraph_BP_PickUp_Rifle and BP_PickUp_Rifle::BndEvt___BP_PickUp_Rifle_TP_PickUp_K2Node_ComponentBoundEvent_1_OnPickUp_DelegateSignature." lightbox="../media/vs-unreal-engine-blueprint-call-stack.png":::
89
92
90
93
1. Double-click the first Blueprint frame in the call stack.
91
94
1. Open the **Locals** window to view the variables associated with the Blueprint node. You can see the values of the Blueprint node pins:
0 commit comments