UnrealVS Extension

Guide for installing, setting up, and using the UnrealVS extension for Visual Studio.


The UnrealVS extension for Visual Studio provides easy access to common actions when developing with Unreal Engine 4. This document will explain how to install the extension, as well as how to use it with your project.

Features include:

  • Setting the Startup Project

  • Bindable command for building the Startup Project

  • Setting the command line arguments

  • Batch building projects

  • Quick Build project menu

The UnrealVS extension does not work with Visual Studio Express. It is only compatible with Visual Studio Community and Professional editions.

Installation and Setup

To install the UnrealVS extension:

  1. Find the extension for your version of Visual Studio located at:


  2. Run the UnrealVS.vsix file by double-clicking it to begin the installation.

  3. UnrealVS extensions target specific Visual Studio versions. Check that the installer is targeting your version and that the box is ticked then click the Install button to proceed.


  4. Click the Close button once the installation is complete.

    Install Complete

  5. Run Visual Studio and in Tools > Extensions and Updates... you should see the extension.

    Extension Manager

    If Visual Studio is already running, you will need to restart before the extension will be loaded and displayed. The extension is also shown in the Installed Products list in the Help > About Microsoft Visual Studio dialog.

  6. Go to View > Toolbars or Right-click the Visual Studio toolbar area and select UnrealVS to display the extension's toolbar.

    UnrealVS Toolbar

  7. By default, the toolbar appears as above but its contents can be customized via the Tools > Customize... by choosing the UnrealVS toolbar in the Commands tab.

    UnrealVS Customize Toolbar

  8. In the Customize dialog, choose Add Command... and select UnrealVS from the Categories list to see a list of UnrealVS commands that can be added to the toolbar. When you've finished adding commands, click OK.

    UnrealVS Customize Commands

Setting the Startup Project

The Startup Project dropdown is a means of quickly setting or switching between startup projects. It automatically lists all available projects that build executables in the solution. Selecting a project from the list sets that as the current startup project.


You can change which projects are listed in the UnrealVS options. To show only Game projects, go to Tools > Options... and select UnrealVS. Click the dropdown next to Hide Non-Game Startup Projects and select True. Then click OK.

Set Startup Project

Building the Startup Project

The extension also contains a command for building the current startup project which can be bound to a hotkey or other means of running custom commands.

Binding the Command to a Hotkey

  1. Go to Tools > Options... and select Keyboard under the Environment tree. Under Apply the following additional keyboard mapping scheme click the dropdown and select Visual C++ 6.

  2. Select the UnrealVS.BuildStartupProject command in the commands list.

    Filtered Command List

    Type "Unreal" in the search box to filter the list.

  3. With the command selected, click in the Press Shortcut Keys box and then press the combination of keys you want to use to perform the command (for example, Ctrl + Alt + Shift + B is shown in the example below).

    Shortcut Keys

    You should choose a combination of keys not already assigned to another command. The Shortcut currently used by box will alert you to the fact that the chosen combination is already in use.

  4. Press the Assign button to bind the keys to the command. The key combination is displayed under Shortcuts for selected command.

    Assigned Keys

  5. Press the OK button to save the changes. Now, when you use the shortcut, the project set as the startup project will automatically build.

Iterating on a Single Source File

If you're used to iterating on updates to a single source (.cpp) file using Ctrl+F7 in Visual Studio, you can bind Ctrl+F7 to the UnrealVS.CompileSingleFile command, which builds your active project with the current solution configuration, platform, and the -singlefile=<Path to currently open file> argument.

Command Line Arguments

The Command-Line control is used to set the Command Arguments for the current project when running a debugging session. This is a shortcut, rather than setting them through the project Properties. In fact, changes made here will be reflected automatically in the Properties.

Enter the arguments in the text box, or choose from a list of recent arguments using the dropdown list. These arguments will be passed to the executable when a debugging session is started.

Command Arguments

Project configurations for game projects that build Unreal Editor add the project name to the command line automatically, to tell the editor executable which project you are using. For example, if you build QAGame using the build config 'Debug Editor', the command line will have QAGame.uproject added to the command arguments without the need to type it in the box. To launch the editor for QAGame, you can leave the Command-Line control empty and the editor will still know which project you are running.

See Command-Line Arguments for a listing of all available arguments.

Refresh Projects

Project files can be generated inside of Visual Studio using the Automatic Project File Generation. This makes it much quicker to sync and update all the project files, since you do not have to navigate to the .bat file and run it manually.

To refresh project files:

  1. Press the Refresh Projects button on the UnrealVS toolbar.


  2. The project generation process will be displayed in the Output window as it occurs.

    Project Generator Output

  3. Reload any projects that require it, as you are prompted.

Batch Builder

UnrealVS Batch Builder provides a way to create and run custom sets of build jobs. It is more versatile than the Build > Batch Build... option in Visual Studio.

To open the Batch Builder window:

  1. Press the Batch Builder button on the UnrealVS toolbar or use a keyboard shortcut that you have assigned to the command UnrealVS.BatchBuilder (see Build Startup Project above for instructions on setting up keyboard shortcuts with UnrealVS commands).

    Batch Builder

  2. The UnrealVS Batch Builder window appears.

    Batch Builder Window

    • Create a Build Job by selecting from the Project, Config, Platform, and then clicking the radio button for the job type.

    • Add/remove jobs with the > and < buttons.

    • In the Build Jobs list, move selected jobs up or down the list with the arrow buttons on the right.

    • Select the Job Set you want to edit in the dropdown under the Build Jobs list.

    • To create a new Job Set, type a new name into the field.

    • The Delete button deletes the selected Job Set from the list.

    • Start or Stop the batch build task on the current Job Set with the Start button.

    • Job Sets are stored for next time in the .suo file for the loaded solution.

  3. When you click Start, the Output tab displays, showing the progress of the batch build.

    Batch Builder Window running

    The Build Jobs in the running set are shown in the output list. The current executing build job is shown in bold.

    • Queued Build Job = Queued job

    • Succeeded Build Job = Job complete, succeeded

    • Failed Build Job = Failed job

    • Cancelled Build Job = Cancelled job

    A busy animation, and the Stop button, are shown when a batch build is running.

  4. You can view the output from individual Build Jobs by double-clicking an item in the Output tab, or by right-clicking and selecting Show Output from the context menu.

    BatchBuild Output Pane

    Batch Builder output for individual items is shown in the Visual Studio Output window, in a pane named UnrealVS - BatchBuild. This is not to be confused with the Build pane that shows the output of the current/last build job.

Quick Build Menu

The Quick Build menu provides an easy way to build a project using any config and platform combination, without having to change the main solution build config.

Quick Build Menu

  1. Right-click a Project node in the Solution Explorer.

  2. The UnrealVS Quick Build menu contains sub-menus for the available platforms, and build configs, in the Unreal Engine solution.

  3. Select an item to build the selected project, platform, and config. This method is much quicker than changing the Solution Configuration and Solution Platform in the IDE, starting a build, then switching the config and platform back again.

Working with the UnrealVS Source Code

UnrealVS source code is located in the [UE4RootLocation]/Engine/Source/Programs/UnrealVS/ folder.

In order to load the UnrealVS project files with Visual Studio, you will need to have the Visual Studio SDK installed for the appropriate version of Visual Studio that UnrealVS is to be compiled with. For example, when supporting up to Visual Studio 2015, you will need to install the Visual Studio 2015 SDK, then load UnrealVS project files into Visual Studio 2015.

Выбрать тему

Добро пожаловать на новый сайт документации Unreal Engine 4!

Мы работаем над множеством новых функций, включая систему обратной связи, чтобы вы могли рассказать нам, о том, что мы делаем. Этот вариант не совсем готов для использования в конечном релизе, поэтому перейдите на форум обратной связи по документации, чтобы рассказать нам о проблемах с этой страницей или написать нам о любых проблемах, с которыми вы сталкиваетесь в работе с документацией.

Мы обязательно сообщим вам, когда новая система будет запущена.

Отправить отзыв