WorldRoot

WorldRoot : Instance

Overview

3D 공간에서 물체를 감지하거나 시뮬레이션하는 기능을 수행하는 클래스입니다.

Properties

AllowDebugDraw

boolean

Draw로 시작하는 디버그 드로잉 메서드들의 동작 여부를 지정하는 속성으로, Shipping 빌드에서는 기본값이 false이고 그 외(Development, Debug) 빌드에서는 기본값이 true입니다.

false로 설정하면 이후의 Draw 호출이 무시되며, 이미 그려진 디버그 드로잉도 즉시 제거됩니다.

Code Samples

Methods

Blockcast

주어진 위치(CFrame)와 크기(Extents)로 정의된 박스 형태의 공간을 지정한 방향(Direction)으로 이동시키며, 경로상의 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. Raycast와 유사하지만, 광선 대신 박스 형태로 충돌을 감지하므로 더 넓은 영역의 오브젝트를 탐지할 수 있습니다.

Parameters

CFrame InCFrame	박스의 초기 위치와 회전을 나타내는 좌표 프레임입니다.
Vector3 InExtents	박스의 크기(가로, 세로, 높이)를 정의하는 벡터입니다.
Vector3 InDirection	박스가 이동할 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
RaycastParams InRaycastParams	오브젝트를 감지할지 조건을 설정 할 수 있는 설정 객체입니다. RaycastParams를 이용하여 특정 파트를 제외하거나, 충돌 그룹을 지정할 수 있습니다.이 값을 지정하지 않으면 기본값이 적용되어, 모든 오브젝트가 감지 대상이 됩니다.

Return

RaycastResult	박스의 경로에서 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없으면 nil을 반환합니다.

Code Samples

BlockcastSingleByChannel

주어진 위치(CFrame)와 크기(Extents)로 정의된 박스 형태의 공간을 지정한 방향(Direction)으로 이동시키며, 지정한 충돌 채널(TraceChannel)을 기준으로 경로상의 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. Blockcast와 동일한 방식으로 동작하지만, 충돌 채널을 기반으로 충돌 감지를 수행합니다.

Parameters

CFrame InCFrame	박스의 초기 위치와 회전을 나타내는 좌표 프레임입니다.
Vector3 InExtents	박스의 크기(가로, 세로, 높이)를 정의하는 벡터입니다.
Vector3 InDirection	박스가 이동할 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
Enum.CollisionChannel TraceChannel	충돌 감지에 사용할 충돌 채널입니다. 해당 채널에 대한 응답이 Block 또는 Overlap으로 설정된 오브젝트만 감지 대상이 됩니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있으며, 지정하지 않으면 기본값이 적용됩니다.
CollisionResponseParams InResponseParams	각 충돌 채널에 대한 응답 방식을 지정하는 객체입니다. 지정하지 않으면 기본 응답 설정이 적용됩니다.

Return

RaycastResult	박스의 경로에서 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없으면 nil을 반환합니다.

Code Samples

BlockcastSingleByChannelName

주어진 위치(CFrame)와 크기(Extents)로 정의된 박스 형태의 공간을 지정한 방향(Direction)으로 이동시키며, 지정한 충돌 채널의 이름(ChannelDisplayName)을 기준으로 경로상의 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. BlockcastSingleByChannel과 동일한 방식으로 동작하지만, Enum.CollisionChannel 대신 채널 이름(문자열)으로 충돌 채널을 지정할 수 있습니다. 내부적으로 이름을 충돌 채널로 변환한 뒤 BlockcastSingleByChannel을 호출하며, 이름에 해당하는 채널을 찾지 못하면 충돌 감지를 수행하지 않습니다.

Parameters

CFrame InCFrame	박스의 초기 위치와 회전을 나타내는 좌표 프레임입니다.
Vector3 InExtents	박스의 크기(가로, 세로, 높이)를 정의하는 벡터입니다.
Vector3 InDirection	박스가 이동할 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
string ChannelDisplayName	충돌 감지에 사용할 충돌 채널의 이름입니다. 충돌 프로파일에 등록된 채널 이름을 우선으로 검색하며, 해당 이름의 채널을 찾을 수 없으면 감지를 수행하지 않습니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있으며, 지정하지 않으면 기본값이 적용됩니다.
CollisionResponseParams InResponseParams	각 충돌 채널에 대한 응답 방식을 지정하는 객체입니다. 지정하지 않으면 기본 응답 설정이 적용됩니다.

Return

RaycastResult	박스의 경로에서 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없거나 지정한 이름에 해당하는 충돌 채널을 찾지 못하면 nil을 반환합니다.

Code Samples

BlockcastSingleByObject

주어진 위치(CFrame)와 크기(Extents)로 정의된 박스 형태의 공간을 지정한 방향(Direction)으로 이동시키며, 오브젝트 쿼리 파라미터를 기준으로 경로상의 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. Blockcast와 동일한 방식으로 동작하지만, 오브젝트 타입을 기반으로 충돌 감지를 수행합니다.

Parameters

CFrame InCFrame	박스의 초기 위치와 회전을 나타내는 좌표 프레임입니다.
Vector3 InExtents	박스의 크기(가로, 세로, 높이)를 정의하는 벡터입니다.
Vector3 InDirection	박스가 이동할 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있습니다.
CollisionObjectQueryParams InObjectParams	충돌 감지 대상이 될 오브젝트 타입을 지정하는 객체입니다. 특정 오브젝트 타입만 충돌 대상으로 설정할 수 있습니다.

Return

RaycastResult	박스의 경로에서 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없으면 nil을 반환합니다.

Code Samples

BlockcastSingleByProfile

주어진 위치(CFrame)와 크기(Extents)로 정의된 박스 형태의 공간을 지정한 방향(Direction)으로 이동시키며, 지정한 충돌 프로파일(ProfileName)을 기준으로 경로상의 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. Blockcast와 동일한 방식으로 동작하지만, 충돌 프로파일을 기반으로 충돌 감지를 수행합니다.

Parameters

CFrame InCFrame	박스의 초기 위치와 회전을 나타내는 좌표 프레임입니다.
Vector3 InExtents	박스의 크기(가로, 세로, 높이)를 정의하는 벡터입니다.
Vector3 InDirection	박스가 이동할 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
string ProfileName	충돌 감지에 사용할 충돌 프로파일의 이름입니다. 해당 프로파일의 충돌 응답 설정에 따라 감지 대상이 결정됩니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있습니다.

Return

RaycastResult	박스의 경로에서 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없으면 nil을 반환합니다.

Code Samples

Capsulecast

주어진 위치(CFrame), 반지름(Radius), 높이(Height)로 정의된 캡슐 형태의 공간을 지정한 방향(Direction)으로 이동시키며, 경로상의 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. 캐릭터의 이동 경로나 충돌 예측에 적합하며, 캐릭터의 형태와 유사한 캡슐 모양으로 충돌을 감지합니다.

Parameters

CFrame InCFrame	캡슐의 초기 위치와 회전을 나타내는 좌표 프레임입니다.
number InRadius	캡슐의 반지름입니다.
number InHalfHeight	캡슐의 높이입니다.
Vector3 InDirection	캡슐이 이동할 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
RaycastParams InRaycastParams	오브젝트를 감지할지 조건을 설정 할 수 있는 설정 객체입니다. RaycastParams를 이용하여 특정 파트를 제외하거나, 충돌 그룹을 지정할 수 있습니다.이 값을 지정하지 않으면 기본값이 적용되어, 모든 오브젝트가 감지 대상이 됩니다.

Return

RaycastResult	캡슐의 경로에서 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없으면 nil을 반환합니다.

Code Samples

CapsulecastSingleByChannel

주어진 위치(CFrame), 반지름(Radius), 높이(Height)로 정의된 캡슐 형태의 공간을 지정한 방향(Direction)으로 이동시키며, 지정한 충돌 채널(TraceChannel)을 기준으로 경로상의 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. Capsulecast와 동일한 방식으로 동작하지만, 충돌 채널을 기반으로 충돌 감지를 수행합니다.

Parameters

CFrame InCFrame	캡슐의 초기 위치와 회전을 나타내는 좌표 프레임입니다.
number InRadius	캡슐의 반지름입니다.
number InHalfHeight	캡슐의 높이입니다.
Vector3 InDirection	캡슐이 이동할 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
Enum.CollisionChannel TraceChannel	충돌 감지에 사용할 충돌 채널입니다. 해당 채널에 대한 응답이 Block 또는 Overlap으로 설정된 오브젝트만 감지 대상이 됩니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있으며, 지정하지 않으면 기본값이 적용됩니다.
CollisionResponseParams InResponseParams	각 충돌 채널에 대한 응답 방식을 지정하는 객체입니다. 지정하지 않으면 기본 응답 설정이 적용됩니다.

Return

RaycastResult	캡슐의 경로에서 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없으면 nil을 반환합니다.

Code Samples

CapsulecastSingleByChannelName

주어진 위치(CFrame), 반지름(Radius), 높이(Height)로 정의된 캡슐 형태의 공간을 지정한 방향(Direction)으로 이동시키며, 지정한 충돌 채널의 이름(ChannelDisplayName)을 기준으로 경로상의 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. CapsulecastSingleByChannel과 동일한 방식으로 동작하지만, Enum.CollisionChannel 대신 채널 이름(문자열)으로 충돌 채널을 지정할 수 있습니다. 내부적으로 이름을 충돌 채널로 변환한 뒤 CapsulecastSingleByChannel을 호출하며, 이름에 해당하는 채널을 찾지 못하면 충돌 감지를 수행하지 않습니다.

Parameters

CFrame InCFrame	캡슐의 초기 위치와 회전을 나타내는 좌표 프레임입니다.
number InRadius	캡슐의 반지름입니다.
number InHalfHeight	캡슐의 높이입니다.
Vector3 InDirection	캡슐이 이동할 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
string ChannelDisplayName	충돌 감지에 사용할 충돌 채널의 이름입니다. 충돌 프로파일에 등록된 채널 이름을 우선으로 검색하며, 해당 이름의 채널을 찾을 수 없으면 감지를 수행하지 않습니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있으며, 지정하지 않으면 기본값이 적용됩니다.
CollisionResponseParams InResponseParams	각 충돌 채널에 대한 응답 방식을 지정하는 객체입니다. 지정하지 않으면 기본 응답 설정이 적용됩니다.

Return

RaycastResult	캡슐의 경로에서 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없거나 지정한 이름에 해당하는 충돌 채널을 찾지 못하면 nil을 반환합니다.

Code Samples

CapsulecastSingleByObject

주어진 위치(CFrame), 반지름(Radius), 높이(Height)로 정의된 캡슐 형태의 공간을 지정한 방향(Direction)으로 이동시키며, 오브젝트 쿼리 파라미터를 기준으로 경로상의 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. Capsulecast와 동일한 방식으로 동작하지만, 오브젝트 타입을 기반으로 충돌 감지를 수행합니다.

Parameters

CFrame InCFrame	캡슐의 초기 위치와 회전을 나타내는 좌표 프레임입니다.
number InRadius	캡슐의 반지름입니다.
number InHalfHeight	캡슐의 높이입니다.
Vector3 InDirection	캡슐이 이동할 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있습니다.
CollisionObjectQueryParams InObjectParams	충돌 감지 대상이 될 오브젝트 타입을 지정하는 객체입니다. 특정 오브젝트 타입만 충돌 대상으로 설정할 수 있습니다.

Return

RaycastResult	캡슐의 경로에서 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없으면 nil을 반환합니다.

Code Samples

CapsulecastSingleByProfile

주어진 위치(CFrame), 반지름(Radius), 높이(Height)로 정의된 캡슐 형태의 공간을 지정한 방향(Direction)으로 이동시키며, 지정한 충돌 프로파일(ProfileName)을 기준으로 경로상의 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. Capsulecast와 동일한 방식으로 동작하지만, 충돌 프로파일을 기반으로 충돌 감지를 수행합니다.

Parameters

CFrame InCFrame	캡슐의 초기 위치와 회전을 나타내는 좌표 프레임입니다.
number InRadius	캡슐의 반지름입니다.
number InHalfHeight	캡슐의 높이입니다.
Vector3 InDirection	캡슐이 이동할 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
string ProfileName	충돌 감지에 사용할 충돌 프로파일의 이름입니다. 해당 프로파일의 충돌 응답 설정에 따라 감지 대상이 결정됩니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있습니다.

Return

RaycastResult	캡슐의 경로에서 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없으면 nil을 반환합니다.

Code Samples

ClearDebugDraw

지금까지 Draw로 시작하는 메서드로 그려진 모든 디버그 드로잉(선, 도형, 문자열 등)을 즉시 제거하는 메서드입니다.

AllowDebugDraw가 false인 상태에서도 호출할 수 있습니다.

Parameters

Return

void

Code Samples

DrawArrow

주어진 시작점(InOrigin)에서 방향(InDirection)을 향하는 화살표 형태의 디버그 도형을 그리는 메서드입니다. 주로 디버깅 용도로 방향이나 힘의 벡터를 시각적으로 확인할 때 사용합니다.

Parameters

Vector3 InOrigin	화살표가 시작되는 위치입니다.
Vector3 InDirection	화살표가 향하는 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 화살표의 길이도 함께 결정됩니다.
Color3 InColor	화살표의 색상입니다.
number InArrowSize	화살촉 부분의 크기입니다.
number InThickness	화살표 몸통 선의 두께입니다.
number InLifeTime	화살표가 월드에서 유지될 시간(초 단위)입니다.

Return

void

Code Samples

DrawBox

주어진 위치와 크기로 정의된 박스 형태의 와이어프레임 디버그 도형을 그리는 메서드입니다.

Parameters

CFrame InCFrame	박스의 위치와 회전을 나타내는 좌표 프레임입니다.
Vector3 InSize	박스의 크기(가로, 세로, 높이)를 나타내는 벡터입니다.
Color3 InColor	박스의 색상입니다.
number InThickness	박스 외곽선의 두께입니다.
number InLifeTime	박스가 월드에서 유지될 시간(초 단위)입니다.

Return

void

Code Samples

DrawCamera

지정한 위치와 방향에 카메라의 시야(FOV)를 시각화하는 프러스텀 형태의 디버그 도형을 그리는 메서드입니다.

Parameters

CFrame InCFrame	카메라의 위치와 방향을 나타내는 좌표 프레임입니다.
number InFOVDegrees	카메라의 시야각을 도(degree) 단위로 지정하며, 0에서 180 사이의 값으로 제한됩니다.
number InScale	카메라 프러스텀 도형의 크기 배율입니다.
Color3 InColor	도형의 색상입니다.
number InLifeTime	도형이 월드에서 유지될 시간(초 단위)입니다.

Return

void

Code Samples

DrawCapsule

주어진 위치와 크기로 정의된 캡슐 형태의 와이어프레임 디버그 도형을 그리는 메서드입니다.

Parameters

CFrame InCFrame	캡슐의 위치와 회전을 나타내는 좌표 프레임입니다.
number InHalfHeight	캡슐의 절반 높이로, InRadius보다 작으면 InRadius 값으로 보정됩니다.
number InRadius	캡슐의 반지름입니다.
Color3 InColor	캡슐의 색상입니다.
number InThickness	캡슐 외곽선의 두께입니다.
number InLifeTime	캡슐이 월드에서 유지될 시간(초 단위)입니다.

Return

void

Code Samples

DrawCircle

주어진 위치를 중심으로 원 형태의 디버그 도형을 그리는 메서드입니다.

Parameters

CFrame InCFrame	원의 위치와 방향(원이 놓일 평면)을 나타내는 좌표 프레임입니다.
number InRadius	원의 반지름입니다.
Color3 InColor	원의 색상입니다.
number InSegments	원을 구성하는 선분의 개수로, 값이 클수록 더 매끄러운 원이 그려집니다.
number InThickness	원 외곽선의 두께입니다.
number InLifeTime	원이 월드에서 유지될 시간(초 단위)입니다.
boolean InDrawAxis	true로 설정하면 원의 중심 좌표축도 함께 표시합니다.

Return

void

Code Samples

DrawCircleArc

주어진 중심점을 기준으로 부채꼴 형태의 호(arc)를 그리는 메서드입니다.

Parameters

Vector3 InCenter	호의 중심 위치입니다.
Vector3 InDirection	호가 향하는 기준 방향을 나타내는 벡터입니다.
number InRadius	호의 반지름입니다.
number InAngleWidthRadians	호의 전체 각도 범위를 라디안 단위로 지정합니다.
Color3 InColor	호의 색상입니다.
number InSegments	호를 구성하는 선분의 개수로, 값이 클수록 더 매끄러운 호가 그려집니다.
number InThickness	호의 두께입니다.
number InLifeTime	호가 월드에서 유지될 시간(초 단위)입니다.

Return

void

Code Samples

DrawCone

주어진 시작점(InOrigin)에서 방향(InDirection)으로 뻗어나가는 원뿔 형태의 디버그 도형을 그리는 메서드입니다. 시야각이나 감지 범위를 시각화할 때 유용합니다.

Parameters

Vector3 InOrigin	원뿔의 꼭짓점 위치입니다.
Vector3 InDirection	원뿔이 뻗어나가는 방향을 나타내는 벡터입니다.
number InLength	원뿔의 길이입니다.
number InAngleWidthRadians	원뿔의 가로 방향 반각을 라디안 단위로 지정합니다.
number InAngleHeightRadians	원뿔의 세로 방향 반각을 라디안 단위로 지정합니다.
Color3 InColor	원뿔의 색상입니다.
number InNumSides	원뿔의 밑면을 구성하는 변의 개수로, 값이 클수록 더 매끄러운 원뿔이 그려집니다.
number InThickness	원뿔 외곽선의 두께입니다.
number InLifeTime	원뿔이 월드에서 유지될 시간(초 단위)입니다.

Return

void

Code Samples

DrawCoordinateSystem

주어진 위치와 회전을 기준으로 X, Y, Z 축을 나타내는 좌표계 디버그 도형을 그리는 메서드입니다.

Parameters

CFrame InCFrame	좌표계의 위치와 회전을 나타내는 좌표 프레임입니다.
number InScale	좌표축의 길이 배율입니다.
number InThickness	좌표축 선의 두께입니다.
number InLifeTime	좌표계가 월드에서 유지될 시간(초 단위)입니다.

Return

void

Code Samples

DrawCrosshairs

주어진 위치와 회전을 기준으로 십자선(crosshair) 형태의 디버그 도형을 그리는 메서드입니다.

Parameters

CFrame InCFrame	십자선의 위치와 회전을 나타내는 좌표 프레임입니다.
number InScale	십자선의 크기 배율입니다.
Color3 InColor	십자선의 색상입니다.
number InLifeTime	십자선이 월드에서 유지될 시간(초 단위)입니다.

Return

void

Code Samples

DrawCylinder

지정한 시작점(InStart)과 끝점(InEnd)을 잇는 원기둥 형태의 디버그 도형을 그리는 메서드입니다.

Parameters

Vector3 InStart	원기둥의 시작(밑면 중심) 위치입니다.
Vector3 InEnd	원기둥의 끝(윗면 중심) 위치입니다.
number InRadius	원기둥의 반지름입니다.
Color3 InColor	원기둥의 색상입니다.
number InSegments	원기둥의 단면을 구성하는 선분의 개수로, 값이 클수록 더 매끄러운 원기둥이 그려집니다.
number InThickness	원기둥 외곽선의 두께입니다.
number InLifeTime	원기둥이 월드에서 유지될 시간(초 단위)입니다.

Return

void

Code Samples

DrawDonut

주어진 위치를 중심으로 도넛(원형 링) 형태의 디버그 도형을 그리는 메서드입니다.

Parameters

CFrame InCFrame	도넛의 위치와 방향(도넛이 놓일 평면)을 나타내는 좌표 프레임입니다.
number InInnerRadius	도넛의 안쪽 반지름입니다.
number InOuterRadius	도넛의 바깥쪽 반지름으로, InInnerRadius보다 작으면 InInnerRadius 값으로 보정됩니다.
Color3 InColor	도넛의 색상입니다.
number InSegments	도넛을 구성하는 선분의 개수로, 값이 클수록 더 매끄러운 도넛이 그려집니다.
number InThickness	도넛 외곽선의 두께입니다.
number InLifeTime	도넛이 월드에서 유지될 시간(초 단위)입니다.

Return

void

Code Samples

DrawLine

지정한 시작점(InStart)과 끝점(InEnd)을 잇는 직선을 그려 화면에 표시하는 메서드입니다. 주로 디버깅 용도로 활용됩니다.

Parameters

Vector3 InStart	선의 시작 위치입니다.
Vector3 InEnd	선의 끝 위치입니다.
Color3 InColor	선의 색상입니다.
number InThickness	선의 두께입니다.
number InLifeTime	선이 월드에서 유지될 시간(초 단위)입니다.

Return

void

Code Samples

DrawMesh

지정한 정점(InVertices)과 인덱스(InIndices)로 구성된 삼각형 메시 형태의 디버그 도형을 그리는 메서드입니다.

Parameters

Array InVertices	메시를 구성하는 정점 위치의 배열입니다.
Array InIndices	정점 배열을 3개씩 묶어 삼각형을 구성하는 인덱스 배열로, 전체 개수는 3의 배수여야 합니다.
Color3 InColor	메시의 색상입니다.
number InLifeTime	메시가 월드에서 유지될 시간(초 단위)입니다.

Return

void

Code Samples

DrawPoint

지정한 위치에 점 형태의 디버그 도형을 그리는 메서드입니다.

Parameters

Vector3 InPosition	점의 위치입니다.
Color3 InColor	점의 색상입니다.
number InSize	점의 크기입니다.
number InLifeTime	점이 월드에서 유지될 시간(초 단위)입니다.

Return

void

Code Samples

DrawRay

주어진 시작점(origin)과 방향(direction)을 기준으로 지정한 색상의 광선을 화면에 표시하여 시각적으로 확인할 수 있도록 해주는 메서드입니다. 주로 디버깅 용도로 활용되며, Raycast의 방향과 도달 위치를 시각적으로 파악할 때 유용합니다.

Parameters

Vector3 InOrigin	광선(ray)이 발사되는 출발 지점입니다.
Vector3 InDirection	광선의 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
Color3 InColor	광선의 색상입니다.
number InThickness	광선의 선 두께입니다.
number InLifeTime	광선이 월드에서 유지될 시간(초 단위)입니다.

Return

void

Code Samples

local Workspace = game:GetService("Workspace")

local Origin = Vector3.new(0, 50, 0)
local Direction = Vector3.new(0, 0, -1000)
local Color = Color3.fromRGB(255, 0, 0)
local Thickness = 5
local LifeTime = 1.5

Workspace:DrawRay(Origin, Direction, Color, Thickness, LifeTime)

DrawSolidBox

주어진 위치와 크기로 정의된 채워진(solid) 박스 형태의 디버그 도형을 그리는 메서드입니다.

Parameters

CFrame InCFrame	박스의 위치와 회전을 나타내는 좌표 프레임입니다.
Vector3 InSize	박스의 크기(가로, 세로, 높이)를 나타내는 벡터입니다.
Color3 InColor	박스의 색상입니다.
number InLifeTime	박스가 월드에서 유지될 시간(초 단위)입니다.

Return

void

Code Samples

DrawSolidPlane

주어진 위치와 방향을 기준으로 채워진(solid) 평면 형태의 디버그 도형을 그리는 메서드입니다.

Parameters

CFrame InCFrame	평면의 위치와 방향(법선 방향)을 나타내는 좌표 프레임입니다.
number InSize	평면의 크기입니다.
Color3 InColor	평면의 색상입니다.
number InLifeTime	평면이 월드에서 유지될 시간(초 단위)입니다.

Return

void

Code Samples

DrawSphere

주어진 중심점(InCenter)과 반지름(InRadius)으로 정의된 구 형태의 와이어프레임 디버그 도형을 그리는 메서드입니다.

Parameters

Vector3 InCenter	구의 중심 위치입니다.
number InRadius	구의 반지름입니다.
Color3 InColor	구의 색상입니다.
number InSegments	구를 구성하는 선분의 개수로, 값이 클수록 더 매끄러운 구가 그려집니다.
number InThickness	구 외곽선의 두께입니다.
number InLifeTime	구가 월드에서 유지될 시간(초 단위)입니다.

Return

void

Code Samples

DrawSpline

지정한 점들(InPoints)을 지나는 부드러운 곡선(Catmull-Rom 스플라인)을 그리는 메서드입니다. 4개 이상의 점을 지정해야 합니다.

Parameters

Array InPoints	곡선이 지나갈 점들의 배열로, 4개 이상의 점을 지정해야 합니다.
Color3 InColor	곡선의 색상입니다.
number InAlpha	스플라인의 장력(tension)을 조절하는 값으로, 0에서 1 사이의 값으로 제한됩니다.
number InSamplesPerSegment	각 구간을 표현할 샘플링 개수로, 값이 클수록 더 매끄러운 곡선이 그려집니다.
number InThickness	곡선의 두께입니다.
number InLifeTime	곡선이 월드에서 유지될 시간(초 단위)입니다.

Return

void

Code Samples

DrawString

지정한 위치에 문자열을 화면에 표시하는 메서드입니다.

Parameters

Vector3 InLocation	문자열이 표시될 위치입니다.
string InText	표시할 문자열입니다.
Color3 InColor	문자열의 색상입니다.
number InDuration	문자열이 화면에 표시될 시간(초 단위)입니다.
boolean InDrawShadow	true로 설정하면 문자열에 그림자를 함께 표시합니다.
number InFontScale	문자열의 폰트 크기 배율입니다.

Return

void

Code Samples

GetPartBoundsInBox

주어진 중심 위치(Center)와 크기(Size)로 정의된 박스 형태의 공간에서, 그 영역과 겹치는 파트들을 찾아 배열로 반환합니다. 필터링 조건이나 감지 범위 등을 세부적으로 설정하기 위해 OverlapParams를 함께 사용할 수 있습니다.

Parameters

CFrame InCenter	감지할 영역의 중심 좌표입니다.
Vector3 InSize	박스 형태로 설정된 감지 범위의 가로, 세로, 높이 크기입니다.
OverlapParams InOverlapParams	오브젝트를 감지할지 조건을 설정 할 수 있는 설정 객체입니다. OverlapParams를 이용하여 특정 파트를 제외하거나, 충돌 그룹을 지정할 수 있습니다.이 값을 지정하지 않으면 기본값이 적용되어, 모든 오브젝트가 감지 대상이 됩니다.

Return

Array	박스의 범위에서 감지된 오브젝트들의 배열입니다.

Code Samples

local Center = Vector3.new(0, 50, 0)
local Size = Vector3.new(1000, 1000, 1000)
local Cframe = CFrame.new(Center)
local PartsInBox = workspace:GetPartBoundsInBox(Cframe, Size)

for _, obj in ipairs(PartsInBox) do
    print(obj.Name)
end

GetPartBoundsInBoxByChannel

주어진 중심 위치(Center)와 크기(Size)로 정의된 박스 형태의 공간에서, 지정한 충돌 채널(TraceChannel)을 기준으로 그 영역과 겹치는 파트들을 찾아 배열로 반환합니다. GetPartBoundsInBox와 동일한 방식으로 동작하지만, 충돌 채널을 기반으로 충돌 감지를 수행합니다.

Parameters

CFrame InCenter	감지할 영역의 중심 좌표입니다.
Vector3 InSize	박스 형태로 설정된 감지 범위의 가로, 세로, 높이 크기입니다.
Enum.CollisionChannel TraceChannel	충돌 감지에 사용할 충돌 채널입니다. 해당 채널에 대한 응답이 Block 또는 Overlap으로 설정된 오브젝트만 감지 대상이 됩니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있으며, 지정하지 않으면 기본값이 적용됩니다.
CollisionResponseParams InResponseParams	각 충돌 채널에 대한 응답 방식을 지정하는 객체입니다. 지정하지 않으면 기본 응답 설정이 적용됩니다.

Return

Array	박스의 범위에서 감지된 오브젝트들의 배열입니다.

Code Samples

GetPartBoundsInBoxByChannelName

주어진 중심 위치(Center)와 크기(Size)로 정의된 박스 형태의 공간에서, 지정한 충돌 채널의 이름(ChannelDisplayName)을 기준으로 그 영역과 겹치는 파트들을 찾아 배열로 반환합니다. GetPartBoundsInBoxByChannel과 동일한 방식으로 동작하지만, Enum.CollisionChannel 대신 채널 이름(문자열)으로 충돌 채널을 지정할 수 있습니다. 내부적으로 이름을 충돌 채널로 변환한 뒤 GetPartBoundsInBoxByChannel을 호출하며, 이름에 해당하는 채널을 찾지 못하면 감지를 수행하지 않습니다.

Parameters

CFrame InCenter	감지할 영역의 중심 좌표입니다.
Vector3 InSize	박스 형태로 설정된 감지 범위의 가로, 세로, 높이 크기입니다.
string ChannelDisplayName	충돌 감지에 사용할 충돌 채널의 이름입니다. 충돌 프로파일에 등록된 채널 이름을 우선으로 검색하며, 해당 이름의 채널을 찾을 수 없으면 감지를 수행하지 않습니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있으며, 지정하지 않으면 기본값이 적용됩니다.
CollisionResponseParams InResponseParams	각 충돌 채널에 대한 응답 방식을 지정하는 객체입니다. 지정하지 않으면 기본 응답 설정이 적용됩니다.

Return

Array	박스의 범위에서 감지된 오브젝트들의 배열입니다. 지정한 이름에 해당하는 충돌 채널을 찾지 못하면 빈 배열을 반환합니다.

Code Samples

GetPartBoundsInSphere

주어진 중심 위치(Center)와 반지름(Radius)으로 정의된 구 형태의 공간에서, 그 영역과 겹치는 파트들을 찾아 배열로 반환합니다. 근접 체크나 범위 효과(Area-of-Effect) 판정에 유용합니다.

Parameters

CFrame InCenter	감지할 구 형태 영역의 중심 좌표입니다.
number InRadius	구의 반지름입니다.
OverlapParams InOverlapParams	오브젝트를 감지할지 조건을 설정 할 수 있는 설정 객체입니다. OverlapParams를 이용하여 특정 파트를 제외하거나, 충돌 그룹을 지정할 수 있습니다.이 값을 지정하지 않으면 기본값이 적용되어, 모든 오브젝트가 감지 대상이 됩니다.

Return

Array	구의 범위에서 감지된 오브젝트들의 배열입니다.

Code Samples

GetPartBoundsInSphereByChannel

주어진 중심 위치(Center)와 반지름(Radius)으로 정의된 구 형태의 공간에서, 지정한 충돌 채널(TraceChannel)을 기준으로 그 영역과 겹치는 파트들을 찾아 배열로 반환합니다. GetPartBoundsInSphere와 동일한 방식으로 동작하지만, 충돌 채널을 기반으로 충돌 감지를 수행합니다.

Parameters

CFrame InCenter	감지할 구 형태 영역의 중심 좌표입니다.
number InRadius	구의 반지름입니다.
Enum.CollisionChannel TraceChannel	충돌 감지에 사용할 충돌 채널입니다. 해당 채널에 대한 응답이 Block 또는 Overlap으로 설정된 오브젝트만 감지 대상이 됩니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있으며, 지정하지 않으면 기본값이 적용됩니다.
CollisionResponseParams InResponseParams	각 충돌 채널에 대한 응답 방식을 지정하는 객체입니다. 지정하지 않으면 기본 응답 설정이 적용됩니다.

Return

Array	구의 범위에서 감지된 오브젝트들의 배열입니다.

Code Samples

GetPartBoundsInSphereByChannelName

주어진 중심 위치(Center)와 반지름(Radius)으로 정의된 구 형태의 공간에서, 지정한 충돌 채널의 이름(ChannelDisplayName)을 기준으로 그 영역과 겹치는 파트들을 찾아 배열로 반환합니다. GetPartBoundsInSphereByChannel과 동일한 방식으로 동작하지만, Enum.CollisionChannel 대신 채널 이름(문자열)으로 충돌 채널을 지정할 수 있습니다. 내부적으로 이름을 충돌 채널로 변환한 뒤 GetPartBoundsInSphereByChannel을 호출하며, 이름에 해당하는 채널을 찾지 못하면 감지를 수행하지 않습니다.

Parameters

CFrame InCenter	감지할 구 형태 영역의 중심 좌표입니다.
number InRadius	구의 반지름입니다.
string ChannelDisplayName	충돌 감지에 사용할 충돌 채널의 이름입니다. 충돌 프로파일에 등록된 채널 이름을 우선으로 검색하며, 해당 이름의 채널을 찾을 수 없으면 감지를 수행하지 않습니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있으며, 지정하지 않으면 기본값이 적용됩니다.
CollisionResponseParams InResponseParams	각 충돌 채널에 대한 응답 방식을 지정하는 객체입니다. 지정하지 않으면 기본 응답 설정이 적용됩니다.

Return

Array	구의 범위에서 감지된 오브젝트들의 배열입니다. 지정한 이름에 해당하는 충돌 채널을 찾지 못하면 빈 배열을 반환합니다.

Code Samples

GetPartsInPart

지정된 BasePart와 겹치는(충돌하는) 모든 파트들을 찾아 배열로 반환합니다. OverlapParams를 사용하여 특정 오브젝트를 포함하거나 제외하는 등 필터링 조건을 세부적으로 설정할 수 있습니다.

Parameters

BasePart InBasePart	충돌을 감지할 기준이 되는 파트입니다.
OverlapParams InOverlapParams	오브젝트를 감지할지 조건을 설정 할 수 있는 설정 객체입니다. OverlapParams를 이용하여 특정 파트를 제외하거나, 충돌 그룹을 지정할 수 있습니다.이 값을 지정하지 않으면 기본값이 적용되어, 모든 오브젝트가 감지 대상이 됩니다.

Return

Array	파트의 범위에서 감지된 오브젝트들의 배열입니다.

Code Samples

PredictProjectilePathByChannel

지정한 충돌 채널(InTraceChannel)을 기준으로 발사체의 예상 경로를 계산하고 결과를 반환합니다. PredictProjectilePathByObject와 동일한 방식으로 동작하지만, 충돌 채널을 기반으로 충돌 감지를 수행합니다.

Parameters

Enum.CollisionChannel InTraceChannel	충돌 감지에 사용할 충돌 채널입니다. 해당 채널에 대한 응답이 Block 또는 Overlap으로 설정된 오브젝트만 감지 대상이 됩니다.
PredictProjectilePathParams PredictParams	발사체의 시작 위치, 속도, 중력 등 경로 예측에 필요한 파라미터를 담은 객체입니다.
CollisionResponseParams InResponseParams	각 충돌 채널에 대한 응답 방식을 지정하는 객체입니다. 지정하지 않으면 기본 응답 설정이 적용됩니다.

Return

PredictProjectilePathResult	발사체의 이동 경로에서 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다.

Code Samples

PredictProjectilePathByChannelName

지정한 충돌 채널의 이름(ChannelDisplayName)을 기준으로 발사체의 예상 경로를 계산하고 결과를 반환합니다. PredictProjectilePathByChannel과 동일한 방식으로 동작하지만, Enum.CollisionChannel 대신 채널 이름(문자열)으로 충돌 채널을 지정할 수 있습니다. 내부적으로 이름을 충돌 채널로 변환한 뒤 PredictProjectilePathByChannel을 호출하며, 이름에 해당하는 채널을 찾지 못하면 경로 예측을 수행하지 않습니다.

Parameters

string ChannelDisplayName	충돌 감지에 사용할 충돌 채널의 이름입니다. 충돌 프로파일에 등록된 채널 이름을 우선으로 검색하며, 해당 이름의 채널을 찾을 수 없으면 경로 예측을 수행하지 않습니다.
PredictProjectilePathParams PredictParams	발사체의 시작 위치, 속도, 중력 등 경로 예측에 필요한 파라미터를 담은 객체입니다.
CollisionResponseParams InResponseParams	각 충돌 채널에 대한 응답 방식을 지정하는 객체입니다. 지정하지 않으면 기본 응답 설정이 적용됩니다.

Return

PredictProjectilePathResult	발사체의 이동 경로에서 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 지정한 이름에 해당하는 충돌 채널을 찾지 못하면 빈 결과 객체를 반환합니다.

Code Samples

PredictProjectilePathByObject

오브젝트 쿼리 파라미터를 기준으로 발사체의 예상 경로를 계산하고 결과를 반환합니다.

Parameters

PredictProjectilePathParams PredictParams	발사체의 시작 위치, 속도, 중력 등 경로 예측에 필요한 파라미터를 담은 객체입니다.
CollisionObjectQueryParams InObjectParams	충돌 감지 대상이 될 오브젝트 타입을 지정하는 객체입니다. 특정 오브젝트 타입만 충돌 대상으로 설정할 수 있습니다.

Return

PredictProjectilePathResult	발사체의 이동경로에서 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다.

Code Samples

Raycast

주어진 시작점(origin)과 방향(direction)을 기준으로 보이지 않는 광선(ray)을 발사해, 경로상의 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환됩니다. 필요할 경우 RaycastParams를 설정하여 감지 대상이나 조건을 지정할 수 있으며, RaycastParams를 생략하면 기본값이 적용되어 모든 파트가 감지 대상이 됩니다.

Parameters

Vector3 InOrigin	광선(ray)이 발사되는 출발 지점입니다.
Vector3 InDirection	광선의 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
RaycastParams InRaycastParams	오브젝트를 감지할지 조건을 설정 할 수 있는 설정 객체입니다. RaycastParams를 이용하여 특정 파트를 제외하거나, 충돌 그룹을 지정할 수 있습니다.이 값을 지정하지 않으면 기본값이 적용되어, 모든 오브젝트가 감지 대상이 됩니다.

Return

RaycastResult	광선이 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없으면 nil을 반환합니다.

Code Samples

local Workspace = game:GetService("Workspace")

local Origin = Vector3.new(0, 50, 0)
local Direction = Vector3.new(0, 0, -3000)

local RaycastParams = RaycastParams.new()
RaycastParams.FilterType = Enum.RaycastFilterType.Exclude
RaycastParams.FilterDescendantsInstances =
{
    Workspace.Part
}

local Result = Workspace:Raycast(Origin, Direction, RaycastParams)
if Result then
    print("Result Position : ", Result.Position)
    print("Result Name : ", Result.Instance.Name)
else
    print("Result nil")
end

RaycastMulti

주어진 시작점(origin)과 방향(direction)을 기준으로 광선(ray)을 발사해, 경로상의 모든 오브젝트를 감지하고 결과를 배열로 반환합니다. Raycast와 달리 첫 번째 충돌만 반환하는 것이 아니라, 광선 경로상의 모든 충돌 결과를 배열로 반환합니다. 관통 효과나 다중 대상 감지에 유용합니다.

Parameters

Vector3 InOrigin	광선(ray)이 발사되는 출발 지점입니다.
Vector3 InDirection	광선의 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
RaycastParams InRaycastParams	오브젝트를 감지할지 조건을 설정 할 수 있는 설정 객체입니다. RaycastParams를 이용하여 특정 파트를 제외하거나, 충돌 그룹을 지정할 수 있습니다.이 값을 지정하지 않으면 기본값이 적용되어, 모든 오브젝트가 감지 대상이 됩니다.

Return

Array	광선 경로상에서 감지된 모든 RaycastResult 객체들의 배열입니다.

Code Samples

local Workspace = game:GetService("Workspace")

local Origin = Vector3.new(0, 50, 0)
local Direction = Vector3.new(0, 0, -3000)

local RaycastParams = RaycastParams.new()
RaycastParams.FilterType = Enum.RaycastFilterType.Exclude
RaycastParams.FilterDescendantsInstances =
{
    Workspace.Part
}

local Results = Workspace:RaycastMulti(Origin, Direction, RaycastParams)
for _, Result in ipairs(Results) do
    print("Hit instance:", Result.Instance.Name)
    print("Hit position:", Result.Position)
end

RaycastMultiByChannel

지정한 충돌 채널(TraceChannel)을 기준으로 광선(ray)을 발사해, 경로상의 모든 오브젝트를 감지하고 결과를 배열로 반환합니다. RaycastMulti와 동일한 방식으로 동작하지만, 충돌 채널을 기반으로 충돌 감지를 수행합니다.

Parameters

Vector3 InOrigin	광선(ray)이 발사되는 출발 지점입니다.
Vector3 InDirection	광선의 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
Enum.CollisionChannel TraceChannel	충돌 감지에 사용할 충돌 채널입니다. 해당 채널에 대한 응답이 Block 또는 Overlap으로 설정된 오브젝트만 감지 대상이 됩니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있으며, 지정하지 않으면 기본값이 적용됩니다.
CollisionResponseParams InResponseParams	각 충돌 채널에 대한 응답 방식을 지정하는 객체입니다. 지정하지 않으면 기본 응답 설정이 적용됩니다.

Return

Array	광선 경로상에서 감지된 모든 RaycastResult 객체들의 배열입니다.

Code Samples

local Workspace = game:GetService("Workspace")

local Origin = Vector3.new(0, 50, 0)
local Direction = Vector3.new(0, 0, -3000)
local TraceChannel = Enum.CollisionChannel.L_ECC_WeaponTrace

local Results = Workspace:RaycastMultiByChannel(Origin, Direction, TraceChannel)
for _, Result in ipairs(Results) do
    print("Hit instance:", Result.Instance.Name)
    print("Hit position:", Result.Position)
end

RaycastMultiByChannelName

지정한 충돌 채널의 이름(ChannelDisplayName)을 기준으로 광선(ray)을 발사해, 경로상의 모든 오브젝트를 감지하고 결과를 배열로 반환합니다. RaycastMultiByChannel과 동일한 방식으로 동작하지만, Enum.CollisionChannel 대신 채널 이름(문자열)으로 충돌 채널을 지정할 수 있습니다. 내부적으로 이름을 충돌 채널로 변환한 뒤 RaycastMultiByChannel을 호출하며, 이름에 해당하는 채널을 찾지 못하면 감지를 수행하지 않습니다.

Parameters

Vector3 InOrigin	광선(ray)이 발사되는 출발 지점입니다.
Vector3 InDirection	광선의 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
string ChannelDisplayName	충돌 감지에 사용할 충돌 채널의 이름입니다. 충돌 프로파일에 등록된 채널 이름을 우선으로 검색하며, 해당 이름의 채널을 찾을 수 없으면 감지를 수행하지 않습니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있으며, 지정하지 않으면 기본값이 적용됩니다.
CollisionResponseParams InResponseParams	각 충돌 채널에 대한 응답 방식을 지정하는 객체입니다. 지정하지 않으면 기본 응답 설정이 적용됩니다.

Return

Array	광선 경로상에서 감지된 모든 RaycastResult 객체들의 배열입니다. 지정한 이름에 해당하는 충돌 채널을 찾지 못하면 빈 배열을 반환합니다.

Code Samples

local Workspace = game:GetService("Workspace")

local Origin = Vector3.new(0, 50, 0)
local Direction = Vector3.new(0, 0, -3000)
local ChannelDisplayName = "WeaponTrace"

local Results = Workspace:RaycastMultiByChannelName(Origin, Direction, ChannelDisplayName)
for _, Result in ipairs(Results) do
    print("Hit instance:", Result.Instance.Name)
end

RaycastMultiByObject

오브젝트 쿼리 파라미터를 기준으로 광선(ray)을 발사해, 경로상의 모든 오브젝트를 감지하고 결과를 배열로 반환합니다. RaycastMulti와 동일한 방식으로 동작하지만, 오브젝트 타입을 기반으로 충돌 감지를 수행합니다.

Parameters

Vector3 InOrigin	광선(ray)이 발사되는 출발 지점입니다.
Vector3 InDirection	광선의 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있습니다.
CollisionObjectQueryParams InObjectParams	충돌 감지 대상이 될 오브젝트 타입을 지정하는 객체입니다. 특정 오브젝트 타입만 충돌 대상으로 설정할 수 있습니다.

Return

Array	광선 경로상에서 감지된 모든 RaycastResult 객체들의 배열입니다.

Code Samples

local Workspace = game:GetService("Workspace")

local Origin = Vector3.new(0, 50, 0)
local Direction = Vector3.new(0, 0, -3000)

local ObjectParams = CollisionObjectQueryParams.new()
ObjectParams:AddObjectTypeToQuery(Enum.CollisionChannel.L_ECC_Pawn)

local Results = Workspace:RaycastMultiByObject(Origin, Direction, nil, ObjectParams)
for _, Result in ipairs(Results) do
    print("Hit instance:", Result.Instance.Name)
end

RaycastMultiByProfile

지정한 충돌 프로파일(ProfileName)을 기준으로 광선(ray)을 발사해, 경로상의 모든 오브젝트를 감지하고 결과를 배열로 반환합니다. RaycastMulti와 동일한 방식으로 동작하지만, 충돌 프로파일을 기반으로 충돌 감지를 수행합니다.

Parameters

Vector3 InOrigin	광선(ray)이 발사되는 출발 지점입니다.
Vector3 InDirection	광선의 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
string ProfileName	충돌 감지에 사용할 충돌 프로파일의 이름입니다. 해당 프로파일의 충돌 응답 설정에 따라 감지 대상이 결정됩니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있습니다.

Return

Array	광선 경로상에서 감지된 모든 RaycastResult 객체들의 배열입니다.

Code Samples

local Workspace = game:GetService("Workspace")

local Origin = Vector3.new(0, 50, 0)
local Direction = Vector3.new(0, 0, -3000)
local ProfileName = "Weapon"

local Results = Workspace:RaycastMultiByProfile(Origin, Direction, ProfileName)
for _, Result in ipairs(Results) do
    print("Hit instance:", Result.Instance.Name)
end

RaycastSingleByChannel

지정한 충돌 채널(TraceChannel)을 기준으로 광선(ray)을 발사해, 경로상에서 가장 먼저 충돌하는 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. Raycast와 동일한 방식으로 동작하지만, 충돌 채널을 기반으로 충돌 감지를 수행합니다.

Parameters

Vector3 InOrigin	광선(ray)이 발사되는 출발 지점입니다.
Vector3 InDirection	광선의 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
Enum.CollisionChannel TraceChannel	충돌 감지에 사용할 충돌 채널입니다. 해당 채널에 대한 응답이 Block 또는 Overlap으로 설정된 오브젝트만 감지 대상이 됩니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있으며, 지정하지 않으면 기본값이 적용됩니다.
CollisionResponseParams InResponseParams	각 충돌 채널에 대한 응답 방식을 지정하는 객체입니다. 지정하지 않으면 기본 응답 설정이 적용됩니다.

Return

RaycastResult	광선이 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없으면 nil을 반환합니다.

Code Samples

local Workspace = game:GetService("Workspace")

local Origin = Vector3.new(0, 50, 0)
local Direction = Vector3.new(0, 0, -3000)
local TraceChannel = Enum.CollisionChannel.L_ECC_WeaponTrace

local Result = Workspace:RaycastSingleByChannel(Origin, Direction, TraceChannel)
if Result then
    print("Hit instance:", Result.Instance.Name)
    print("Hit position:", Result.Position)
else
    print("Result nil")
end

RaycastSingleByChannelName

지정한 충돌 채널의 이름(ChannelDisplayName)을 기준으로 광선(ray)을 발사해, 경로상에서 가장 먼저 충돌하는 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. RaycastSingleByChannel과 동일한 방식으로 동작하지만, Enum.CollisionChannel 대신 채널 이름(문자열)으로 충돌 채널을 지정할 수 있습니다. 내부적으로 이름을 충돌 채널로 변환한 뒤 RaycastSingleByChannel을 호출하며, 이름에 해당하는 채널을 찾지 못하면 충돌 감지를 수행하지 않습니다.

Parameters

Vector3 InOrigin	광선(ray)이 발사되는 출발 지점입니다.
Vector3 InDirection	광선의 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
string ChannelDisplayName	충돌 감지에 사용할 충돌 채널의 이름입니다. 충돌 프로파일에 등록된 채널 이름을 우선으로 검색하며, 해당 이름의 채널을 찾을 수 없으면 감지를 수행하지 않습니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있으며, 지정하지 않으면 기본값이 적용됩니다.
CollisionResponseParams InResponseParams	각 충돌 채널에 대한 응답 방식을 지정하는 객체입니다. 지정하지 않으면 기본 응답 설정이 적용됩니다.

Return

RaycastResult	광선이 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없거나 지정한 이름에 해당하는 충돌 채널을 찾지 못하면 nil을 반환합니다.

Code Samples

local Workspace = game:GetService("Workspace")

local Origin = Vector3.new(0, 50, 0)
local Direction = Vector3.new(0, 0, -3000)
local ChannelDisplayName = "WeaponTrace"

local Result = Workspace:RaycastSingleByChannelName(Origin, Direction, ChannelDisplayName)
if Result then
    print("Hit instance:", Result.Instance.Name)
else
    print("Result nil")
end

RaycastSingleByObject

오브젝트 쿼리 파라미터를 기준으로 광선(ray)을 발사해, 경로상에서 가장 먼저 충돌하는 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. Raycast와 동일한 방식으로 동작하지만, 오브젝트 타입을 기반으로 충돌 감지를 수행합니다.

Parameters

Vector3 InOrigin	광선(ray)이 발사되는 출발 지점입니다.
Vector3 InDirection	광선의 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있습니다.
CollisionObjectQueryParams InObjectParams	충돌 감지 대상이 될 오브젝트 타입을 지정하는 객체입니다. 특정 오브젝트 타입만 충돌 대상으로 설정할 수 있습니다.

Return

RaycastResult	광선이 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없으면 nil을 반환합니다.

Code Samples

local Workspace = game:GetService("Workspace")

local Origin = Vector3.new(0, 50, 0)
local Direction = Vector3.new(0, 0, -3000)

local ObjectParams = CollisionObjectQueryParams.new()
ObjectParams:AddObjectTypeToQuery(Enum.CollisionChannel.L_ECC_Pawn)

local Result = Workspace:RaycastSingleByObject(Origin, Direction, nil, ObjectParams)
if Result then
    print("Hit instance:", Result.Instance.Name)
else
    print("Result nil")
end

RaycastSingleByProfile

지정한 충돌 프로파일(ProfileName)을 기준으로 광선(ray)을 발사해, 경로상에서 가장 먼저 충돌하는 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. Raycast와 동일한 방식으로 동작하지만, 충돌 프로파일을 기반으로 충돌 감지를 수행합니다.

Parameters

Vector3 InOrigin	광선(ray)이 발사되는 출발 지점입니다.
Vector3 InDirection	광선의 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
string ProfileName	충돌 감지에 사용할 충돌 프로파일의 이름입니다. 해당 프로파일의 충돌 응답 설정에 따라 감지 대상이 결정됩니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있습니다.

Return

RaycastResult	광선이 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없으면 nil을 반환합니다.

Code Samples

local Workspace = game:GetService("Workspace")

local Origin = Vector3.new(0, 50, 0)
local Direction = Vector3.new(0, 0, -3000)
local ProfileName = "Weapon"

local Result = Workspace:RaycastSingleByProfile(Origin, Direction, ProfileName)
if Result then
    print("Hit instance:", Result.Instance.Name)
else
    print("Result nil")
end

Spherecast

주어진 시작점(Origin)과 반지름(Radius)으로 정의된 구 형태의 공간을 지정한 방향(Direction)으로 이동시키며, 경로상의 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. Raycast와 유사하지만, 광선 대신 구 형태로 충돌을 감지하므로 더 넓은 영역의 오브젝트를 탐지할 수 있습니다. 근접 무기 판정이나 넓은 영역의 충돌 감지에 유용합니다.

Parameters

Vector3 InOrigin	구가 시작되는 출발 지점입니다.
number InRadius	구의 반지름입니다.
Vector3 InDirection	구가 이동할 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
RaycastParams InRaycastParams	오브젝트를 감지할지 조건을 설정 할 수 있는 설정 객체입니다. RaycastParams를 이용하여 특정 파트를 제외하거나, 충돌 그룹을 지정할 수 있습니다.이 값을 지정하지 않으면 기본값이 적용되어, 모든 오브젝트가 감지 대상이 됩니다.

Return

RaycastResult	구의 경로에서 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없으면 nil을 반환합니다.

Code Samples

SpherecastSingleByChannel

주어진 위치(CFrame)와 반지름(Radius)으로 정의된 구 형태의 공간을 지정한 방향(Direction)으로 이동시키며, 지정한 충돌 채널(TraceChannel)을 기준으로 경로상의 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. Spherecast와 동일한 방식으로 동작하지만, 충돌 채널을 기반으로 충돌 감지를 수행합니다.

Parameters

CFrame InCFrame	구의 초기 위치와 회전을 나타내는 좌표 프레임입니다.
number InRadius	구의 반지름입니다.
Vector3 InDirection	구가 이동할 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
Enum.CollisionChannel TraceChannel	충돌 감지에 사용할 충돌 채널입니다. 해당 채널에 대한 응답이 Block 또는 Overlap으로 설정된 오브젝트만 감지 대상이 됩니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있으며, 지정하지 않으면 기본값이 적용됩니다.
CollisionResponseParams InResponseParams	각 충돌 채널에 대한 응답 방식을 지정하는 객체입니다. 지정하지 않으면 기본 응답 설정이 적용됩니다.

Return

RaycastResult	구의 경로에서 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없으면 nil을 반환합니다.

Code Samples

SpherecastSingleByChannelName

주어진 위치(CFrame)와 반지름(Radius)으로 정의된 구 형태의 공간을 지정한 방향(Direction)으로 이동시키며, 지정한 충돌 채널의 이름(ChannelDisplayName)을 기준으로 경로상의 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. SpherecastSingleByChannel과 동일한 방식으로 동작하지만, Enum.CollisionChannel 대신 채널 이름(문자열)으로 충돌 채널을 지정할 수 있습니다. 내부적으로 이름을 충돌 채널로 변환한 뒤 SpherecastSingleByChannel을 호출하며, 이름에 해당하는 채널을 찾지 못하면 충돌 감지를 수행하지 않습니다.

Parameters

CFrame InCFrame	구의 초기 위치와 회전을 나타내는 좌표 프레임입니다.
number InRadius	구의 반지름입니다.
Vector3 InDirection	구가 이동할 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
string ChannelDisplayName	충돌 감지에 사용할 충돌 채널의 이름입니다. 충돌 프로파일에 등록된 채널 이름을 우선으로 검색하며, 해당 이름의 채널을 찾을 수 없으면 감지를 수행하지 않습니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있으며, 지정하지 않으면 기본값이 적용됩니다.
CollisionResponseParams InResponseParams	각 충돌 채널에 대한 응답 방식을 지정하는 객체입니다. 지정하지 않으면 기본 응답 설정이 적용됩니다.

Return

RaycastResult	구의 경로에서 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없거나 지정한 이름에 해당하는 충돌 채널을 찾지 못하면 nil을 반환합니다.

Code Samples

SpherecastSingleByObject

주어진 위치(CFrame)와 반지름(Radius)으로 정의된 구 형태의 공간을 지정한 방향(Direction)으로 이동시키며, 오브젝트 쿼리 파라미터를 기준으로 경로상의 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. Spherecast와 동일한 방식으로 동작하지만, 오브젝트 타입을 기반으로 충돌 감지를 수행합니다.

Parameters

CFrame InCFrame	구의 초기 위치와 회전을 나타내는 좌표 프레임입니다.
number InRadius	구의 반지름입니다.
Vector3 InDirection	구가 이동할 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있습니다.
CollisionObjectQueryParams InObjectParams	충돌 감지 대상이 될 오브젝트 타입을 지정하는 객체입니다. 특정 오브젝트 타입만 충돌 대상으로 설정할 수 있습니다.

Return

RaycastResult	구의 경로에서 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없으면 nil을 반환합니다.

Code Samples

SpherecastSingleByProfile

주어진 위치(CFrame)와 반지름(Radius)으로 정의된 구 형태의 공간을 지정한 방향(Direction)으로 이동시키며, 지정한 충돌 프로파일(ProfileName)을 기준으로 경로상의 오브젝트를 감지하고 결과를 RaycastResult 객체로 반환합니다. Spherecast와 동일한 방식으로 동작하지만, 충돌 프로파일을 기반으로 충돌 감지를 수행합니다.

Parameters

CFrame InCFrame	구의 초기 위치와 회전을 나타내는 좌표 프레임입니다.
number InRadius	구의 반지름입니다.
Vector3 InDirection	구가 이동할 방향을 나타내는 벡터이며, 이 벡터의 길이(크기)에 따라 감지 가능한 거리도 함께 결정됩니다.
string ProfileName	충돌 감지에 사용할 충돌 프로파일의 이름입니다. 해당 프로파일의 충돌 응답 설정에 따라 감지 대상이 결정됩니다.
CollisionQueryParams InQueryParams	충돌 쿼리의 세부 조건을 설정할 수 있는 객체입니다. 감지 대상이나 무시할 오브젝트 등을 세밀하게 지정할 수 있습니다.

Return

RaycastResult	구의 경로에서 충돌한 첫 번째 오브젝트에 대한 정보를 담은 결과 객체입니다. 충돌이 없으면 nil을 반환합니다.

Code Samples

Events