attachTo

Introduced in

Description

Attaches an object to another object, either at a fixed position relative to one object (for example, always 2m in front), or using a rope to bound the two. When attaching a camera, only the first 3 parameters apply (child, parent, offset).

Note: In V1.34+, the command can be re-applied to an already attached item (with new offsets), without having to detach it first.

Syntax

• child: Object - Object to be attached.
• parent: Object - Object that the child is attached to. In V3.2+, objects can be attached to simulated proxies, by using the getProxy command.
• offset: Position3D - Positional offset to either the object center or the memory point. If no offset is specified, the object is attached with the current position it is placed at (optional).
• mempoint: String - Parent object Memory point (see Memory LOD in the VBS Developer Reference) (optional).
• rope: Number or Boolean - Can be:
  • 0 or false: The attachment is rigid, meaning the child object is fixed in position relatively to the parent object (default: false).
  • 1 or true: The attachment is done using a flexible rope, allowing the child object to swing about.
  • 2: The object is attached using an inflexible link (such as a tow bar, with pivots on each end).
  • 3: The object is attached using a horizontal rope (to simulate towing). If the model has a "attachRope" memory point, then the rope is attached to this point.
• bone: String - Name of bone to attach to on the parent object. The referenced bone must be of a "Memory", "Geometry", or "Fire" LOD (optional, available in V1.24+).
• collisions: Boolean - Whether collisions for attached object should be enabled (optional, default: false, V1.40+).

Examples

player attachTo [car,[0,2,0],"hatch1"]
camera attachTo [car, car selectionPosition "light_1_1_pos"]

Additional Information