ToySerialController DancerFork extends the original Toy Serial Controller with a new Virtual Reference motion mode designed for single-person motion scenes, especially dance, MMD, and other performance-focused use cases.
Unlike the original plugin, this mode no longer depends on interaction between two separate atoms. It only requires one person atom rather than a person atom plus another interacting atom. By using a selected target point on that character and analyzing the motion of that target point, it can generate controllable toy motion. This makes it especially suitable for solo dance scenes. It is also useful in cases where only the female character is moving and there is no dildo, male, or other secondary motion source available, which are situations where a traditional two-atom interaction workflow often performs poorly.
The purpose of this mode is not simply to replace a physical dildo or imitate a basic parent-follow setup. It provides a motion model that is more suitable for dance-oriented control. Users can tune motion response independently by direction, combine multiple motion layers, and make the toy react to body movement while still maintaining a stable virtual insertion reference. In practice, this makes it better suited to choreography with mixed motion amplitudes, such as subtle hip sway, squats, bouncing, jumping, and rhythm changes.
The Virtual Reference system is built from several layers:
Reference Length defines the overall scale of the virtual reference and strongly affects the motion range.
Offset0 defines the default local insertion pose relative to the selected target point, and also serves as the spring rest pose.
Offset1 is an optional dynamic correction layer that converts deviation from the reference point into additional position and rotation offsets.
Follow controls how much of the target point's motion is transferred to the virtual reference.
Spring pulls the virtual reference back toward the target pose defined by Offset0 and Offset1.
Damper reduces oscillation and helps stabilize the final motion.
How to use it:
Set Motion Source to "Virtual Reference + Female" or "Virtual Reference + Male", then choose the character atom and the target point you want to drive from.
Recommended tuning workflow:
First, use Reference Length and Offset0 to define the base insertion pose. (in Virtual Reference Base)
If you want body position and posture to create more responsive dynamic changes, enable Offset1 and start by adjusting a small amount. (in Virtual Reference Offset1)
Then adjust Follow to determine how much the inserted target's movement speed affects the virtual reference. If Follow is set to 0, the motion is driven almost entirely by the spring system. If Follow is set to 100, the virtual reference fully follows the inserted target's movement, in which will cause no relative distance changes in target & inserting object. (in Virtual Reference Follow)
Finally, use Spring and Damper to control return strength and overall stability. (in Virtual Reference Spring)
As a starting point, Smoothing around 80 to 90 usually works well. Different dances need different settings: larger and more energetic motions usually benefit from a larger Reference Length, while slower and gentler dances often work better with a shorter one, sometimes even around 2 cm.
Advantages:
Compared with driving the motor by attaching a dildo and relying on drag plus positional follow error, this system considers more motion properties. Users can freely adjust insertion pose and control how body posture influences the Virtual Reference through Offset0 and Offset1. It also handles the effect of speed and acceleration-like motion changes more effectively through weighted motion transport and the spring system. With proper tuning, it can even be used to export funscripts from MMD dance motion.
Areas for improvement:
This motion model can still be further decoupled. In essence, the relationship between the character and the virtual dildo is a driver-driven system. The virtual dildo could be replaced by an Empty atom, and the plugin could be split into multiple modular parts, allowing users to customize atom motion through other plugins and build more flexible workflows.
In addition, the reference point still needs more configuration options. At the moment, it is only estimated from the character's standing position and size. Users should be able to define the reference point more directly and conveniently, for example by using an Empty atom. Right now that is not possible, which means some non-standing poses, such as lying down, may have limited results.
This fork is based on the original Toy Serial Controller by Yoooi0 and extends it with a Virtual Reference workflow that is better suited for dance-oriented motion control.
Unlike the original plugin, this mode no longer depends on interaction between two separate atoms. It only requires one person atom rather than a person atom plus another interacting atom. By using a selected target point on that character and analyzing the motion of that target point, it can generate controllable toy motion. This makes it especially suitable for solo dance scenes. It is also useful in cases where only the female character is moving and there is no dildo, male, or other secondary motion source available, which are situations where a traditional two-atom interaction workflow often performs poorly.
The purpose of this mode is not simply to replace a physical dildo or imitate a basic parent-follow setup. It provides a motion model that is more suitable for dance-oriented control. Users can tune motion response independently by direction, combine multiple motion layers, and make the toy react to body movement while still maintaining a stable virtual insertion reference. In practice, this makes it better suited to choreography with mixed motion amplitudes, such as subtle hip sway, squats, bouncing, jumping, and rhythm changes.
The Virtual Reference system is built from several layers:
Reference Length defines the overall scale of the virtual reference and strongly affects the motion range.
Offset0 defines the default local insertion pose relative to the selected target point, and also serves as the spring rest pose.
Offset1 is an optional dynamic correction layer that converts deviation from the reference point into additional position and rotation offsets.
Follow controls how much of the target point's motion is transferred to the virtual reference.
Spring pulls the virtual reference back toward the target pose defined by Offset0 and Offset1.
Damper reduces oscillation and helps stabilize the final motion.
How to use it:
Set Motion Source to "Virtual Reference + Female" or "Virtual Reference + Male", then choose the character atom and the target point you want to drive from.
Recommended tuning workflow:
First, use Reference Length and Offset0 to define the base insertion pose. (in Virtual Reference Base)
If you want body position and posture to create more responsive dynamic changes, enable Offset1 and start by adjusting a small amount. (in Virtual Reference Offset1)
Then adjust Follow to determine how much the inserted target's movement speed affects the virtual reference. If Follow is set to 0, the motion is driven almost entirely by the spring system. If Follow is set to 100, the virtual reference fully follows the inserted target's movement, in which will cause no relative distance changes in target & inserting object. (in Virtual Reference Follow)
Finally, use Spring and Damper to control return strength and overall stability. (in Virtual Reference Spring)
As a starting point, Smoothing around 80 to 90 usually works well. Different dances need different settings: larger and more energetic motions usually benefit from a larger Reference Length, while slower and gentler dances often work better with a shorter one, sometimes even around 2 cm.
Advantages:
Compared with driving the motor by attaching a dildo and relying on drag plus positional follow error, this system considers more motion properties. Users can freely adjust insertion pose and control how body posture influences the Virtual Reference through Offset0 and Offset1. It also handles the effect of speed and acceleration-like motion changes more effectively through weighted motion transport and the spring system. With proper tuning, it can even be used to export funscripts from MMD dance motion.
Areas for improvement:
This motion model can still be further decoupled. In essence, the relationship between the character and the virtual dildo is a driver-driven system. The virtual dildo could be replaced by an Empty atom, and the plugin could be split into multiple modular parts, allowing users to customize atom motion through other plugins and build more flexible workflows.
In addition, the reference point still needs more configuration options. At the moment, it is only estimated from the character's standing position and size. Users should be able to define the reference point more directly and conveniently, for example by using an Empty atom. Right now that is not possible, which means some non-standing poses, such as lying down, may have limited results.
This fork is based on the original Toy Serial Controller by Yoooi0 and extends it with a Virtual Reference workflow that is better suited for dance-oriented motion control.
