Ergonomic Puppet

This page will tell you everything you need to add a puppet to your scene and to manipulate it.

Beta feature

As of version 2025.1, this Puppet feature is in Beta. More features and improvements will be added in the future, so make sure to give us your feedback!

Add a puppet to your scene

To add a puppet to your scene, simply click on INTERACT > Ergonomics > Add Ergo Puppet.

Collisions

You can set the collision group of your puppet by changing the "Collision Group" property of the Puppet Manikin Manager script on the ErgoPuppet GameObject.

Ergonomic assessment panel

With the puppet comes the ergonomic assessment panel, an overlay for the Gameview indicating the posture RULA score of the puppet (not visible in VR). This overlay is located in the top-right corner of the screen.

Multiple puppets

If you add several puppets, only the last one will be linked to this overlay

Add a puppet in VR

If there is no puppet in your scene, you can click the "Puppet" button in your VR Menu.

If there is one puppet in your scene, this button changes to "Reset Puppet" and allows to reset the puppet, repositioning it in T-pose near the origin of your scene.

Collision group

If you reset a puppet you previously set up with a collision group, the collision group will be lost.

Multiple puppets

If there is two or more puppets in your scene, this button will be disabled.

Move and manipulate the puppet

The puppet is conceived to be moved with the laser, but manipulated with direct interaction (simply grabbing the articulations)

Position the puppet

To position the puppet, simply use the platform located at its feet with the laser.

By grabbing the inner disc, you can freely move the platform, which snaps to surfaces. The puppet follows the platform.

By grabbing the torus, you can rotate the puppet by rotating your wrist.

Manipulate the puppet

Warning

Although it is possible to manipulate the puppet with the laser, we do not recommend it. It is, for now, not designed to allow an easy manipulation.

To manipulate the puppet, simply grab the articulation targets (the blue spheres). From there, you can move them and rotate them, and this will also influence the extremity involved.

Waist manipulation

The waist target behaves a bit differently from the other targets.

When grabbing the waist, the knees will weld to world, allowing to sit the puppet or bend its torso easily.

Laser manipulation

Reminder : we do not recommend using the laser on the articulations targets.

However, if you laser-grab the waist, it will behave like the other targets, and you will be able to move the puppet in the 3 dimensions.

Change the puppet gaze direction

To change the direction in which the puppet is looking, simply laser-grab and move the grey sphere.

Automatic target repositioning

If you put the sphere too far (more than one meter from the head), its position will update so that it stays at one meter. The gaze direction is not affected by this.