Component:VRIKAvatar: Difference between revisions

From Resonite Wiki
m New generation of page
add info
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages></languages>
<languages></languages>
<translate>
<translate>
{{stub}}
{{Infobox Component
{{Infobox Component
|Image=VRIKAvatarComponent.png
|Image=VRIKAvatarComponent.png
|Name=VRIKAvatar
|Name=VRIKAvatar
}}
}}
The '''VRIKAvatar''' component is used to drive and control the [[Component:VRIK|VRIK]] component on an [[Avatar]].


== Fields ==
== Fields ==
{{Table ComponentFields
{{Table ComponentFields
|IK|[[Component:VRIK|VRIK]]|TypeAdv0=true|
|IK|'''[[Component:VRIK|VRIK]]'''|TypeAdv0=true| The VRIK to control.
|HeightCompensation|Float|
|HeightCompensation|Float| How much to scale up or down the user's avatar compared to the tracking points. Think a multiplier to avatar scale vs user root.
|AvatarHeight|Float|
|AvatarHeight|Float| The height of the avatar from floor to eyes in meters.
|UserResizeThreshold|Float|
|UserResizeThreshold|Float| How much the user has to be different from original scale in percentage before prompting to reset scale.
|FeetIgnoreOtherPlayers|Bool|
|FeetIgnoreOtherPlayers|Bool| Whether feet raycasts ignore other users.
|FeetCollisionListMode|ListFilterMode|
|FeetCollisionListMode|ListFilterMode| The mode to use for feet raycasting whitelist/blacklist.
|FeetCollisionList|{{RootFieldType|SyncRefList`1|[[Type:Slot|Slot]]}}|TypeAdv6=true|
|FeetCollisionList|{{RootFieldType|SyncRefList`1|[[Type:Slot|Slot]]}}|TypeAdv6=true| The list of items to filter to/from raycasting according to <code>FeetCollisionListMode</code>
|HeadMaxFixDistance|Float|
|HeadMaxFixDistance|Float| The maximum distance to allow fixing head position due to bad IK.
|ForceUseFeetProxies|Bool|
|ForceUseFeetProxies|Bool| Whether to force the use of Feet proxy/tracker objects.
|ForceUsePelvisProxy|Bool|
|ForceUsePelvisProxy|Bool| Whether to force the use of Pelvis proxy/tracker objects.
|ForceUseChestProxy|Bool|
|ForceUseChestProxy|Bool| Whether to force the use of Chest proxy/tracker objects.
|ForceUseElbowProxies|Bool|
|ForceUseElbowProxies|Bool| Whether to force the use of Elbow proxy/tracker objects.
|ForceUseKneeProxies|Bool|
|ForceUseKneeProxies|Bool| Whether to force the use of Knee proxy/tracker objects.
|FeetCalibrated|Bool|
|FeetCalibrated|Bool| Whether or not the feet are calibrated.
|PelvisCalibrated|Bool|
|PelvisCalibrated|Bool| Whether or not the pelvis is calibrated.
|GroundCheckHeightRatio|Float|
|GroundCheckHeightRatio|Float| How far to check compared to user height for the floor (unused)
|FeetHoverHeight|Float|
|FeetHoverHeight|Float| The height at which feet should hover in either up or down from rest position when off the floor.
|FeetHoverSmoothSpeed|Float|
|FeetHoverSmoothSpeed|Float| How much to smooth the feet movement when hovering.
|MinFeetTransitionSpeed|Float|
|MinFeetTransitionSpeed|Float| The minimum speed at random to transition to different modes.
|MaxFeetTransitionSpeed|Float|
|MaxFeetTransitionSpeed|Float| The maximum speed at random to transition to different modes.
|GaitFeetTransitionSpeedMultiplier|Float|
|GaitFeetTransitionSpeedMultiplier|Float| How much to multiply the user's speed to determine the gait speed.
|FeetHoverTilt|Float|
|FeetHoverTilt|Float| How much to tilt the feet when hovering.
|LeftFootFloatOffset|Float3|
|LeftFootFloatOffset|Float3| How much to offset the left foot when starting hovering.
|RightFootFloatOffset|Float3|
|RightFootFloatOffset|Float3| How much to offset the right foot when starting hovering.
|LeftFootRootHeight|Float|
|LeftFootRootHeight|Float| How much to move up the left foot when starting hovering.
|RightFootRootHeight|Float|
|RightFootRootHeight|Float| How much to move up the right foot when starting hovering.
|FootFloatSpeed|Float|
|FootFloatSpeed|Float| How fast the feet should move when hovering.
|FootFloatAngleMagnitude|Float|
|FootFloatAngleMagnitude|Float| How much the feet angle should change when hovering.
|FootFloatOffsetMagnitude|Float|
|FootFloatOffsetMagnitude|Float| How much the feet should wander from avatar center when hovering.
|FeetFloatVelocityForce|Float|
|FeetFloatVelocityForce|Float| How much velocity to apply to the feet hovering simulation when moving.
|FeetFloatVelocityDampeningSpeed|Float|
|FeetFloatVelocityDampeningSpeed|Float| How much to dampen velocity over time for the feet hovering simulation.
|MaxFeetVelocityOffset|Float|
|MaxFeetVelocityOffset|Float| The maximum amount that the feet can wander from avatar center.
|VelocityAverageRate|Float|
|VelocityAverageRate|Float| The average amount of velocity the user has while moving in user transform space.
|HoverVelocityThreshold|Float|
|HoverVelocityThreshold|Float| The threshold for velocity the user needs to be to be hovering.
|HorizontalBodyAngle|Float|
|HorizontalBodyAngle|Float| The angle required for the user to be considered horizontal for their hips.
|SupressWalkAnimationWhenHorizontal|Bool|
|SupressWalkAnimationWhenHorizontal|Bool| Whether or not to suppress the walking animation when the user is horizontal.
|AlwaysUseTrackersWhenHorizontal|Bool|
|AlwaysUseTrackersWhenHorizontal|Bool| Whether or not to always override and use trackers when the user is horizontal.
|Gaits|{{RootFieldType|SyncList`1|[[Type:Gait|Gait]]}}|TypeAdv37=true|
|Gaits|{{RootFieldType|SyncList`1|[[#Gait|Gait]]}}|TypeAdv37=true| A list of gaits to use when moving (Now is unused).
|GaitTransitionSpeed|Float|
|GaitTransitionSpeed|Float| How fast to transition between different gaits (Now is unused).
|GaitMovementDirectionSmoothSpeed|Float|
|GaitMovementDirectionSmoothSpeed|Float| How much to smooth the gait feet movement direction (Now is unused).
|RigCollidersRadiusRatio|Float|
|RigCollidersRadiusRatio|Float| The ratio between the avatar limb length and collider radius sizes.
|LeftHandRotationOffset|FloatQ|
|LeftHandRotationOffset|FloatQ| The offset for the left hand rotation versus controller rotation.
|RightHandRotationOffset|FloatQ|
|RightHandRotationOffset|FloatQ| The offset for the right hand rotation versus controller rotation.
|CurrentAverageVelocity|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv43=true|
|CurrentAverageVelocity|{{RootFieldType|RawOutput`1|[[Type:Float|Float]]}}|TypeAdv43=true| The average amount of velocity the user has while moving in user transform space.
|CurrentOnGround|{{RootFieldType|RawOutput`1|[[Type:Bool|Bool]]}}|TypeAdv44=true|
|CurrentOnGround|{{RootFieldType|RawOutput`1|[[Type:Bool|Bool]]}}|TypeAdv44=true| Whether or not the user is currently is on the ground.
|CurrentGaitIndex|{{RootFieldType|RawOutput`1|[[Type:Int|Int]]}}|TypeAdv45=true|
|CurrentGaitIndex|{{RootFieldType|RawOutput`1|[[Type:Int|Int]]}}|TypeAdv45=true| The current walk animation the user is using (Now is unused).
|_locomotionController|[[Component:LocomotionController|LocomotionController]]|TypeAdv46=true|
|_locomotionController|'''[[Component:LocomotionController|LocomotionController]]'''|TypeAdv46=true| The current locomotion module the user is using.
|_leftHandNode|[[Component:AvatarPoseNode|AvatarPoseNode]]|TypeAdv47=true|
|_leftHandNode|'''[[Component:AvatarPoseNode|AvatarPoseNode]]'''|TypeAdv47=true| The avatar pose node for posing/IK for the left hand.
|_rightHandNode|[[Component:AvatarPoseNode|AvatarPoseNode]]|TypeAdv48=true|
|_rightHandNode|'''[[Component:AvatarPoseNode|AvatarPoseNode]]'''|TypeAdv48=true| The avatar pose node for posing/IK for the right hand.
|_leftElbowNode|[[Component:AvatarPoseNode|AvatarPoseNode]]|TypeAdv49=true|
|_leftElbowNode|'''[[Component:AvatarPoseNode|AvatarPoseNode]]'''|TypeAdv49=true| The avatar pose node for posing/IK for the left elbow.
|_rightElbowNode|[[Component:AvatarPoseNode|AvatarPoseNode]]|TypeAdv50=true|
|_rightElbowNode|'''[[Component:AvatarPoseNode|AvatarPoseNode]]'''|TypeAdv50=true| The avatar pose node for posing/IK for the right elbow.
|_leftFootNode|[[Component:AvatarPoseNode|AvatarPoseNode]]|TypeAdv51=true|
|_leftFootNode|'''[[Component:AvatarPoseNode|AvatarPoseNode]]'''|TypeAdv51=true| The avatar pose node for posing/IK for the left foot.
|_rightFootNode|[[Component:AvatarPoseNode|AvatarPoseNode]]|TypeAdv52=true|
|_rightFootNode|'''[[Component:AvatarPoseNode|AvatarPoseNode]]'''|TypeAdv52=true| The avatar pose node for posing/IK for the right foot.
|_leftKneeNode|[[Component:AvatarPoseNode|AvatarPoseNode]]|TypeAdv53=true|
|_leftKneeNode|'''[[Component:AvatarPoseNode|AvatarPoseNode]]'''|TypeAdv53=true| The avatar pose node for posing/IK for the left knee.
|_rightKneeNode|[[Component:AvatarPoseNode|AvatarPoseNode]]|TypeAdv54=true|
|_rightKneeNode|'''[[Component:AvatarPoseNode|AvatarPoseNode]]'''|TypeAdv54=true| The avatar pose node for posing/IK for the right knee.
|_headNode|[[Component:AvatarPoseNode|AvatarPoseNode]]|TypeAdv55=true|
|_headNode|'''[[Component:AvatarPoseNode|AvatarPoseNode]]'''|TypeAdv55=true| The avatar pose node for posing/IK for the head.
|_pelvisNode|[[Component:AvatarPoseNode|AvatarPoseNode]]|TypeAdv56=true|
|_pelvisNode|'''[[Component:AvatarPoseNode|AvatarPoseNode]]'''|TypeAdv56=true| The avatar pose node for posing/IK for the pelvis.
|_chestNode|[[Component:AvatarPoseNode|AvatarPoseNode]]|TypeAdv57=true|
|_chestNode|'''[[Component:AvatarPoseNode|AvatarPoseNode]]'''|TypeAdv57=true| The avatar pose node for posing/IK for the chest.
|_headProxy|Slot|
|_headProxy|Slot| The proxy slot for the head.
|_pelvisProxy|Slot|
|_pelvisProxy|Slot| The proxy slot for the pelvis.
|_chestProxy|Slot|
|_chestProxy|Slot| The proxy slot for the chest.
|_leftHandProxy|Slot|
|_leftHandProxy|Slot| The proxy slot for the left hand.
|_rightHandProxy|Slot|
|_rightHandProxy|Slot| The proxy slot for the right hand.
|_leftElbowProxy|Slot|
|_leftElbowProxy|Slot| The proxy slot for the left elbow.
|_rightElbowProxy|Slot|
|_rightElbowProxy|Slot| The proxy slot for the right elbow.
|_leftFootProxy|Slot|
|_leftFootProxy|Slot| The proxy slot for the left foot.
|_rightFootProxy|Slot|
|_rightFootProxy|Slot| The proxy slot for the right foot.
|_leftKneeProxy|Slot|
|_leftKneeProxy|Slot| The proxy slot for the left knee.
|_rightKneeProxy|Slot|
|_rightKneeProxy|Slot| The proxy slot for the right knee.
|_leftKneeDefaultProxy|Slot|
|_leftKneeDefaultProxy|Slot| The default proxy slot for the left knee.
|_rightKneeDefaultProxy|Slot|
|_rightKneeDefaultProxy|Slot| The default proxy slot for the right knee.
|_headTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv71=true|
|_headTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv71=true| The field to drive for the head position.
|_headTargetRot|{{RootFieldType|FieldDrive`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv72=true|
|_headTargetRot|{{RootFieldType|FieldDrive`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv72=true| The field to drive for the head rotation.
|_pelvisTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv73=true|
|_pelvisTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv73=true| The field to drive for the pelvis position.
|_pelvisTargetRot|{{RootFieldType|FieldDrive`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv74=true|
|_pelvisTargetRot|{{RootFieldType|FieldDrive`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv74=true| The field to drive for the pelvis rotation.
|_chestTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv75=true|
|_chestTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv75=true| The field to drive for the chest position.
|_leftHandTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv76=true|
|_leftHandTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv76=true| The field to drive for the left hand position.
|_leftHandTargetRot|{{RootFieldType|FieldDrive`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv77=true|
|_leftHandTargetRot|{{RootFieldType|FieldDrive`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv77=true| The field to drive for the left hand rotation.
|_rightHandTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv78=true|
|_rightHandTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv78=true| The field to drive for the right hand position.
|_rightHandTargetRot|{{RootFieldType|FieldDrive`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv79=true|
|_rightHandTargetRot|{{RootFieldType|FieldDrive`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv79=true| The field to drive for the right hand rotation.
|_leftElbowTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv80=true|
|_leftElbowTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv80=true| The field to drive for the left elbow position.
|_rightElbowTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv81=true|
|_rightElbowTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv81=true| The field to drive for the left elbow position.
|_leftFootTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv82=true|
|_leftFootTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv82=true| The field to drive for the left foot position.
|_leftFootTargetRot|{{RootFieldType|FieldDrive`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv83=true|
|_leftFootTargetRot|{{RootFieldType|FieldDrive`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv83=true| The field to drive for the left foot rotation.
|_rightFootTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv84=true|
|_rightFootTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv84=true| The field to drive for the right foot position.
|_rightFootTargetRot|{{RootFieldType|FieldDrive`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv85=true|
|_rightFootTargetRot|{{RootFieldType|FieldDrive`1|[[Type:FloatQ|FloatQ]]}}|TypeAdv85=true| The field to drive for the right foot position.
|_leftKneeTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv86=true|
|_leftKneeTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv86=true| The field to drive for the left knee position.
|_rightKneeTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv87=true|
|_rightKneeTargetPos|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv87=true| The field to drive for the right knee position.
|_pelvisPositionWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv88=true|
|_pelvisPositionWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv88=true| The field to drive for the pelvis position weight.
|_pelvisRotationWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv89=true|
|_pelvisRotationWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv89=true| The field to drive for the pelvis rotation weight.
|_chestWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv90=true|
|_chestWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv90=true| The field to drive for the chest weight.
|_locomotionWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv91=true|
|_locomotionWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv91=true| The field to drive for the locomotion weight.
|_leftLegPositionWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv92=true|
|_leftLegPositionWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv92=true| The field to drive for the left leg position weight.
|_leftLegRotationWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv93=true|
|_leftLegRotationWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv93=true| The field to drive for the left leg rotation weight.
|_rightLegPositionWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv94=true|
|_rightLegPositionWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv94=true| The field to drive for the right leg position weight.
|_rightLegRotationWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv95=true|
|_rightLegRotationWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv95=true| The field to drive for the right leg rotation weight.
|_leftKneeBendWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv96=true|
|_leftKneeBendWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv96=true| The field to drive for the left knee bend weight.
|_rightKneeBendWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv97=true|
|_rightKneeBendWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv97=true| The field to drive for the right knee bend weight.
|_leftElbowBendWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv98=true|
|_leftElbowBendWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv98=true| The field to drive for the left elbow bend weight.
|_rightElbowBendWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv99=true|
|_rightElbowBendWeight|{{RootFieldType|FieldDrive`1|[[Type:Float|Float]]}}|TypeAdv99=true| The field to drive for the right elbow bend weight.
|_leftFootOffset|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv100=true|
|_leftFootOffset|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv100=true| The field to drive for the left foot bend weight.
|_rightFootOffset|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv101=true|
|_rightFootOffset|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv101=true| The field to drive for the right foot bend weight.
|_leftFootRelativeToRoot|FloatQ|
|_leftFootRelativeToRoot|FloatQ| The rotation of the left foot relative to the character root.
|_rightFootRelativeToRoot|FloatQ|
|_rightFootRelativeToRoot|FloatQ| The rotation of the right foot to the character root.
|_locomotionOffset|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv104=true|
|_locomotionOffset|{{RootFieldType|FieldDrive`1|[[Type:Float3|Float3]]}}|TypeAdv104=true| The field to drive with the locomotion offset.
|_simplifiedColliderEnabled|{{RootFieldType|FieldDrive`1|[[Type:Bool|Bool]]}}|TypeAdv105=true|
|_simplifiedColliderEnabled|{{RootFieldType|FieldDrive`1|[[Type:Bool|Bool]]}}|TypeAdv105=true| The field to drive with the simplified collider hit box.
|_rigCollidersEnabledStates|{{RootFieldType|SyncList`1|[[Type:FieldDrive`1|FieldDrive`1]]&lt;[[Type:Bool|Bool]]&gt;}}|TypeAdv106=true|
|_rigCollidersEnabledStates|{{RootFieldType|SyncList`1|[[Type:FieldDrive`1|FieldDrive`1]]&lt;[[Type:Bool|Bool]]&gt;}}|TypeAdv106=true| The field list to drive with all the complex rig collider enabled states.
|_horizontalTrackingLocked|Bool|
|_horizontalTrackingLocked|Bool| Whether or not the horizontal rig tracking is locked.
}}
 
== Sync Delegates ==
{{Table ComponentTriggers
|FilterAvatarHeadPose()|[[Type:AvatarHeadPoseFilter|AvatarHeadPoseFilter]]|true| Used in a transform override component on the user's head to prevent the view from rotating when it's being simulated by the locomotion system
}}
 
== Gait ==
This part of the system is no longer used, so documentation may be inaccurate, but there is no longer a way to test this system anymore.
{{Table TypeFields
|MinimumVelocity|float| The minimum velocity required for this gait to take effect.
|FeetRange|float2| The range in which the feet will attempt steps.
|CycleHeightBias|float| The amount the feet will be biased to step upwards for step height.
|CycleFeetSeparation|float| How much to separate the feet from each other during the cycle.
|CycleGroundRatio|float| The amount the feet will take into account the ground for the step height.
|FootRaiseBeginHeight|float| What point the feet should start at for raising for a step.
|FootRaiseEndHeight|float| What point the feet should end at for raising for a step.
|FootRestAngle|float| The angle the feet should be at for rest.
|FootRaiseAngle|float| The angle a foot should be at when making a step.
|FeetAlignmentOffset|float| How much to offset for feet alignment.
|SpeedRatio|float| How much to speed up the foot at the peak of the step.
|FeetSlipRatio|float| How much the feet will slip before taking a step.
|ForwardOffset|float| The offset of the feet forwards or backwards.
}}
}}
== Behavior ==
 
== Usage ==
{{stub}}


== Examples ==
== Examples ==
Used in avatars.


== Related Components ==
== See Also ==
* [[Avatar]]
* [[Component:VRIK]]
</translate>
</translate>
[[Category:ComponentStubs]]
 
[[Category:Components{{#translation:}}]]
[[Category:Components{{#translation:}}|VRIKAvatar]]
[[Category:Components:Uncategorized{{#translation:}}]]
[[Category:Components With Nested Types{{#translation:}}|VRIKAvatar]]
[[Category:Components:Uncategorized{{#translation:}}|VRIKAvatar]]

Latest revision as of 23:53, 3 August 2025

Component image 
VRIKAvatar component as seen in the Scene Inspector

The VRIKAvatar component is used to drive and control the VRIK component on an Avatar.

Fields

Fields
Name Type Description
persistent Bool Determines whether or not this item will be saved to the server.
UpdateOrder Int Controls the order in which this component is updated.
Enabled Bool Controls whether or not this component is enabled. Some components stop their functionality when this field is disabled, but some don't.
IK VRIK The VRIK to control.
HeightCompensation Float How much to scale up or down the user's avatar compared to the tracking points. Think a multiplier to avatar scale vs user root.
AvatarHeight Float The height of the avatar from floor to eyes in meters.
UserResizeThreshold Float How much the user has to be different from original scale in percentage before prompting to reset scale.
FeetIgnoreOtherPlayers Bool Whether feet raycasts ignore other users.
FeetCollisionListMode ListFilterMode The mode to use for feet raycasting whitelist/blacklist.
FeetCollisionList list of Slot The list of items to filter to/from raycasting according to FeetCollisionListMode
HeadMaxFixDistance Float The maximum distance to allow fixing head position due to bad IK.
ForceUseFeetProxies Bool Whether to force the use of Feet proxy/tracker objects.
ForceUsePelvisProxy Bool Whether to force the use of Pelvis proxy/tracker objects.
ForceUseChestProxy Bool Whether to force the use of Chest proxy/tracker objects.
ForceUseElbowProxies Bool Whether to force the use of Elbow proxy/tracker objects.
ForceUseKneeProxies Bool Whether to force the use of Knee proxy/tracker objects.
FeetCalibrated Bool Whether or not the feet are calibrated.
PelvisCalibrated Bool Whether or not the pelvis is calibrated.
GroundCheckHeightRatio Float How far to check compared to user height for the floor (unused)
FeetHoverHeight Float The height at which feet should hover in either up or down from rest position when off the floor.
FeetHoverSmoothSpeed Float How much to smooth the feet movement when hovering.
MinFeetTransitionSpeed Float The minimum speed at random to transition to different modes.
MaxFeetTransitionSpeed Float The maximum speed at random to transition to different modes.
GaitFeetTransitionSpeedMultiplier Float How much to multiply the user's speed to determine the gait speed.
FeetHoverTilt Float How much to tilt the feet when hovering.
LeftFootFloatOffset Float3 How much to offset the left foot when starting hovering.
RightFootFloatOffset Float3 How much to offset the right foot when starting hovering.
LeftFootRootHeight Float How much to move up the left foot when starting hovering.
RightFootRootHeight Float How much to move up the right foot when starting hovering.
FootFloatSpeed Float How fast the feet should move when hovering.
FootFloatAngleMagnitude Float How much the feet angle should change when hovering.
FootFloatOffsetMagnitude Float How much the feet should wander from avatar center when hovering.
FeetFloatVelocityForce Float How much velocity to apply to the feet hovering simulation when moving.
FeetFloatVelocityDampeningSpeed Float How much to dampen velocity over time for the feet hovering simulation.
MaxFeetVelocityOffset Float The maximum amount that the feet can wander from avatar center.
VelocityAverageRate Float The average amount of velocity the user has while moving in user transform space.
HoverVelocityThreshold Float The threshold for velocity the user needs to be to be hovering.
HorizontalBodyAngle Float The angle required for the user to be considered horizontal for their hips.
SupressWalkAnimationWhenHorizontal Bool Whether or not to suppress the walking animation when the user is horizontal.
AlwaysUseTrackersWhenHorizontal Bool Whether or not to always override and use trackers when the user is horizontal.
Gaits list of Gait A list of gaits to use when moving (Now is unused).
GaitTransitionSpeed Float How fast to transition between different gaits (Now is unused).
GaitMovementDirectionSmoothSpeed Float How much to smooth the gait feet movement direction (Now is unused).
RigCollidersRadiusRatio Float The ratio between the avatar limb length and collider radius sizes.
LeftHandRotationOffset FloatQ The offset for the left hand rotation versus controller rotation.
RightHandRotationOffset FloatQ The offset for the right hand rotation versus controller rotation.
CurrentAverageVelocity raw output of Float The average amount of velocity the user has while moving in user transform space.
CurrentOnGround raw output of Bool Whether or not the user is currently is on the ground.
CurrentGaitIndex raw output of Int The current walk animation the user is using (Now is unused).
_locomotionController LocomotionController The current locomotion module the user is using.
_leftHandNode AvatarPoseNode The avatar pose node for posing/IK for the left hand.
_rightHandNode AvatarPoseNode The avatar pose node for posing/IK for the right hand.
_leftElbowNode AvatarPoseNode The avatar pose node for posing/IK for the left elbow.
_rightElbowNode AvatarPoseNode The avatar pose node for posing/IK for the right elbow.
_leftFootNode AvatarPoseNode The avatar pose node for posing/IK for the left foot.
_rightFootNode AvatarPoseNode The avatar pose node for posing/IK for the right foot.
_leftKneeNode AvatarPoseNode The avatar pose node for posing/IK for the left knee.
_rightKneeNode AvatarPoseNode The avatar pose node for posing/IK for the right knee.
_headNode AvatarPoseNode The avatar pose node for posing/IK for the head.
_pelvisNode AvatarPoseNode The avatar pose node for posing/IK for the pelvis.
_chestNode AvatarPoseNode The avatar pose node for posing/IK for the chest.
_headProxy Slot The proxy slot for the head.
_pelvisProxy Slot The proxy slot for the pelvis.
_chestProxy Slot The proxy slot for the chest.
_leftHandProxy Slot The proxy slot for the left hand.
_rightHandProxy Slot The proxy slot for the right hand.
_leftElbowProxy Slot The proxy slot for the left elbow.
_rightElbowProxy Slot The proxy slot for the right elbow.
_leftFootProxy Slot The proxy slot for the left foot.
_rightFootProxy Slot The proxy slot for the right foot.
_leftKneeProxy Slot The proxy slot for the left knee.
_rightKneeProxy Slot The proxy slot for the right knee.
_leftKneeDefaultProxy Slot The default proxy slot for the left knee.
_rightKneeDefaultProxy Slot The default proxy slot for the right knee.
_headTargetPos field drive of Float3 The field to drive for the head position.
_headTargetRot field drive of FloatQ The field to drive for the head rotation.
_pelvisTargetPos field drive of Float3 The field to drive for the pelvis position.
_pelvisTargetRot field drive of FloatQ The field to drive for the pelvis rotation.
_chestTargetPos field drive of Float3 The field to drive for the chest position.
_leftHandTargetPos field drive of Float3 The field to drive for the left hand position.
_leftHandTargetRot field drive of FloatQ The field to drive for the left hand rotation.
_rightHandTargetPos field drive of Float3 The field to drive for the right hand position.
_rightHandTargetRot field drive of FloatQ The field to drive for the right hand rotation.
_leftElbowTargetPos field drive of Float3 The field to drive for the left elbow position.
_rightElbowTargetPos field drive of Float3 The field to drive for the left elbow position.
_leftFootTargetPos field drive of Float3 The field to drive for the left foot position.
_leftFootTargetRot field drive of FloatQ The field to drive for the left foot rotation.
_rightFootTargetPos field drive of Float3 The field to drive for the right foot position.
_rightFootTargetRot field drive of FloatQ The field to drive for the right foot position.
_leftKneeTargetPos field drive of Float3 The field to drive for the left knee position.
_rightKneeTargetPos field drive of Float3 The field to drive for the right knee position.
_pelvisPositionWeight field drive of Float The field to drive for the pelvis position weight.
_pelvisRotationWeight field drive of Float The field to drive for the pelvis rotation weight.
_chestWeight field drive of Float The field to drive for the chest weight.
_locomotionWeight field drive of Float The field to drive for the locomotion weight.
_leftLegPositionWeight field drive of Float The field to drive for the left leg position weight.
_leftLegRotationWeight field drive of Float The field to drive for the left leg rotation weight.
_rightLegPositionWeight field drive of Float The field to drive for the right leg position weight.
_rightLegRotationWeight field drive of Float The field to drive for the right leg rotation weight.
_leftKneeBendWeight field drive of Float The field to drive for the left knee bend weight.
_rightKneeBendWeight field drive of Float The field to drive for the right knee bend weight.
_leftElbowBendWeight field drive of Float The field to drive for the left elbow bend weight.
_rightElbowBendWeight field drive of Float The field to drive for the right elbow bend weight.
_leftFootOffset field drive of Float3 The field to drive for the left foot bend weight.
_rightFootOffset field drive of Float3 The field to drive for the right foot bend weight.
_leftFootRelativeToRoot FloatQ The rotation of the left foot relative to the character root.
_rightFootRelativeToRoot FloatQ The rotation of the right foot to the character root.
_locomotionOffset field drive of Float3 The field to drive with the locomotion offset.
_simplifiedColliderEnabled field drive of Bool The field to drive with the simplified collider hit box.
_rigCollidersEnabledStates list of FieldDrive`1<Bool> The field list to drive with all the complex rig collider enabled states.
_horizontalTrackingLocked Bool Whether or not the horizontal rig tracking is locked.

Sync Delegates

Triggers
Method Name Method type and Arguments. Is the method hidden? Description
FilterAvatarHeadPose() AvatarHeadPoseFilter Used in a transform override component on the user's head to prevent the view from rotating when it's being simulated by the locomotion system

Gait

This part of the system is no longer used, so documentation may be inaccurate, but there is no longer a way to test this system anymore.

Fields
Name Type Description
MinimumVelocity float The minimum velocity required for this gait to take effect.
FeetRange float2 The range in which the feet will attempt steps.
CycleHeightBias float The amount the feet will be biased to step upwards for step height.
CycleFeetSeparation float How much to separate the feet from each other during the cycle.
CycleGroundRatio float The amount the feet will take into account the ground for the step height.
FootRaiseBeginHeight float What point the feet should start at for raising for a step.
FootRaiseEndHeight float What point the feet should end at for raising for a step.
FootRestAngle float The angle the feet should be at for rest.
FootRaiseAngle float The angle a foot should be at when making a step.
FeetAlignmentOffset float How much to offset for feet alignment.
SpeedRatio float How much to speed up the foot at the peak of the step.
FeetSlipRatio float How much the feet will slip before taking a step.
ForwardOffset float The offset of the feet forwards or backwards.

Usage

This article or section is a Stub. You can help the Resonite Wiki by expanding it.

Examples

Used in avatars.

See Also