Attachables

Attachables and Attach Receivers allow you to configure objects that can attach to each other in a scene.

VR Attachable

Attachables attach to Attach Receivers. Attachables and Attach Receivers define requirements that must be met in order to successfully attach.

Attachables can be in the following states:

Attached	Object is currently attached to another object.
Detachable	The object is attached, but can be detached. Note that objects only enter this state if “requires detach action” or “requires attach action” is true.
Detached	Object is not attached.
Seeking	Object is detached, but being held and currently “seeking” an attach receiver.

Component Settings

Attached Grab Settings	Attachables override the settings of the VR Grabbable. These are the VR Grabbable settings in the Attached state.
Detached Grab Settings	VR Grabbable settings in the Detached state.
Show When Attached \| Detached \| Detachable \| Seeking	Objects to show as the attachable moves through various states.
Colliders	Colliders to use for attach detection. Uses object colliders by default.
Attached To	If set, defines the object that this object is initially attached to. This object by default meets the attach requirements: this object can always attach back to the initial “Attached To” object.
Grabbable	Can set to override the Grabbable.
Initial State	Auto - Determine the initial state automatically Attached - Initialize in the “attached” state Detachable - Initialize in the “detachable” state Detached - Initialize in the “detached” state
Requires Detach Action	If true, this attachable requires an explicit call to `SetDetachable()` to move from the “attached” to the “detachable” state.
Requires Attach Action	If true, this attachable requires an explicit call to `SetAttachable()` to move from the “detachable” state to the “attached” state.
Show Target Guide	If true, show a highlight copy of the object on the target. This feedback is helpful to indicate that an attachable can be attached.
Guide Meshes	Override the default mesh when defining the target guide. This is useful if only some parts of the attachable should show up as the guide.
Attaches To	Defines the attach requirements for Attach Receivers that this object can attach to. Receiver: If set, explicitly define a Receiver that can receive this Attachable. Type: If set, need to match the “Type” specified by the Receiver to attach. Attach Point: Optionally override the position on the attachable that joins to Receivers that match this record.