Aprenda
Classe do mecanismo
Beam

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.


Amostras de código
Criando um Feixe do Zero
-- criar anexos
local att0 = Instance.new("Attachment")
local att1 = Instance.new("Attachment")
-- pai para o terreno (pode ser uma parte em vez disso)
att0.Parent = workspace.Terrain
att1.Parent = workspace.Terrain
-- posicionar anexos
att0.Position = Vector3.new(0, 10, 0)
att1.Position = Vector3.new(0, 10, 10)
-- criar feixe
local beam = Instance.new("Beam")
beam.Attachment0 = att0
beam.Attachment1 = att1
-- propriedades de aparência
beam.Color = ColorSequence.new({ -- uma sequência de cores mudando de branco para azul
ColorSequenceKeypoint.new(0, Color3.fromRGB(255, 255, 255)),
ColorSequenceKeypoint.new(1, Color3.fromRGB(0, 255, 255)),
})
beam.LightEmission = 1 -- usar mistura aditiva
beam.LightInfluence = 0 -- feixe não influenciado pela luz
beam.Texture = "rbxasset://textures/particles/sparkles_main.dds" -- uma textura de brilho embutida
beam.TextureMode = Enum.TextureMode.Wrap -- envolver para que o comprimento possa ser definido por TextureLength
beam.TextureLength = 1 -- textura repetida tem 1 stud de comprimento
beam.TextureSpeed = 1 -- velocidade da textura lenta
beam.Transparency = NumberSequence.new({ -- feixe desaparece no final
NumberSequenceKeypoint.new(0, 0),
NumberSequenceKeypoint.new(0.8, 0),
NumberSequenceKeypoint.new(1, 1),
})
beam.ZOffset = 0 -- renderizar na posição do feixe sem deslocamento
-- propriedades de forma
beam.CurveSize0 = 2 -- criar um feixe curvado
beam.CurveSize1 = -2 -- criar um feixe curvado
beam.FaceCamera = true -- feixe é visível de todos os ângulos
beam.Segments = 10 -- resolução de curva padrão
beam.Width0 = 0.2 -- começa pequeno
beam.Width1 = 2 -- termina grande
-- pai feixe
beam.Enabled = true
beam.Parent = att0

Referência API
Propriedades
Attachment0
Ler Parallel
Recursos: Basic
Beam.Attachment0:Attachment

Attachment1
Ler Parallel
Recursos: Basic
Beam.Attachment1:Attachment

Brightness
Ler Parallel
Recursos: Basic
Beam.Brightness:number

Color
Ler Parallel
Recursos: Basic
Beam.Color:ColorSequence

CurveSize0
Ler Parallel
Recursos: Basic
Beam.CurveSize0:number

CurveSize1
Ler Parallel
Recursos: Basic
Beam.CurveSize1:number

Enabled
Ler Parallel
Recursos: Basic
Beam.Enabled:boolean

FaceCamera
Ler Parallel
Recursos: Basic
Beam.FaceCamera:boolean

LightEmission
Ler Parallel
Recursos: Basic
Beam.LightEmission:number

LightInfluence
Ler Parallel
Recursos: Basic
Beam.LightInfluence:number

LocalTransparencyModifier
Oculto
Não replicado
Ler Parallel
Recursos: Basic
Beam.LocalTransparencyModifier:number

Segments
Ler Parallel
Recursos: Basic
Beam.Segments:number

Texture
Ler Parallel
Recursos: Basic
Beam.Texture:ContentId

TextureLength
Ler Parallel
Recursos: Basic
Beam.TextureLength:number

TextureMode
Ler Parallel
Recursos: Basic
Beam.TextureMode:Enum.TextureMode

TextureSpeed
Ler Parallel
Recursos: Basic
Beam.TextureSpeed:number

Transparency
Ler Parallel
Recursos: Basic
Beam.Transparency:NumberSequence

Width0
Ler Parallel
Recursos: Basic
Beam.Width0:number

Width1
Ler Parallel
Recursos: Basic
Beam.Width1:number

ZOffset
Ler Parallel
Recursos: Basic
Beam.ZOffset:number
Amostras de código
Camadas de Feixes
-- Criar feixes
local beam1 = Instance.new("Beam")
beam1.Color = ColorSequence.new(Color3.new(1, 0, 0))
beam1.FaceCamera = true
beam1.Width0 = 3
beam1.Width1 = 3
local beam2 = Instance.new("Beam")
beam2.Color = ColorSequence.new(Color3.new(0, 1, 0))
beam2.FaceCamera = true
beam2.Width0 = 2
beam2.Width1 = 2
local beam3 = Instance.new("Beam")
beam3.Color = ColorSequence.new(Color3.new(0, 0, 1))
beam3.FaceCamera = true
beam3.Width0 = 1
beam3.Width1 = 1
-- Camadas de feixes
beam1.ZOffset = 0
beam2.ZOffset = 0.01
beam3.ZOffset = 0.02
-- Criar anexos
local attachment0 = Instance.new("Attachment")
attachment0.Position = Vector3.new(0, -10, 0)
attachment0.Parent = workspace.Terrain
local attachment1 = Instance.new("Attachment")
attachment1.Position = Vector3.new(0, 10, 0)
attachment1.Parent = workspace.Terrain
-- Conectar feixes
beam1.Attachment0 = attachment0
beam1.Attachment1 = attachment1
beam2.Attachment0 = attachment0
beam2.Attachment1 = attachment1
beam3.Attachment0 = attachment0
beam3.Attachment1 = attachment1
-- Adicionar feixes como filhos
beam1.Parent = workspace
beam2.Parent = workspace
beam3.Parent = workspace

Métodos
SetTextureOffset
Recursos: Basic
Beam:SetTextureOffset(offset:number):()
Parâmetros
offset:number
Valor Padrão: 0
Devolução
()

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.