update vicon

Author: TigerHix

docs/mocap/motionbuilder.md

@@ -8,7 +8,7 @@ sidebar_position: 510
 This feature is only available in [Warudo Pro](../pro).
 :::
 
-Body tracking via [Autodesk MotionBuilder](https://www.autodesk.com/products/motionbuilder/), enabling you to receive motion data from optical motion capture systems (e.g., [Vicon](https://www.vicon.com/), [OptiTrack](https://optitrack.com/)) that has Autodesk MotionBuilder integration.
+Body tracking via [Autodesk MotionBuilder](https://www.autodesk.com/products/motionbuilder/), enabling you to receive motion data from professional (usually optical) motion capture systems (e.g., [Vicon](https://www.vicon.com/), [OptiTrack](https://optitrack.com/)) that has Autodesk MotionBuilder integration.
 
 In addition to character tracking, prop tracking is also supported. For example, you may want to track a chair or a handheld camera using your optical tracking system and stream the motion data to Warudo, animating a chair prop or camera in Warudo accordingly.
 

docs/mocap/optitrack.md

@@ -24,7 +24,7 @@ To connect OptiTrack Motive to Warudo, please enable **Streaming** in OptiTrack
 
 ![](/doc-img/en-optitrack-2.png)
 
-In the **OptiTrack Skeleton Receiver** asset, make sure the name matches the one in OptiTrack Motive:
+Then, use the [Onboarding Assistant](../tutorials/readme-1) (or run **Character → Setup Motion Capture**) and select **OptiTrack Motive** for pose tracking. After the setup is complete, you should be able to see an **OptiTrack Skeleton Receiver** asset in your scene. Make sure the **OptiTrack Skeleton Name** field matches the one in OptiTrack Motive:
 
 ![](/doc-img/en-optitrack-3.png)
 

docs/mocap/overview.md

@@ -25,9 +25,10 @@ Whether you are streaming at home or at a professional mocap studio, Warudo has
 
 [Warudo Pro](../pro.md) also supports the following motion capture systems:
 
-* Any optical tracking system compatible with [Autodesk MotionBuilder](./motionbuilder), e.g., [Vicon](https://www.vicon.com/), [OptiTrack](https://optitrack.com/)
+* [Vicon Shogun](./vicon)
 * [OptiTrack Motive](./optitrack)
 * [Chingmu Avatar](./chingmu)
+* Any tracking system compatible with [Autodesk MotionBuilder](./motionbuilder)
 
 ## What motion capture systems should I use?
 

docs/mocap/vicon.md

@@ -2,58 +2,62 @@
 sidebar_position: 512
 ---
 
-# Vicon Shogun Live
+# Vicon Shogun
 
 :::info
 This feature is only available in [Warudo Pro](../pro).
 :::
 
-Body tracking via [Vicon Shogun Live](https://www.vicon.com/software/shogun-live/). Requires access to a Vicon optical tracking system and the DataStream SDK runtime.
+Body tracking via [Vicon Shogun](https://www.vicon.com/software/shogun/). Requires access to a [Vicon](https://www.vicon.com) optical tracking system.
 
-In addition to character tracking, prop tracking is also supported. You can, for example, stream a tracked camera, handheld prop, or stage marker from Shogun Live and animate the corresponding Warudo prop or camera in real time.
+In addition to character tracking, prop tracking is also supported. You can, for example, stream a tracked camera, handheld prop, or stage marker from Shogun and animate the corresponding Warudo prop or camera in real time.
 
 ## Setup
 
-In Warudo, go to **Menu → Settings → Vicon**. Confirm the **Server Address** points to the PC running Shogun Live (for example `192.168.1.50:801`). If Warudo and Shogun Live run on the same machine, you can keep the default `localhost:801`. Enable **Use Pre Fetch** if you would like Vicon's DataStream client to request data ahead of time to minimize dropped frames on busy networks.
+In Warudo, go to **Menu → Settings → Vicon**. Confirm the **Server Address** points to the PC running Shogun (for example `192.168.1.50:801`). If Warudo and Shogun run on the same machine, you can keep the default `localhost:801`.
 
-Set **Enabled** to Yes. You should see a status message that says "Connected to Vicon system" once Warudo establishes the DataStream connection.
+Set **Enabled** to Yes. You should see a status message that says "Connected to Vicon Shogun" once Warudo establishes the connection.
+
+![](/doc-img/en-vicon-1.jpg)
 
 ### Character Tracking
 
-1. In Shogun Live, expand **System → Local Vicon System → DataStream** and enable streaming. Set the transport to **Unicast** and enter the IP address of the Warudo PC in the client list if prompted.
-2. Verify that your subject is labeled in Shogun Live (for example `Subject1`). The DataStream uses the subject name to publish skeleton data.
-3. In Warudo, create a **Vicon Receiver** asset (or run **Character → Setup Motion Capture** and select **Vicon Shogun Live**). Set **Vicon Character Name** to match the subject name in Shogun Live. Once the plugin connects, Warudo will automatically bind the incoming joints to your character.
+To connect Vicon Shogun to Warudo, use the [Onboarding Assistant](../tutorials/readme-1) (or run **Character → Setup Motion Capture**) and select **Vicon Shogun** for pose tracking. After the setup is complete, you should be able to see a **Vicon Subject Receiver** asset in your scene. Make sure the **Vicon Subject Name** field matches the one in Shogun.
 
 :::tip
-If your Shogun skeleton uses custom joint names, use **Override Bone Names** on the **Vicon Receiver** asset to map specific humanoid bones to the names exposed by Shogun Live.
+If your Warudo character has different bone names than the ones used in the Shogun skeleton, use **Override Bone Names** on the **Vicon Receiver** asset to map specific humanoid bones to the names exposed by Shogun.
 :::
 
+![](/doc-img/en-vicon-2.jpg)
+
 ### Prop Tracking
 
-1. In Shogun Live, publish the rigid body (prop) you want to track and confirm it appears on the DataStream.
-2. In Warudo, create a **Vicon Prop Receiver** asset. Set **Vicon Prop Name** to the rigid body's label in Shogun Live, and choose the Warudo prop or camera under **Target Asset**.
-3. When the plugin reports tracking, the chosen asset follows the live prop pose. If the original hierarchy includes a transform named `root`, Warudo mirrors the entire hierarchy; otherwise, it drives the prop from a generated root.
+In Warudo, create a **Vicon Prop Receiver** asset. Set **Vicon Prop Name** to the rigid body's label in Shogun Live, and choose the Warudo prop or camera under **Target Asset**.
+
+:::info
+The hierarchy of the Warudo prop file must match the one in Shogun, and the root transform must be named `root`. Otherwise, Warudo will generate a root transform, but the child transforms may not be fully mirrored.
+:::
 
 :::tip
-To access the tracking data in blueprints, use **Get Vicon Receiver Data** or **Get Vicon Prop Receiver Data** nodes.
+To access the tracking data in blueprints, you can use the **Get Vicon Subject Receiver Data** or **Get Vicon Prop Receiver Data** nodes.
 :::
 
 ## Advanced Options
 
-* **Root Rotation Offset**: Applies a static offset if your character or prop faces a different forward direction than the Vicon coordinate frame.
-* **Use Pre Fetch** (plugin setting): Requests buffered frames from the Vicon DataStream to smooth latency-sensitive setups.
+* **Root Rotation Offset**: Applies a static offset if your character or prop faces a different forward direction than the Vicon coordinate frame. Usually you shuold not need to change this setting.
+* **Use Pre Fetch**: Requests buffered frames from Vicon Shogun to smooth latency-sensitive setups.
 
 ## Frequently Asked Questions
 
 Please refer to [Overview](overview#FAQ) and [Customizing Pose Tracking](body-tracking#FAQ) for common questions.
 
 ### The status says "Failed to connect to Vicon system".
 
-Ensure the Shogun PC and the Warudo PC are on the same subnet and that the Vicon DataStream service is enabled. Double-check the **Server Address** and confirm that UDP port `801` is open on your firewall.
+Ensure the Shogun PC and the Warudo PC are on the same subnet. Double-check the **Server Address** and confirm that port `801` is open on your firewall.
 
 ### My character snaps into incorrect poses.
 
-Confirm that the subject in Shogun Live uses a skeleton compatible with your Warudo character (matching bone hierarchy and zeroed T-pose rotations). When necessary, use **Override Bone Names** to align joint names and **Root Rotation Offset** to match coordinate frames.
+Confirm that the subject in Shogun uses a skeleton compatible with your Warudo character (matching bone hierarchy and zeroed T-pose rotations). When necessary, use **Override Bone Names** to align joint names and **Root Rotation Offset** to match coordinate frames.
 
 <AuthorBar authors={{
   creators: [