> 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/korean/development/api-reference/classes/linearvelocity.md).

# LinearVelocity

LinearVelocity : `Constraint`

## Overview

객체를 일정한 직선 속도로 이동시키기 위한 물리 제약(Constraint) 인스턴스입니다.

RelativeTo 속성을 World 또는 Attachment 중 어디로 설정하느냐에 따라, 힘이 적용되는 기준이 달라집니다.

## Properties

### ForceLimitsEnabled

`boolean`

힘을 제한할지 여부를 결정합니다.

이 속성을 활성화하면 MaxForce에 따라 힘의 크기가 제한되며, 비활성화하면 물리 엔진은 목표 속도에 맞춰큰 힘을 자유롭게 적용할 수 있습니다.

#### Code Samples

```lua
local LinearVelocity = script.Parent

LinearVelocity.ForceLimitsEnabled = false
```

### LineDirection

`Vector3`

VelocityConstraintMode가 Line일 때, 선형 방향으로 속도를 제한하는 정규화된 Vector3 방향입니다.

#### Code Samples

### LineVelocity

`number`

VelocityConstraintMode가 Line일 때, 선형으로 움직이는 방향의 속도를 설정할 수 있습니다.

#### Code Samples

```lua
local LinearVelocity = script.Parent

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

### MaxForce

`number`

ForceLimitsEnabled가 true일 때, 적용할 수 있는 힘의 최대 크기를 설정할 수 있습니다.

#### Code Samples

```lua
local LinearVelocity = script.Parent

LinearVelocity.MaxForce = 10
```

### PlaneVelocity

`Vector2`

VelocityConstraintMode가 Plane일 때, 평면 위에서 움직이는 두 방향(X, Y)에 대한 속도를 설정할 수 있습니다.

#### Code Samples

### PrimaryTangentAxis

`Vector3`

현재 지원되지 않습니다.

#### Code Samples

### RelativeTo

`Enum.ActuatorRelativeTo`

힘이 적용되는 기준 좌표계를 설정할 수 있습니다.

#### Code Samples

```lua
local LinearVelocity = script.Parent

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

### SecondaryTangentAxis

`Vector3`

현재 지원되지 않습니다.

#### Code Samples

### VectorVelocity

`Vector3`

VelocityConstraintMode가 Vector일 때, 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`

어떤 방식으로 속도를 제한할지 설정할 수 있습니다.

* Line: 선형으로 이동
* Plane: 지정된 평면 안에서 이동
* Vector: 벡터3 방향으로 이동 (기본 설정)

#### Code Samples

## Methods

## Events

## See also

{% content-ref url="/pages/6CSY5MxAR0y1qTIDKtRz" %}
[물리](/korean/manual/studio-manual/object/physics.md)
{% endcontent-ref %}