Reference API Roblox

Engine API

Website

Related

Reference API Roblox

AlignPosition

Constraint which applies force to move two attachments together, or to move one attachment to a goal position.

Memory categoryPhysicsParts

Member index 11

HistoryMember
553ApplyAtCenterOfMass: bool
589ForceLimitMode: ForceLimitMode
578ForceRelativeTo: ActuatorRelativeTo
578MaxAxesForce: Vector3
553MaxForce: float
553MaxVelocity: float
553Mode: PositionAlignmentMode
553Position: Vector3
553ReactionForceEnabled: bool
553Responsiveness: float
553RigidityEnabled: bool
inherited from Constraint
553Active: bool
553Attachment0: Attachment
553Attachment1: Attachment
553Color: BrickColor
553Enabled: bool
553Visible: bool
604GetDebugAppliedForce(bodyId: int): Vector3
604GetDebugAppliedTorque(bodyId: int): Vector3
inherited from Instance
553Archivable: bool
670Capabilities: SecurityCapabilities
553Name: string
553Parent: Instance
670Sandboxed: bool
616UniqueId: UniqueId
576AddTag(tag: string): null
573ClearAllChildren(): null
462Clone(): Instance
573Destroy(): null
486FindFirstAncestor(name: string): Instance
486FindFirstAncestorOfClass(className: string): Instance
486FindFirstAncestorWhichIsA(className: string): Instance
486FindFirstChild(name: string, recursive: bool = false): Instance
486FindFirstChildOfClass(className: string): Instance
486FindFirstChildWhichIsA(className: string, recursive: bool = false): Instance
486FindFirstDescendant(name: string): Instance
563GetActor(): Actor
486GetAttribute(attribute: string): Variant
462GetAttributeChangedSignal(attribute: string): RBXScriptSignal
631GetAttributes(): Dictionary
648GetChildren(): Instances
462GetDebugId(scopeLength: int = 4): string
486GetDescendants(): Array
486GetFullName(): string
641GetStyled(name: string): Variant
657GetStyledPropertyChangedSignal(property: string): RBXScriptSignal
576GetTags(): Array
576HasTag(tag: string): bool
486IsAncestorOf(descendant: Instance): bool
486IsDescendantOf(ancestor: Instance): bool
664IsPropertyModified(property: string): bool
573Remove(): null
576RemoveTag(tag: string): null
664ResetPropertyToDefault(property: string): null
573SetAttribute(attribute: string, value: Variant): null
462WaitForChild(childName: string, timeOut: double): Instance
648children(): Instances
553clone(): Instance
573destroy(): null
553findFirstChild(name: string, recursive: bool = false): Instance
648getChildren(): Instances
553isDescendantOf(ancestor: Instance): bool
573remove(): null
462AncestryChanged(child: Instance, parent: Instance)
462AttributeChanged(attribute: string)
462ChildAdded(child: Instance)
462ChildRemoved(child: Instance)
462DescendantAdded(descendant: Instance)
462DescendantRemoving(descendant: Instance)
500Destroying()
657StyledPropertiesChanged()
553childAdded(child: Instance)
inherited from Object
647ClassName: string
647className: string
647GetPropertyChangedSignal(property: string): RBXScriptSignal
647IsA(className: string): bool
650isA(className: string): bool
647Changed(property: string)

Description

The AlignPosition constraint applies force to move two attachments together, or to move one attachment to a goal position. As indicated by the name, it only affects the position of the attachments, not their orientation (to align attachments by orientation, see AlignOrientation).

When configuring this constraint, it may be helpful to study Roblox Units to understand how Roblox units compare to metric units.

Force Location

By default, force is applied to the parent of Attachment0 at that attachment's location, meaning that if the parent's center of mass is not aligned with the direction of the force, torque will be applied as well as force. Alternatively, force can be applied to the parents' center of mass by toggling on ApplyAtCenterOfMass.

Reactionary Force

By default, the constraint only applies force to Attachment0 while Attachment1 remains unaffected. If desired, force can be applied to both attachments in equal and opposite directions by enabling ReactionForceEnabled.

Force Limits

You can configure this constraint to apply the maximum force that constraints allow through the RigidityEnabled property. When true, the physics solver reacts as quickly as possible to complete the alignment. When false, the force applied by the constraint is limited based on ForceLimitMode, MaxVelocity, and Responsiveness. See ForceLimitMode for further details.

Attachment Mode

This constraint can use either one or two attachments in calculating its goal. See Mode for details.

History 36

Members 11

ApplyAtCenterOfMass

TypeDefault
boolfalse

When false (default), force is applied to the parent of Attachment0 at that attachment's location, meaning that if the parent's center of mass is not aligned with the direction of the force, torque will be applied as well as force. When true, force is applied at the parents' center of mass.

Thread safetyReadSafe
CategoryAlignPosition
Loaded/Savedtrue

History 4

ForceLimitMode

TypeDefault
ForceLimitModeMagnitude

Determines how the constraint force will be limited when RigidityEnabled is false. When set to Magnitude, the constraint force will be limited such that the magnitude is less than MaxForce. When set to PerAxis, the constraint force along each axis will be limited by MaxAxesForce. The axes along which the force will be limited are based on the ForceRelativeTo property.

Thread safetyReadSafe
CategoryCompliance
Loaded/Savedtrue

History 2

ForceRelativeTo

TypeDefault
ActuatorRelativeToWorld

Determines the axes that the constraint uses to limit the force. Only applies when RigidityEnabled is false and AlignPosition.ForceLimitMode is PerAxis. When set to World, the constraint force is computed in the world reference frame and the force limits specified in MaxAxesForce refer to the axes of the world coordinate system. When set to Attachment0 or Attachment1, the force limits specified in MaxAxesForce refer to the axes of the specified attachment coordinate system.

Thread safetyReadSafe
CategoryCompliance
Loaded/Savedtrue

History 1

MaxAxesForce

TypeDefault
Vector310000, 10000, 10000

Maximum force along each axis that the constraint can apply to achieve its goal. Only used if RigidityEnabled is false and ForceLimitMode is PerAxis. The axes used to apply to the limit are specified using the ForceRelativeTo property.

Thread safetyReadSafe
CategoryCompliance
Loaded/Savedtrue

History 1

MaxForce

TypeDefault
float10000

Maximum force magnitude the constraint can apply to achieve its goal. Only used if RigidityEnabled is false and ForceLimitMode is Magnitude.

Note that MaxForce, as well as MaxVelocity, are caps to the force and velocity respectively. The actual scale is determined by Responsiveness.

Thread safetyReadSafe
CategoryCompliance
Loaded/Savedtrue

History 4

MaxVelocity

TypeDefault
floatINF

Maximum speed the attachments can move when converging. Only used if RigidityEnabled is false.

Note that MaxVelocity, as well as MaxForce, are caps to the velocity and force respectively. The actual scale is determined by Responsiveness.

Thread safetyReadSafe
CategoryCompliance
Loaded/Savedtrue

History 4

Mode

TypeDefault
PositionAlignmentModeTwoAttachment

Whether the constraint uses one or two attachments in calculating its goal. By default, this is TwoAttachment, meaning that the constraint disregards Position and attempts to move Attachment0 to the position of Attachment1.

If set to OneAttachment, the constraint disregards Attachment1 and attempts to move Attachment0 to Position.

Thread safetyReadSafe
CategoryAlignmentMode
Loaded/Savedtrue

History 2

Position

TypeDefault
Vector30, 0, 0

The position to which the constraint should move its Attachment0. Only used if Mode is set to OneAttachment, in which case Attachment1 is disregarded.

Thread safetyReadSafe
CategoryAlignPosition
Loaded/Savedtrue

History 2

ReactionForceEnabled

TypeDefault
boolfalse

If false (default), the constraint only applies force to Attachment0 while Attachment1 remains unaffected. If true, the constraint applies force to both attachments in equal and opposite directions.

Thread safetyReadSafe
CategoryAlignPosition
Loaded/Savedtrue

History 4

Responsiveness

TypeDefault
float10

Controls how quickly the constraint reaches its goal. Higher values cause the attachment(s) to align more rapidly. Value can be between 5 and 200.

Thread safetyReadSafe
CategoryCompliance
Loaded/Savedtrue

History 4

RigidityEnabled

TypeDefault
boolfalse

Whether force is dependent on other properties, or if the physics solver reacts as quickly as possible to complete the alignment. If false (default), the force is determined by MaxForce, MaxVelocity, and Responsiveness. If true, the physics solver reacts as quickly as possible to complete the alignment.

Thread safetyReadSafe
CategoryAlignPosition
Loaded/Savedtrue

History 4

Settings