|
| 1 | +--- |
| 2 | +title: "Debug Unreal Engine Blueprints in Visual Studio" |
| 3 | +description: "Learn how to use Visual Studio's Blueprint debugger to debug Unreal Engine Blueprint code alongside C++ code." |
| 4 | +ms.date: 06/20/2025 |
| 5 | +ms.topic: how-to |
| 6 | +ms.service: visual-studio |
| 7 | +ms.subservice: unreal-engine-tools |
| 8 | +author: TylerMSFT |
| 9 | +ms.author: TWhitney |
| 10 | +manager: Coxford |
| 11 | +ai-usage: ai-assisted |
| 12 | + |
| 13 | +#customer intent: As an Unreal Engine developer, I want to debug Blueprint code alongside my c++ code in Visual Studio. |
| 14 | +--- |
| 15 | + |
| 16 | +# Debug Unreal Engine Blueprints in Visual Studio |
| 17 | + |
| 18 | +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. |
| 19 | + |
| 20 | +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. |
| 21 | + |
| 22 | +Visual Studio Blueprint debugger support provides: |
| 23 | + |
| 24 | +- **Integrated call stack**: Blueprint frames appear in the same call stack as C++ frames. |
| 25 | +- **Variable inspection**: View Blueprint node pins and their values appear in the local variables window. |
| 26 | +- **Unified debugging experience**: Debug Blueprint and C++ code in the same session. |
| 27 | +- **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 aren't sure which ones do and why. |
| 28 | + |
| 29 | +## Prerequisites |
| 30 | + |
| 31 | +- Visual Studio 2022 17.14 or later with the **Game development with C++** workload installed. |
| 32 | +- **Visual Studio debugger tools for Unreal Engine Blueprints** component. |
| 33 | +- **Visual Studio Tools for Unreal Engine** component. |
| 34 | +- Unreal Engine plugin for Visual Studio. |
| 35 | +- Unreal Engine installed with debug symbols. |
| 36 | +- Visual Studio plugin for Unreal Engine. |
| 37 | + |
| 38 | +## Install prerequisites |
| 39 | + |
| 40 | +Run the Visual Studio Installer to install the required components to debug Unreal Engine Blueprints. For more information about installing Visual Studio Tools for Unreal Engine, see [Get started with Visual Studio Tools for Unreal Engine](vs-tools-unreal-quickstart.md). |
| 41 | + |
| 42 | +- On the **Workloads** pane, make sure the **Game development with C++** workload is installed, along with **Visual Studio debugger tools for Unreal Engine Blueprints** and **Visual Studio Tools for Unreal Engine**: |
| 43 | + |
| 44 | + :::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"::: |
| 45 | + |
| 46 | +### Install Unreal Engine debug symbols |
| 47 | + |
| 48 | +Install debug symbols for each version of Unreal Engine you debug with Visual Studio: |
| 49 | + |
| 50 | +1. Open the **Epic Games Launcher**. |
| 51 | +1. Select the **Unreal Engine** pane and then the **Library** pane. |
| 52 | +1. Select the dropdown menu for your engine version, then choose **Options**: |
| 53 | + |
| 54 | + :::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."::: |
| 55 | + |
| 56 | +1. In the options dialog, select **Editor symbols for debugging**: |
| 57 | + |
| 58 | + :::image type="content" source="../media/unreal-engine-editor-symbols-for-debugging.png" alt-text="Screenshot of the Epic Games installation options. Editor symbols for debugging is selected."::: |
| 59 | + |
| 60 | +1. Select **Apply**, then wait for the download to finish. |
| 61 | + |
| 62 | +### Install Unreal Engine plugin for Visual Studio |
| 63 | + |
| 64 | +The Unreal Engine plugin for Visual Studio installs into Unreal Engine. It's automatically activated when you open an Unreal Engine project in Visual Studio. This plugin provides the necessary integration between Unreal Engine and Visual Studio to view Blueprint node pin values in the Visual Studio debugger local variables window. |
| 65 | + |
| 66 | +For manual installation instructions, see [vc-ue-extensions](https://github.com/microsoft/vc-ue-extensions). |
| 67 | + |
| 68 | +If you have an Unreal Engine project that you can open in Visual Studio, another way to install the plugin is in Visual Studio via the Unreal Engine Configuration window: |
| 69 | +- With an Unreal Engine project opened in Visual Studio, choose **Project** > **Configure Tools for Unreal Engine** to open the **Unreal Engine Integration Configuration** window. |
| 70 | +- In the **Visual Studio Integration Tool Status** section, select **Install to Project** or **Install to Engine** as meets your needs. |
| 71 | + |
| 72 | +If you don't see the install buttons, choose the refresh icon to refresh the status. If you need to install the plugin manually, select the **Manual installation instructions** link to open the [vc-ue-extensions](https://github.com/microsoft/vc-ue-extensions/blob/main/README.md) page, which contains installation instructions. |
| 73 | + |
| 74 | +:::image type="content" source="../media/vs-unreal-engine-configuration-page-plugin.png" alt-text="Screenshot of the Unreal Engine Integration Configuration window. In the Visual Studio Integration Tool Status section, the refresh, Install to Project, and Install to Engine buttons are highlighted. The Manual installation instructions link is also highlighted."::: |
| 75 | + |
| 76 | +## Set up a test project |
| 77 | + |
| 78 | +To test the Blueprint debugger functionality, create a project that contains Blueprints and C++ code. The Unreal Engine **First Person** template works well. |
| 79 | + |
| 80 | +1. Open the Unreal Engine Editor and create a new **First Person** project. |
| 81 | +1. Ensure that **C++** is selected: |
| 82 | + |
| 83 | + :::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."::: |
| 84 | + |
| 85 | +1. After creating the project, close all Unreal Editor instances. |
| 86 | +1. In Visual Studio, open the generated Visual Studio solution file (*.sln*). |
| 87 | + |
| 88 | +### Install Visual Studio plugin for Unreal Engine |
| 89 | + |
| 90 | +To support viewing node pin variables for Blueprints in the Visual Studio debugger, you also need to install the Visual Studio plugin for Unreal Engine. The plugin can be installed in either the Engine or Game project sources. It's automatically activated when an Unreal Engine project is opened in Visual Studio. For installation instructions, see [vc-ue-extensions](https://github.com/microsoft/vc-ue-extensions). |
| 91 | + |
| 92 | +## Debug Blueprints |
| 93 | + |
| 94 | +Follow these steps to set a breakpoint, inspect a Blueprint function, and view its node pin values: |
| 95 | + |
| 96 | +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`. |
| 97 | +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: |
| 98 | + |
| 99 | + :::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"::: |
| 100 | + |
| 101 | +1. In the Visual Studio **Solution Configuration** dropdown, select **Development Editor**: |
| 102 | + |
| 103 | + :::image type="content" source="../media/vs-unreal-engine-select-configuration.png" alt-text="Screenshot of the Visual Studio solution configuration dropdown. Development Editor is selected."::: |
| 104 | + |
| 105 | +1. In Visual Studio, compile and run the project to open the Unreal Editor. |
| 106 | +1. In the Unreal Editor, select the green **Play** button to start the game. |
| 107 | +1. In the running game, press the <kbd>W</kbd> key to move forward until you collide with the weapon and trigger the breakpoint. |
| 108 | +1. When the breakpoint is hit, examine the **Call stack** window. Blueprint stack frames appear among your C++ stack frames: |
| 109 | + |
| 110 | + :::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 highlighted 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"::: |
| 111 | + |
| 112 | +1. Double-click the first Blueprint frame in the call stack. |
| 113 | +1. Open the **Locals** window to view the variables associated with the Blueprint node. You can see the values of the Blueprint node pins: |
| 114 | + |
| 115 | + :::image type="content" source="../media/vs-unreal-engine-blueprint-locals-node-pins.png" alt-text="Screenshot of the locals window in Visual Studio. Blueprint information > Node Pins > Available pins is expanded to show the values of the Blueprint such as the EntryPoint, PickUpCharacter, HasRifle, and more." lightbox="../media/vs-unreal-engine-blueprint-locals-node-pins.png"::: |
| 116 | + |
| 117 | +## Summary |
| 118 | + |
| 119 | +The Visual Studio Blueprint debugger provides a seamless debugging experience that bridges the gap between C++ and Blueprint code in Unreal Engine projects. This integrated approach allows you to: |
| 120 | + |
| 121 | +- Track execution flow from C++ to Blueprints and back. |
| 122 | +- Inspect Blueprint variables, node pin values, and C++ variables. |
| 123 | +- Step through Blueprint execution frames in the same debugging session as C++ code. |
| 124 | + |
| 125 | +This unified debugging experience helps resolve issues efficiently across both coding paradigms, eliminating the need to switch between different debugging tools. |
| 126 | + |
| 127 | +## Related articles |
| 128 | + |
| 129 | +- [Visual Studio Tools for Unreal Engine overview](vs-tools-unreal-overview.md) |
| 130 | +- [Get started with Visual Studio Tools for Unreal Engine](vs-tools-unreal-quickstart.md) |
| 131 | +- [View Blueprints in Visual Studio](vs-tools-unreal-view-blueprints.md) |
![learn-build-service-prod[bot]](https://avatars.githubusercontent.com/in/237442?v=4&size=40){kind=avatar}
0 commit comments