Sex Assist v1.1 Plugin Usage Guidance
============================================

Attach the SexAssist plugin to a person Atom and open the Custom UI for the plugin. Ensure the scene contains one other person with a penis. The UI is split into two sections, the left side controls align an orifice (Vagina/Anus/Mouth) of the person with the plugin attached to a target person's penis. The right side of the UI controls a Thrust Animation Pattern.

Left side UI controls are as follows:

- Orifice: Select the Orifice (Vagina/Anus/Mouth) to be penetrated by the target penis. This choice will apply to both the Orifice Alignment and the Thrust animation.
- Target Penis: Select a person whose penis will penetrate the selected Orifice. This choice will apply to both the Orifice Alignment and the Thrust animation.
- Rotate Alignment: The amount of rotation that will be applied when aligning the Orifice and Penis. For example, 0 degrees can be used to achieve face to face pose alignment whist 180 degrees can be used for face to back pose alignments e.g. doggy style.
- Align Orifice to Target Penis: Button that will move and rotate the person with the Orifice into a position where the Target penis penetrates the Orifice whilst maintaining the exact current pose.
- Align Target Penis to Orifice: Button that will move and rotate the Target person into a position where their penis will penetrate the selected Orifice whilst maintaining the exact current pose.
- Disable Collision On Align: Toggle that will disable collision on the person being moved after alignment. This can be used when intersection with other objects might cause VAM physics problems.
- Disable/Enable Collision on <Person>: Two buttons that allow the Collision Enabled state of the two Person atoms to be toggled on and off. This is just a short cut for the check box on the VAM Atom Control tab.
- Auto Enable Thrust On Align: Toggle that will automatically start the Thrust Animation Pattern when using the Align Orifice or Align Target buttons.
- Stiffen Penis: Modifies the physic settings of the target penis to ensure penetration is maintained when thrusting.
- Enable Thrust Push Back: Applies physics to the person not thrusting to hold their position against the thrusting action.
 
Right-side UI controls are as follows:

- Enable Thrust Control: Activiates a thrusting Animation Pattern that automatically maintains alignment between the orifice and penis.
- Thruster: Chose between the person with the Orifice or the person with the Penis to be the Thruster.
- Thrust Intensity: Modifies the thrust rate of the Animation Pattern
- Thrust Withdraw %: Controls the amount of withdrawl on each thrust. 0% will result in a thrust pattern where the penis is never withdrawn from the orifice.
- Thrust Depth %: Controls the depth along the penis length of each thrust. 0% will result in an thrust pattern that only reaches the penis tip. 100% will result in a thrust pattern that reaches the base of the penis.
- Orifice Switch Rate: Number of thrusts before the selected Orfice switches between Vagina and Anus. This control has no effect when the Mouth Orifice is selected.
- Thruster Switch Rate: Number of thrusts before the Thruster switches from the Orifice and the Penis.
- BJ Head Rotation Speed: Speed at which the mouth rotates around the length of the penis when Thruster is set to Orifice and Orifice is set to Mouth.
- BJ Head Rotation: Maximum number of degrees to which the mouth rotates around the length of the penis when Thruster is set to Orifice and Orifice is set to Mouth.