LinearVelocity

LinearVelocity : Constraint

Overview

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

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

Properties

ForceLimitMode

Enum.ForceLimitMode

발생하는 힘을 하나의 값으로 제한할지, 축별로 나누어 제한할지를 선택하는 용도입니다.

Magnitude 모드에서는 전체 힘의 세기만을 기준으로 최대값을 넘지 않도록 관리합니다. 반면 PerAxis 모드에서는 각 축 방향의 힘을 개별적으로 계산하여, 현재 속도 제약 방식에 따라 MaxAxesForce 또는 MaxPlanarAxesForce에 설정된 값 이내로 유지되도록 합니다.

단, ForceLimitsEnabled이 활성화된 경우에만 이 설정이 적용됩니다.

Code Samples

ForceLimitsEnabled

bool

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

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

Code Samples

local LinearVelocity = script.Parent

LinearVelocity.ForceLimitsEnabled = false

LineDirection

Vector3

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

Code Samples

LineVelocity

number

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

Code Samples

local LinearVelocity = script.Parent

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

MaxAxesForce

Vector3

현재 지원되지 않습니다.

Code Samples

MaxForce

number

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

Code Samples

local LinearVelocity = script.Parent

LinearVelocity.MaxForce = 10

PlaneVelocity

Vector2

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

Code Samples

PrimaryTangentAxis

Vector3

현재 지원되지 않습니다.

Code Samples

RelativeTo

Enum.ActuatorRelativeTo

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

Code Samples

local LinearVelocity = script.Parent

LinearVelocity.RelativeTo = Enum.ActuatorRelativeTo.World

SecondaryTangentAxis

Vector3

현재 지원되지 않습니다.

Code Samples

VectorVelocity

Vector3

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

Code Samples

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.VelocityConstranumberMode

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

• Line: 선형으로 이동

• Plane: 지정된 평면 안에서 이동

• Vector: 벡터3 방향으로 이동 (기본 설정)

Code Samples

Methods

Events

See also

물리