Trail

Trail : Instance

Overview

Description

The Trail object creates a visual trail effect behind moving objects in a 3D environment. It is commonly used in simulations, animations, and games for aesthetic or functional purposes. Trails are customizable with various properties, allowing users to define their appearance, behavior, and interaction over time.

Properties

Color

ColorSequence

Defines the color of the trail along its lifetime. The ColorSequence specifies how the color changes as the trail ages.

Code Samples

local Trail = script.Parent

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

ColorTexture

string

URL or asset identifier for the texture applied along the trail’s length. This can give the trail a patterned or detailed look.

Code Samples

local Trail = script.Parent

Trail.ColorTexture = "ovdrassetid://1234"

ColorTextureLength

number

Specifies the length of the color texture in studs (world units). Adjusting this affects how the texture stretches or repeats along the trail.

Code Samples

local Trail = script.Parent

Trail.ColorTextureLength = 5

ColorTextureSpeed

number

Controls the speed at which the color texture scrolls along the trail. A positive value scrolls in one direction, while a negative value scrolls in the opposite direction.

Code Samples

local Trail = script.Parent

Trail.ColorTextureSpeed = 10

AlphaTexture

string

URL or asset identifier for the texture defining the alpha (transparency) pattern of the trail. This creates visual variations in the trail’s transparency.

Code Samples

local Trail = script.Parent

Trail.AlphaTexture = "ovdrassetid://1234"

AlphaTextureLength

number

Defines the length of the alpha texture in studs. Adjusting this influences how the transparency pattern is applied along the trail.

Code Samples

local Trail = script.Parent

Trail.AlphaTextureLength = 5

AlphaTextureSpeed

number

Controls the scrolling speed of the alpha texture along the trail. Positive values move the texture in one direction, and negative values in the opposite direction.

Code Samples

local Trail = script.Parent

Trail.AlphaTextureSpeed = 10

Transparency

NumberSequence

Controls the transparency of the trail across its lifetime. The NumberSequence defines how the transparency evolves as the trail ages.

Code Samples

local Trail = script.Parent

Trail.Transparency = NumberSequence.new(0.8)

Enabled

bool

Indicates whether the trail is currently visible. Setting this to true shows the trail, while false hides it.

Code Samples

local Trail = script.Parent

Trail.Enabled = false

Lifetime

number

Specifies the lifetime of the trail in seconds. Once the lifetime expires, the trail disappears.

Code Samples

local Trail = script.Parent

Trail.LifeTime = 0.5

Width

number

Defines the width of the trail in studs. This value determines how wide the trail appears.

Code Samples

local Trail = script.Parent

Trail.Width = 100

WidthScale

NumberSequence

Controls the width of the trail along its lifetime. The NumberSequence defines how the width changes over time.

Code Samples

local Trail = script.Parent

Trail.WidthScale = NumberSequence.new(3)

Offset

Vector3

Specifies the offset of the trail from its attachment point. This can be used to position the trail relative to the object it follows.

Code Samples

local Trail = script.Parent

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

Methods

Events