Roblox CFrame Visualizer

O Roblox CFrame Visualizer permite construir e visualizar valores CFrame de forma interativa com uma pré-visualização 3D isométrica em tempo real mostrando a orientação dos eixos (Direita=Vermelho, Cima=Verde, Frente=Azul). Ajuste os controles deslizantes de posição e ângulos de Euler para ver como a rotação e a translação afetam seu objeto, depois copie o código Luau gerado (CFrame.Angles, math.rad ou construtor completo de 12 componentes) diretamente no Roblox Studio. Inclui presets para orientações comuns e exibição da matriz de rotação em tempo real. Gratuito, sem cadastro.

Presets

Posição

XYZ

Rotação (Ângulos de Euler)

X (Pitch)0.0°

Y (Yaw)0.0°

Z (Roll)0.0°

Pré-visualização 3D

Direita (X)Cima (Y)Frente (-Z)

Matriz de Rotação

[  1.0000    0.0000    0.0000 ]
[  0.0000    1.0000    0.0000 ]
[  0.0000    0.0000    1.0000 ]

Código Luau

-- Using Angles (radians):
CFrame.new(0, 0, 0) * CFrame.Angles(0.0000, 0.0000, 0.0000)

-- Using math.rad:
CFrame.new(0, 0, 0) * CFrame.Angles(math.rad(0), math.rad(0), math.rad(0))

-- Full rotation matrix:
CFrame.new(0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0, 1)

Operações CFrame

CFrame A = Pré-visualização 3D

CFrame B

XYZ

RX°RY°RZ°

CFrame Resultado

Position: (0.00, 0.00, 0.00)

Euler: (0.0°, 0.0°, 0.0°)

Tem uma sugestão?

Solicite uma nova ferramenta ou sugira melhorias — junte-se à nossa comunidade no Slack!

Deixar feedback no Slack

O que é o Roblox CFrame Visualizer?

O Roblox CFrame Visualizer é uma ferramenta online gratuita para entender e construir valores CFrame (Coordinate Frame) usados no Roblox Studio. Um CFrame representa uma posição e orientação no espaço 3D — ele combina uma posição Vector3 (X, Y, Z) com uma matriz de rotação 3×3. Esta ferramenta oferece uma pré-visualização 3D isométrica interativa com eixos codificados por cores (Vermelho=Direita/X, Verde=Cima/Y, Azul=Frente/-Z), controles deslizantes de ângulos de Euler para controle intuitivo de rotação e geração automática de código Luau em três formatos: CFrame.Angles com radianos, wrapper math.rad e o construtor completo de 12 componentes.

Como Usar Este CFrame Visualizer

Defina a posição usando os campos de entrada X, Y, Z ou selecione uma orientação preset
Ajuste os controles deslizantes de ângulos de Euler (Pitch/Yaw/Roll) para rotacionar o objeto e observe a pré-visualização 3D atualizar em tempo real
Leia a matriz de rotação e copie o código Luau gerado para o Roblox Studio
Use as Operações CFrame (Multiplicar, Inversa, LookAt) para transformações avançadas
Clique em Aplicar ao Principal para transferir os resultados da operação de volta ao visualizador

Perguntas Frequentes

O que é um CFrame no Roblox?

Um CFrame (Coordinate Frame) é um tipo de dado do Roblox que armazena tanto a posição quanto a orientação no espaço 3D. Ele contém uma posição Vector3 (X, Y, Z) e uma matriz de rotação 3×3. CFrames são usados para posicionar e orientar Parts, Models, Cameras e outros objetos em jogos Roblox. Os construtores mais comuns são CFrame.new(x, y, z) para apenas posição e CFrame.Angles(rx, ry, rz) para rotação.

Em que ordem o Roblox aplica as rotações de ângulos de Euler?

O Roblox usa a ordem de rotação intrínseca YXZ. Quando você chama CFrame.Angles(rx, ry, rz), as rotações são aplicadas como Ry × Rx × Rz (Yaw primeiro, depois Pitch, depois Roll). Isso significa que a rotação no eixo Y acontece no espaço global, enquanto as rotações X e Z acontecem em relação ao referencial já rotacionado. Isso é importante para entender ao combinar rotações.

Como converter graus para radianos no CFrame.Angles?

CFrame.Angles() espera ângulos em radianos, não em graus. Use math.rad() para converter: CFrame.Angles(math.rad(45), math.rad(90), 0) rotaciona 45° ao redor de X e 90° ao redor de Y. A fórmula é radianos = graus × π / 180. Esta ferramenta gera automaticamente código com radianos brutos e wrappers math.rad().

O que significam os eixos coloridos no CFrame Visualizer?

Os três eixos coloridos representam o sistema de coordenadas local do objeto após a rotação: Vermelho é o vetor Direita (eixo +X), Verde é o vetor Cima (eixo +Y) e Azul é o vetor Frente (eixo -Z, seguindo a convenção do Roblox onde -Z aponta para frente). Quando a rotação é identidade (0,0,0), eles se alinham com os eixos globais. Conforme você rotaciona, os eixos se movem com o objeto mostrando sua nova orientação.

Como usar CFrame.lookAt no Roblox?

CFrame.lookAt(fromPosition, targetPosition) cria um CFrame posicionado em fromPosition com sua direção frontal (-Z) apontando para targetPosition. Isso é comumente usado para câmeras, NPCs olhando para jogadores ou mira de projéteis. O vetor Up padrão é (0,1,0). A operação LookAt deste visualizador permite experimentar com valores lookAt e ver a rotação resultante.