LinearVelocity¶
Applies force on an assembly to maintain a constant linear velocity.
Description¶
The LinearVelocity constraint applies force on an assembly to maintain a
constant linear velocity. It can be set to apply force along a
Vector3, line, or 2D plane. Alternatively:
- If you want to control the amount of force applied, use a VectorForce constraint.
- If you only need initial linear velocity, set the AssemblyLinearVelocity property directly on the assembly.
When configuring this constraint, it may be helpful to study Roblox Units to understand how Roblox units compare to metric units.
Relativity¶
Application of velocity can be controlled through the constraint's RelativeTo property. If set to World, force will be applied in world coordinates, independent of the parent or attachment orientations. If set to Attachment0 or Attachment1, force will be applied relative to Attachment0 or Attachment1 respectively.
Inheritance¶
Object → Instance → Constraint → LinearVelocity
Nova inheritance: Instance → Constraint → LinearVelocity
Properties¶
LineDirection Supported Property The normalized Vector3 direction for constraining the velocity along a line.
The normalized Vector3 direction for constraining the velocity along a line, when VelocityConstraintMode is set to Line.
LineVelocity Supported Property Float value of the velocity when VelocityConstraintMode is set to Line.
Float value of the velocity when VelocityConstraintMode is set to Line.
MaxForce Supported Property Maximum magnitude of the force vector the constraint can apply.
Maximum magnitude of the force vector the constraint can apply. Only used
if ForceLimitsEnabled is true
and ForceLimitMode is
Magnitude.
PlaneVelocity Supported Property Vector2 value of the velocity in each tangent direction of the plane.
Vector2 value of the velocity in each tangent direction of the plane, when VelocityConstraintMode is set to Plane.
PrimaryTangentAxis Supported Property The primary axis in the plane, when VelocityConstraintMode is set to Plane.
The primary axis in the plane, when VelocityConstraintMode is set to Plane. Value depends on the value of RelativeTo as follows:
- If RelativeTo is set to Attachment0, this axis is the Axis of Attachment0.
- If RelativeTo is set to Attachment1, this axis is the Axis of Attachment1.
- If RelativeTo is set to World, this value must be specified in the world space.
RelativeTo Supported Property Sets the ActuatorRelativeTo property for the constraint.
Sets the ActuatorRelativeTo property for the constraint.
SecondaryTangentAxis Supported Property The secondary axis in the plane, when VelocityConstraintMode is set to Plane.
The secondary axis in the plane, when VelocityConstraintMode is set to Plane. Value depends on the value of RelativeTo as follows:
- If RelativeTo is set to Attachment0, this axis is the SecondaryAxis of Attachment0.
- If RelativeTo is set to Attachment1, this axis is the SecondaryAxis of Attachment1.
- If RelativeTo is set to World, this value must be specified in the world space.
VectorVelocity Supported Property Vector3 velocity value when VelocityConstraintMode is set to Vector.
Vector3 velocity value when VelocityConstraintMode is set to Vector.
VelocityConstraintMode Supported Property The mode of the constraint.
Inherited members¶
Inherited from Constraint: 14 properties, 36 methods, 7 events. They are documented on the base class page.
5 modern Roblox member(s) are not implemented yet — expand to inspect
Members declared by Roblox's LinearVelocity class (or by a missing base class) that Nova does not expose. Use this list to scope a migration; the compatibility guide has the recommended workaround.
Properties¶
| Member | Signature | Status | Notes | Flags |
|---|---|---|---|---|
ForceLimitMode |
ForceLimitMode: ForceLimitMode |
Not yet | Determines how the constraint force will be limited. | — |
ForceLimitsEnabled |
ForceLimitsEnabled: bool |
Not yet | Determines if the constraint force will be limited or if the physics solver can apply an unlimited force to achieve the target velocity. | — |
MaxAxesForce |
MaxAxesForce: Vector3 |
Not yet | Maximum force along each axis that the constraint can apply to achieve the vector velocity. Only used if ForceLimitsEnabled is `t… | — |
MaxPlanarAxesForce |
MaxPlanarAxesForce: Vector2 |
Not yet | Maximum force along each axis that the constraint can apply to achieve the plane velocity. Only used if ForceLimitsEnabled is `tr… | — |
ReactionForceEnabled |
ReactionForceEnabled: bool |
Not yet | Determines whether an equal and opposite reaction force is also applied to the assembly of Attachment1 when [RelativeTo](LinearVelocity.md#r… | — |
Roblox reference: LinearVelocity
Generated from Nova's API dump and Roblox creator-docs. Nova-only members come from the engine's reflection metadata.