Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Attachables can be in the following states:

State Name

Description

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

Name

Description

Attached Grab Settings

Attachables override the settings of the VR Grabbable. These are the VR Grabbable settings in the Attached state (see VR Grabbable.)

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.

...