The Leap Motion Unreal plugin provides an easy, blueprint-friendly way to add motion-controlled 3D hands to an Unreal game. The philosophy behind this plugin is that it is easier to interact with a 3D world using Unreal hand models, physics, and colliders than by interpreting the somewhat abstract tracking data straight from the Leap Motion API. This approach works especially well with virtual- and augmented-reality applications where it is much easier for the user to comprehend the positions of their model hands in a simulated 3D space. The approach can work well on standard applications too, but you must take more care to provide sufficient depth cueing because of the often visually ambiguous relation between 3D objects displayed on a 2D display.
- Leap Motion 2.2+
- Unreal Engine 4.9
- Windows 7, Windows 8 (Mac and Linux not supported at this time)
The plugin is included with Unreal Engine 4.9. No installation is required.
In Unreal 4.7, the plugin is only available as part of the Unreal Engine Full Source distribution. To use the plugin in Unreal 4.7, you must download and build Unreal Engine 4.7. Note: The plugin has a bug in Unreal Engine 4.8 that causes hand jitter. We recommend either using Unreal Engine 4.9 or building the 4.7 branch.
To use the plugin in a project, it must first be enabled:
Open the project in the Unreal Editor.
Open the Unreal Plugins browser: Menu Edit > Plugins.
Find the Leap Motion plugin under Input Devices.
Check Enabled to activate the plugin.
Close and re-open the project.
In addition, to see hands in a level, you must have the Leap Motion service software installed and a Leap Motion hardware device plugged in.
Note that before building a package for a project, you must add at least one C++ class to it – even if that class is unused and empty. Adding this class triggers the running of the necessary build steps.
If you do not see hands after adding the Leap Motion Controller Actor class or the controller component to a level and pressing play, check the following:
Leap Motion API features not supported in Blueprints:
This plugin does not attempt to make every feature of the Leap Motion API readily available. For a more hands-on approach, you may want to check out the independent, community-created Unreal plugin for Leap Motion, available here: https://github.com/getnamo/leap-ue4. You can also access the Leap Motion API directly using C++.