# Trail

Trail : `Instance`

## Overview

물체가 이동할 때 남기는 잔상(궤적) 효과를 생성하는 인스턴스로, 검기 효과, 스피드 부스트, 마법 궤적, 총알 흔적 같은 효과를 만들 때 사용됩니다.

Part와 같은 특정 오브젝트의 자식으로 설정하여 해당 오브젝트의 움직임에 따라 효과를 표시할 수 있습니다.

## Properties

### Color

`ColorSequence`

Trail이 생성되고 사라질 때 어떤 색상으로 점진적으로 표시될지 ColorSequence를 이용하여 설정할 수 있습니다.

Trail에 텍스처가 적용된 경우, 해당 텍스처 위에 이 색상이 오버레이되어 표현됩니다.

#### Code Samples

```lua
local Trail = script.Parent

Trail.Color = ColorSequence.new(Color3.fromRGB(255, 0, 0))
```

### Enabled

`boolean`

Trail의 표시 여부를 지정하는 속성입니다.

Trail의 궤적이 남아있는 상태에서 Enabled를 false로 변경하면 즉시 사라집니다.

#### Code Samples

```lua
local Trail = script.Parent

Trail.Enabled = false
```

### Lifetime

`number`

Trail의 궤적이 몇 초 동안 유지될지를 지정하는 속성입니다.

#### Code Samples

```lua
local Trail = script.Parent

Trail.LifeTime = 0.5
```

### Offset

`Vector3`

Trail의 위치를 부모 객체를 기준으로 상대적으로 조정하는 속성입니다.

#### Code Samples

```lua
local Trail = script.Parent

Trail.Offset = Vector3.new(0, 100, 0)
```

### Texture

`string`

Trail에 표현할 텍스처를 지정하는 속성입니다.

#### Code Samples

```lua
local Trail = script.Parent

Trail.Texture = "ovdrassetid://1234"
```

### TextureLength

`number`

Trail에 적용된 텍스처의 길이를 지정하는 속성입니다.

#### Code Samples

```lua
local Trail = script.Parent

Trail.TextureLength = 5
```

### TextureSpeed

`number`

Trail에 적용된 텍스처의 속도를 지정하는 속성입니다.

#### Code Samples

```lua
local Trail = script.Parent

Trail.TextureSpeed = 10
```

### Transparency

`NumberSequence`

Trail이 생성되고 사라질 때 NumberSequence를 사용하여 투명도가 점진적으로 변화하도록 설정할 수 있습니다.

#### Code Samples

```lua
local Trail = script.Parent

Trail.Transparency = NumberSequence.new(0.8)
```

### Width

`number`

Trail의 너비를 지정하는 속성입니다.

#### Code Samples

```lua
local Trail = script.Parent

Trail.Width = 100
```

### WidthScale

`NumberSequence`

Trail의 너비를 NumberSequence를 사용하여 점진적으로 변화하도록 설정할 수 있습니다.

#### Code Samples

```lua
local Trail = script.Parent

Trail.WidthScale = NumberSequence.new(3)
```

## Methods

## Events

## See also

{% content-ref url="/pages/xSyoRShlKPjBIwbLoQMO" %}
[VFX](/korean/manual/studio-manual/object/vfx.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.overdare.com/korean/development/api-reference/classes/trail.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.