Documentation Home
Breadcrumbs

Manikins

Manikins

Skyreal VR provides a powerful manikin simulation system powered by MetaHuman technology. This page covers how to work with manikins in extensions — importing them in Unreal Editor, creating custom appearances, and extending the MSD analyzer system.

Import a Manikin in Unreal Editor

Ensure your project has the SkrManikinDataModelPlugin and SkrUtilities plugins enabled.

Adding a Manikin to the Scene

  1. In the Content Browser, enable Show Plugin Content in the Settings menu.

  2. Navigate to SkrManikinDataModelPlugin Content > ManikinBase.

  3. Select BP_SkrManikin and drag it into the scene viewport.

[IMAGE: Add manikin to scene — original at /pictures/v1.16/Manikin_UEAddToScene.png]

  1. Select the actor and go to the Details panel > Skr > Manikin section.

  2. Set the Manikin Description for a custom appearance.

[IMAGE: Manikin description — original at /pictures/v1.16/Manikin_UEAddDescription.png]

Available properties:

Property

Description

Size Mode

Initial keeps MetaHuman original height; Fixed uses the specified Height Target

Logo

Edit the logo visible on the manikin's back

Toggle Vision Field

Display the green vision field light

Toggle MSD Body

Display or hide MSD notation mesh

Save Report MSD

Create a JSON report in the project Saved directory

[IMAGE: Manikin details panel — original at /pictures/v1.16/Manikin_UEDetails.png]

Editing Manikin Posture

  • Select the manikin by clicking the white circle representing its ground position.

  • Double-click on effectors to display a compass for posture editing.

  • Enable Realtime in the 3D viewport menu if the posture doesn't update.

[IMAGE: Edit manikin effectors — original at /pictures/v1.16/Manikin_UEEditEffector.png]

Grabbing Objects

  1. Select the hand effector with double-click.

  2. Set Effector Status to Snap to Actor.

  3. Set Actor to Snap to to the target object.

  4. Set Skr Hand State to Tracked Finger.

  5. Set Actor to Grab to the same target object.

[IMAGE: Snap hand to object — original at /pictures/v1.16/Manikin_UESnapHand.png]

Fine-tune finger placement using mesh socket positions in the Socket Manager.

[IMAGE: Edit mesh sockets — original at /pictures/v1.16/Manikin_UEEditSockets.png]

Importing Custom MetaHuman Manikins

  1. Go to metahuman.unrealengine.com and create a new MetaHuman.

[IMAGE: MetaHuman Creator — original at /pictures/v1.16/Manikin_ExtensionMetaHuman.png]

  1. In your Unreal project, open Quixel Bridge and connect your Epic Games account.

[IMAGE: Quixel Bridge — original at /pictures/v1.16/Manikin_ExtensionQuixelBridge.png]

  1. Find your MetaHuman in the MetaHumans tab, download it, and export to your scene.

[IMAGE: Select MetaHuman — original at /pictures/v1.16/Manikin_ExtensionQuixelBridgePickMetaHuman.png]

  1. Move the MetaHuman folder into your extension plugin content.

  2. Right-click the MetaHuman blueprint and select Convert to Skr Manikin Description.

[IMAGE: Convert to Skr Manikin Description — original at /pictures/v1.16/Manikin_ExtensionCreateDescription.png]

  1. Move the created data asset to RegistrableAssets. Fill the Image, Name, and check Auto Register Description.

[IMAGE: Fill manikin description — original at /pictures/v1.16/Manikin_ExtensionFillDescription.png]

  1. Package and cook your extension. Copy the Common MetaHuman directory from the cooked output into the Skyreal VR installation Content\\MetaHumans directory (use Merge).