Roblox lança State Machine e Expression no Animation Graph Editor, fora do beta

Os dois nós substituem lógica de transição que antes dependia de script e funcionam no Studio e em jogos publicados.

Compartilhar

Publicada em horário de Brasília2 min de leitura

Capa da matéria sobre State Machines and Luau Expressions in Animation Graphs
Imagem: Arte: jkit.tools

Em resumo

  • O Roblox liberou para todos os criadores os nós State Machine e Expression no Animation Graph Editor.
  • State Machine controla o estado de animação do personagem e só permite as transições configuradas.
  • Expression roda uma linha de Luau no grafo para calcular valores e condições.

O Roblox lançou em versão completa, fora do beta, os nós State Machine e Expression no Animation Graph Editor. Os nós State Machine acompanham em qual estado de animação o personagem está e só permitem as transições configuradas, enquanto os nós Expression permitem escrever uma linha de Luau no grafo para calcular um valor de propriedade ou uma condição de transição.

Na State Machine, o estado (Any) permite que uma transição dispare a partir de qualquer outro estado: uma transição de (Any) para Holster quando IsEquipped == false, por exemplo, deixa o personagem guardar a espada no meio de um combo. Já as expressões têm limites: não aceitam loops, definição de funções, tabelas, require(), chamadas de método como obj:Method(), bibliotecas além de math nem acesso ao DataModel, e o que passar disso fica para um script.

No Animation Graph Editor, o nó é criado com clique direito no canvas e Insert Node > State Machine. Qualquer nó que gere uma pose, como um Clip, um Blend1D ou outra State Machine, se conecta ao pino New Input, e cada entrada vira um estado. Open edita estados e transições, e novos estados também nascem com Create State na barra de ferramentas ou com Add State no menu do canvas.

Arrastar de um estado a outro cria uma transição, que se edita ao clicar nela. O estado (Entry) marca onde a máquina começa e deve ser ligado ao estado inicial. Em Wait For, a opção Expression dispara a transição quando uma condição Luau sobre os parâmetros do grafo é verdadeira, como Speed > 5, e Finished dispara quando a animação do estado termina; estados em loop terminam ao fim de cada volta.

Quando mais de uma transição pode disparar no mesmo frame, vence a de maior Priority, e cada valor de Priority precisa ser único dentro da state machine.

As expressões suportam aritmética (+, -, *, /, ^, % e //), comparações, incluindo == e ~= contra nil, além de and, or e not. Também aceitam condicionais como if speed > 10 then "sprint" elseif speed > 2 then "run" else "idle", a biblioteca math (math.clamp(), math.sin(), math.max()) e Vector3.new() com acesso a membros como moveDir.Magnitude ou position.X. É possível ainda escrever várias linhas, com variáveis locais e if/else não aninhados.

Entra

  • State Machine

Todas as mudanças

Mudanças das notas oficiais
ÁreaMudança
> State MachineNós State Machine acompanham em qual estado de animação o personagem está e só permitem as transições configuradas
> ExpressionNós Expression permitem escrever uma linha de Luau no grafo para calcular um valor de propriedade ou uma condição de transição
Set Up States and Transitions > State MachineClique com o botão direito no canvas e escolha Insert Node > State Machine
Set Up States and Transitions > State MachineQualquer nó que gere uma pose se conecta ao pino New Input da State Machine; cada entrada vira um estado
Set Up States and Transitions > State MachineOpen edita estados e transições; estados também podem ser criados com Create State ou Add State
Set Up States and TransitionsArrastar de um estado a outro cria uma transição
Set Up States and Transitions > (Entry)(Entry) é onde a state machine começa e deve ser ligado ao estado inicial
Set Up States and Transitions > (Any)(Any) permite que uma transição dispare a partir de qualquer outro estado
Set Up States and Transitions > Wait ForWait For: Expression dispara com condição Luau verdadeira; Finished dispara ao fim da animação do estado
Set Up States and Transitions > LengthLength define a duração da mistura entre dois estados, em segundos
Set Up States and Transitions > CurveCurve define a curva de suavização da mistura
Set Up States and Transitions > PriorityPriority: com várias transições no mesmo frame, vence a de maior prioridade; deve ser única na state machine
Write Parameter Math in an Expression > Supported SyntaxExpressões suportam aritmética: +, -, *, /, ^, % e //
Write Parameter Math in an Expression > Supported SyntaxExpressões suportam comparações, incluindo == e ~= com nil, além de and, or e not
Write Parameter Math in an Expression > Supported SyntaxExpressões suportam condicionais if/elseif/else
Write Parameter Math in an Expression > Supported SyntaxExpressões suportam a biblioteca math, como math.clamp(), math.sin() e math.max()
Write Parameter Math in an Expression > Supported SyntaxExpressões suportam Vector3.new() e acesso a membros como moveDir.Magnitude ou position.X
Write Parameter Math in an Expression > Supported SyntaxExpressões suportam concatenação de strings com ..
Write Parameter Math in an Expression > Supported SyntaxExpressões suportam várias linhas com variáveis locais e if/else não aninhados
Write Parameter Math in an Expression > Supported SyntaxExpressões não suportam loops, funções, tabelas, require(), chamadas de método, bibliotecas além de math nem acesso ao DataModel
ResourcesAnimation Graph Editor documentation
ResourcesState Machine documentation
ResourcesExpressions documentation
ResourcesSample place
Fonte: Roblox
Compartilhar

Como esta matéria foi feita

Texto redigido com apoio de inteligência artificial a partir de uma ficha de fatos montada com as fontes listadas abaixo. Programas conferiram números, datas e nomes contra essa ficha, e Vynuo, responsável editorial, aprovou o texto antes da publicação.

Fontes desta matéria

Como sabemos: informação de fonte oficial (Roblox), consultada em 19 de novembro de 2026.

  1. Oficial[Full Release] State Machines and Luau Expressions in Animation Graphs (abre em nova aba)Roblox, acessada em 19 de novembro de 2026

Tópicos

Mais de Jogos