This repository contains an Axis Studio BVH Broadcast decoder for Godot that can drive avatars through the XR Tracker system.
Official releases are tagged and can be found here.
The following branches are in active development:
| Branch | Description | Godot version |
|---|---|---|
| master | Current development branch | Godot 4.3-dev6+ |
Axis Studio is a Motion Capture package by Perception Neuron.
The following steps show how to add the Godot Axis Studio tracker to a project.
The addon files needs to be copied to the /addons/godot_axis_studio_tracker folder of the Godot project, and then enabled in Plugins under the Project Settings:
The plugin has numerous options to control behavior:
| Option | Description |
|---|---|
| Tracking - Position Mode | Controls the position of the character: - Free = Free Movement - Calibrate = Calibrate to origin on first frame - Locked = Lock to origin |
| Tracking - Body Tracker Name | Name for the XRBodyTracker |
| Network - Udp Listener Port | Port to listen for BVH network packets |
The character model must be in Godot Humanoid format. This can be achieved in the importer settings by retarteting the skeleton to the SkeletonProfileHumanoid bone map:
The body is positioned using an XRNode3D node configured to track the character body:
The body is driven using an XRBodyModifier3D node configured to drive the skeleton of the character:
Note that the Body Tracker name should match the Body Tracker Name specified in the Plugin Settings.
Axis Studio must be configured for BVH broadcasting.
| Option | Description |
|---|---|
| Skeleton | Use the standard Axis Studio Skeleton |
| Rotation | Use YXZ |
| Displacement | Enable |
| Frame Type | Binary |
| Protocol | UDP |
| Destination Address | 255.255.255.255 (broadcast) |
| Destination Port | 7004 (default) |
Code in this repository is licensed under the MIT license.
This repository was created by Malcolm Nixon
It is primarily maintained by:
For further contributors please see CONTRIBUTORS.md