Skip to main content
TikTok Effect House Platform Logo
Log in
Tracking and Detection

Body Avatar Drive

Body Avatar Drive allows you to control a 3D character with your body movement.

Add a Body Avatar Drive Object

Go to the Hierarchy panel and click the Add button [+] > AR Tracking > Body Avatar Drive. Body Avatar Drive maps the movement of the key points of your body that are recognized by the camera to the movement of the key joints of the model under the Body Avatar Drive object.

Object Hierarchy

Starting in Effect House v2.0.0, the Body Avatar Drive object is automatically added to the Effects render group in the Hierarchy panel. Learn more about render groups.

Prepare a 3D Character Model

To prepare your 3D character model for Body Avatar Drive, you must be mindful of the rigging, naming convention, and hierarchy of your model.

Character Rigging

Rigging can take a lot of time. You can download the BodyRigTemplate and use it as a reference for the key points of a 3D body.


If you want to use the automatic map provided by the Body Avatar Drive component, you can do the following:

  1. Name your joints the same as the image shown below.
  2. Order the joints hierarchy the same as the image shown below.

It is recommend that you use some automation rigging tool, like Autodesk® Maya® or Adobe® Mixamo®. Adobe® Mixamo® technology uses machine learning methods to automate the steps of the character animation process, including 3D modeling, rigging, and 3D animating.

When creating a Body Avatar Drive model in Adobe® Mixamo®, you must consider the following for the best results:

  • Export the Skeleton LOD with a value of less than 50.
  • When exporting a model with an animation into Effect House, you must remove the Mixamo playback animation component when dragging the model into the scene.

Import a 3D Model

You can import assets by dragging them to the Assets panel or clicking + > Import > From Computer.

Add a 3D Model to the Hierarchy panel

Loop the model under the Body Avatar Drive object you created.

Configure a Body Avatar Drive Component

Click the Match Rigging button of the Body Avatar Drive component. It will fill or refresh the joints that match to a specific part of the human body based on the names of the joints.


You can also manually drag the joint model to the specific slots.

Now you can try to control your avatar!

Body Avatar Drive Properties

Follow Body Position: If selected, the object’s Transform follows your body movement. If unselected, you can modify the object’s Transform. This is selected by default.

Match Rigging: By clicking this button, the Body Avatar Drive component will fill or refresh the joints that match to a specific part of the human body based on the names of the joints.

Advanced Settings:

  • You can use the automatic match by clicking the Match Rigging button, or manually drag the joint object from the avatar model in the Hierarchy panel to the corresponding joint slots based on its name.

Demo Effect: Character Drive

Check out this tutorial to learn how to use the Character Drive template to apply your position and rotation of joints onto the character.

Demo Effect: Control the Character Drive With the Body Detection Node in Visual Scripting

The Body Detection node detects if there’s a body in the camera view to set up related interactions. Learn more about the Body Detection Visual Scripting node.

For example, set a basic interaction. If a full body is not detected, make the alien avatar invisible. If a full-body is detected, display the character at the bottom of frame and match the user’s movements.

Demo Effect: Clothing Try On

Check out this tutorial to use the Body Avatar Drive component to create a try on effect.