> For the complete documentation index, see [llms.txt](https://docs.overdare.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.overdare.com/development/api-reference/classes/linearvelocity.md).

# LinearVelocity

LinearVelocity : `Constraint`

## Overview

A physics constraint instance used to move an Object at a constant linear velocity.

The reference for applying force depends on whether the RelativeTo property is set to World or Attachment

## Properties

### ForceLimitsEnabled

`boolean`

Determines whether the force is limited.

When enabled, the force is capped by MaxForce; when disabled, the physics engine can freely apply unlimited force to achieve the target velocity.

#### Code Samples

```lua
local LinearVelocity = script.Parent

LinearVelocity.ForceLimitsEnabled = false
```

### LineDirection

`Vector3`

When VelocityConstraintMode is set to Line, this is the direction of the normalized Vector3 that restricts velocity along a linear direction.

#### Code Samples

### LineVelocity

`number`

When VelocityConstraintMode is Line, sets the velocity in the linear movement direction.

#### Code Samples

```lua
local LinearVelocity = script.Parent

LinearVelocity.LineDirection = Vector3.new(-1, 0, 0)
```

### MaxForce

`number`

When ForceLimitsEnabled is true, sets the maximum force magnitude that can be applied.

#### Code Samples

```lua
local LinearVelocity = script.Parent

LinearVelocity.MaxForce = 10
```

### PlaneVelocity

`Vector2`

When VelocityConstraintMode is Plane, sets the velocity for the two directions (X, Y) on the plane.

#### Code Samples

### PrimaryTangentAxis

`Vector3`

Currently not supported.

#### Code Samples

### RelativeTo

`Enum.ActuatorRelativeTo`

Sets the reference coordinate system for applying force.

#### Code Samples

```lua
local LinearVelocity = script.Parent

LinearVelocity.RelativeTo = Enum.ActuatorRelativeTo.World
```

### SecondaryTangentAxis

`Vector3`

Currently not supported.

#### Code Samples

### VectorVelocity

`Vector3`

When VelocityConstraintMode is Vector, sets the velocity in the direction of the Vector.

#### Code Samples

```lua
local Part = script.Parent
local Attachment = Part.Attachment

local LinearVelocity = Instance.new("LinearVelocity")
LinearVelocity.Attachment0 = Attachment
LinearVelocity.RelativeTo = Enum.ActuatorRelativeTo.World
LinearVelocity.VectorVelocity = Vector3.new(1000, 0, 0)
LinearVelocity.MaxForce = 10
LinearVelocity.Parent = Part
```

### VelocityConstraintMode

`Enum.VelocityConstraintMode`

Sets how velocity is restricted.

* Line: Linear movement.
* Plane: Movement within a specified plane.
* Vector: Movement in vector3 direction (default).

#### Code Samples

## Methods

## Events

## See also

{% content-ref url="/pages/92QXleNfbim97B0uhIQs" %}
[Physics](/manual/studio-manual/object/physics.md)
{% endcontent-ref %}