Component:Joint: Difference between revisions

Revision as of 21:34, 3 March 2024

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

Component image

**Joint** component as seen in the Scene Inspector

Intoduction

the Joint component allows for a slot or object to rotate around a single point, in any direction, or around an axis. common uses are doors, helmet tops, and dials.

Usage

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.
`EditModeOnly`	Bool	User can only interact with the joint in Edit Mode
`AllowSteal`	Bool	Controls whether other users can steal the grabbable joint from other players
`DropOnDisable`	Bool	Controls whether the user drops the joint if the object has been disabled
`DontDrive`	Bool
`AllowOnlyPhysicalGrab`	Bool	Only allow grabbing the joint with a physical interaction - remote grabs are not allowed
`ActiveUserFilter`	ActiveUserHandling
`CustomGrabCheck`	GrabCheck
`_grabber`	Grabber
`_holdSlot`	Slot
`_pos`	direct DriveRef`1<Sync`1<Float3>>
`_rot`	direct DriveRef`1<Sync`1<FloatQ>>
`_scl`	direct DriveRef`1<Sync`1<Float3>>
`__legacyActiveUserRootOnly`	Bool
`GrabPriority`	Int	Determines what gets grabbed if several grabbable objects are touching someone's grab sphere. The IGrabbable with the highest priority will be grabbed first. If the highest priority ties with another IGrabbable, it will grab both of those and ignore any lower priority IGrabbables.
`MaxSwing`	Float
`MaxTwist`	Float	Maximum amount the joint will rotate in the given axis
`Axis`	Float3	Determines which axis the joint rotates on. Use 1 to define the axis, 0 to ignore it
`TwistReferenceAxis`	Float3
`PositionTwistThresholdAngle`	Float
`VibrationAngle`	Float
`VibrationPreset`	VibratePreset
`SnapIncrement`	Float
`SnapTime`	Float	The time it takes for the joint to lerp towards given SnapOrientations. Higher the value the slower it takes
`SnapOnRelease`	Bool	Controls whether the join snaps to given SnapOrientations
`SnapOrientations`	list of SnapOrientation
`origRotation`	FloatQ
`rotReference`	FloatQ
`dirReference`	Float3
`twistReference`	Float3
`usePositionTwist`	Bool

Behavior

Examples

Related Components

Category:Draggable

@@ Line 14: / Line 14: @@
 |AllowSteal|Bool| Controls whether other users can steal the grabbable joint from other players
 |DropOnDisable|Bool| Controls whether the user drops the joint if the object has been disabled
 |DontDrive|Bool|
 |AllowOnlyPhysicalGrab|Bool| Only allow grabbing the joint with a physical interaction - remote grabs are not allowed
 |ActiveUserFilter|ActiveUserHandling|
-|CustomGrabCheck|GrabCheck|
+|CustomGrabCheck|{{RootFieldType|SyncDelegate`1|[[Type:GrabCheck|GrabCheck]]}}|TypeAdv6=true|
-|_grabber|Grabber|
+|_grabber|'''[[Component:Grabber|Grabber]]'''|TypeAdv7=true|
 |_holdSlot|Slot|
-|_pos|Sync`1|TypeString9=Sync<Float3>|
+|_pos|{{RootFieldType|DriveRef`1|[[Type:Sync`1|Sync`1]]&lt;[[Type:Float3|Float3]]&gt;}}|TypeAdv9=true|
-|_rot|Sync`1|TypeString10=Sync<FloatQ>|
+|_rot|{{RootFieldType|DriveRef`1|[[Type:Sync`1|Sync`1]]&lt;[[Type:FloatQ|FloatQ]]&gt;}}|TypeAdv10=true|
-|_scl|Sync`1|TypeString11=Sync<Float3>|
+|_scl|{{RootFieldType|DriveRef`1|[[Type:Sync`1|Sync`1]]&lt;[[Type:Float3|Float3]]&gt;}}|TypeAdv11=true|
 |__legacyActiveUserRootOnly|Bool|
 |GrabPriority|Int| {{Template:Grab Priority}}
 |MaxSwing|Float|
 |MaxTwist|Float| Maximum amount the joint will rotate in the given axis
 |Axis|Float3| Determines which axis the joint rotates on. Use 1 to define the axis, 0 to ignore it
 |TwistReferenceAxis|Float3|
 |PositionTwistThresholdAngle|Float|
 |VibrationAngle|Float|
 |VibrationPreset|VibratePreset|
 |SnapIncrement|Float|
 |SnapTime|Float| The time it takes for the joint to lerp towards given SnapOrientations. Higher the value the slower it takes
 |SnapOnRelease|Bool| Controls whether the join snaps to given SnapOrientations
-|SnapOrientations|SnapOrientation|
+|SnapOrientations|{{RootFieldType|SyncList`1|[[#SnapOrientation|SnapOrientation]]}}|TypeAdv24=true|
 |origRotation|FloatQ|
 |rotReference|FloatQ|
 |dirReference|Float3|
 |twistReference|Float3|
 |usePositionTwist|Bool|
 }}
@@ Line 51: / Line 51: @@
 [[:Category:Draggable]]
 </translate>
-[[Category:Components{{#translation:}}|Joint (Component){{#translation:}}]]
+[[Category:Components{{#translation:}}|Joint]]
 [[Category:Transform:Interaction{{#translation:}}|Joint (Component){{#translation:}}]]
+[[Category:Components:Transform:Interaction{{#translation:}}|Joint]]
+[[Category:Components With Nested Types{{#translation:}}|Joint]]
 [[Category:Draggable]]