Install HealthBridge for Unreal Engine
This guide takes a new Unreal Engine project from plugin installation to a working mock-data sample. It does not require a mobile device or real health data.
Before you begin
Section titled “Before you begin”- Use Unreal Engine 5.8.
- Start with a project you can compile after adding a source plugin.
- Close the editor before changing installed plugin files.
Install the plugin
Section titled “Install the plugin”- Install HealthBridge from Fab into your project.
- Open the project and select Edit > Plugins.
- Search for HealthBridge and enable it.
- Restart the editor when requested.
- If Unreal asks to compile the plugin, allow it to build for the project.
HealthBridge is a source plugin. A project that cannot compile C++ modules must be able to build its editor target before the plugin can load.
Complete first-run setup
Section titled “Complete first-run setup”- Open Tools > HealthBridge > Setup Wizard.
- Review the mock-data settings.
- On the permissions step, select only the health types your product intends to
use. For this tutorial, enable read access for
exerciseandsteps. - Review the iOS and Android guidance even if you are not packaging yet.
- Finish the wizard.
The wizard saves settings to DefaultGame.ini. You can edit the same settings
later under Project Settings > Plugins > HealthBridge or reopen the visual
picker with Tools > HealthBridge > Permissions.
Verify the installation
Section titled “Verify the installation”- Select Tools > HealthBridge > Samples > Create Health Data Review Sample.
- Open the generated
/Game/HealthBridgeSamples/HealthDataReviewlevel. - Press Play.
- Connect in the sample and open the Workouts and Health Data tabs.
The editor uses FMockHealthProvider, so the sample should show generated
workouts and health data without opening a platform permission prompt.
Success criteria
Section titled “Success criteria”Installation is complete when:
- HealthBridge is enabled in Edit > Plugins.
- Project Settings > Plugins > HealthBridge opens successfully.
- The Health Data Review sample initializes with provider
Mock. - Mock workouts or step samples appear while playing in the editor.
