How to Convert a Blueprint Only Project to a C++ Project (using Windows)

This document covers how to convert a Blueprint Only project to a C++ project without writing any C++ code using Windows. This isn't intended to fold down your Blueprint Logic to C++, it is meant only to wrap your Blueprint Project with a C++ project. Some plugins and engine features require a C++ project and this is an easy way to still work in Blueprints but not be constrained by this limitation.

Requirements

  • For 4.9.X or older, you need Visual Studio Community Edition 2013
  • For 4.10 or newer, you need Visual Studio Community Edition 2015
    • Make sure you install Visual C++. 2015 doesn't do this by default
    • During installation, choose Custom, not Typical
    • Make sure Visual C++ and all children are selected
    • If you skipped installing Visual C++ and Unreal Engine 4 is complaining about not being able to find it, you can fix this by: re-running the downloaded installer and choosing "Modify", then selecting Visual C++ and clicking "Update".

Convert Process

  1. Open Your Project in the Unreal Engine 4 Editor.
  2. Open up the New C++ Class Dialog by using File -> New C++ Class...
  3. Choose a new "None" class and hit "Create Class."
  4. You may be prompted with a warning message about being able to compile the game module. You can safely ignore this and hit No.
  5. Close any pop-ups, warnings, or success notifications, then close the Editor.
  6. Navigate to your project's folder, right click your project's .uproject file, and click "Generate Visual Studio project files."
  7. Open your project in Visual Studio by double-clicking your project's .sln file.
  8. Visual Studio should load. If it asks you what theme you would like, pick what looks best to you. I prefer the Dark theme.
  9. Find and select your project in Visual Studio's Solution Explorer.
  10. Set the build configuration drop down to "Development Editor"
  11. Right-click your project in the Solution Explorer and click Build.
  12. This should result in your project being compiled successfully with zero errors.
  13. Set the build configuration drop down to "Development".
  14. Right-click your project in the Solution Explorer and click Build, again.
  15. This build will take much longer, on the order of several minutes. This should result in your project being compiled successfully with zero errors though, again.

Finished

Your Blueprint Project is now a C++ Project. You are able to open up your project just as before and nothing has changed in terms of your project's functionality, but you are now able to use Engine features that require C++ Projects, such as third-party plugins, Subsystem integrations, dedicated servers, etc. You shouldn't have to open Visual Studio ever again unless you do some C++ code, but you still have to keep Visual Studio installed.