Download Epic Games Launcher from unreal.com. While the Unreal Engine is open source and free to download, registration is still required. Run Epic Games Launcher, switch to Library tab on the left, click on the "Add Versions" which should show the option to download Unreal 4.16 as shown below. If you have multiple versions of Unreal installed then make sure 4.16 is "Current" by clicking down arrow next to the Launch button for the version.
Note: Older versions of Unreal is not supported. Please see guide to upgrade your projects.
- You need Visual Studio 2015 Update 3 (make sure to install VC++) or newer. Other versions haven't been tested.
- Start VS2015 x64 Native Tools Command Prompt. Create a folder for repo and run
git clone https://github.com/Microsoft/AirSim.git
. - Install cmake which is used to build the rpclib submodule.
- Run
build.cmd
from the command line. This will create ready to use plugin bits inUnreal\Plugins
folder that can be dropped in to any Unreal projects.
Remote control is required if you want to fly manually. See remote control setup for more details. Alternatively you can use APIs for programmatic control or use so-called Computer Vision mode to move around using keyboard.
Finally, you need Unreal project that hosts the environment for your vehicles. AirSim comes with built-in "Blocks Environment" or you can create your own. Please see setting up Unreal Environment.
By default, AirSim uses its own built-in firmware called simple_flight. There is no additional setup if you just want to go with it. If you want to switch to using PX4 instead then please see this guide.
Known working config is:
Windows 10 (Education) x64
VS2015 update 3 (x86) with VC++
Cmake 3.7 (x86)
Even though cmake 3.7 says it added support for VS 2017 folks are reporting build issues with that.