Interatividade

Blueprint

Adicione lógica com um grafo visual de nós: eventos, condições e ações — sem código.

O Blueprint é o editor visual de grafo de nós do Easelt Builder — o lugar onde o seu design deixa de ser uma maquete estática e começa a *fazer coisas*. Você o abre com o botão Blueprint, arrasta nós da paleta NODES e os conecta entre si para que um clique abra uma janela, um interruptor revele um painel, ou um botão altere o texto e a cor de um elemento. Quando você exporta, todo o grafo é compilado em gui.lua e roda ao vivo no jogo.

Abrindo o Blueprint

Clique no botão Blueprint para alternar da tela de design para o editor de grafo de nós. Em vez de arrastar elementos visuais, você agora arrasta *nós* — pequenos blocos de lógica — da paleta NODES para a tela do grafo e, em seguida, conecta os seus pinos para descrever o comportamento. Tudo o que você conecta aqui se torna lógica de jogo real, não apenas um efeito de pré-visualização.

Como o grafo funciona

Um grafo do Blueprint é lido da esquerda para a direita ao longo das ligações. Um evento é disparado (algo que o jogador faz), uma condição opcional decide qual ramo seguir, e uma ou mais ações executam o resultado. Você constrói o comportamento arrastando esses três tipos de nó e conectando o pino out de um ao pino in do próximo.

Nós de evento (verdes)

O ponto de partida de uma cadeia. Estão vinculados a um elemento específico e disparam quando o jogador interage com ele.

Nós de condição / "If"

Ramificam o fluxo. Fazem uma pergunta de sim/não e enviam o grafo por um caminho then ou else.

Nós de ação

A carga útil. Abrem janelas, mostram ou ocultam elementos, alteram texto e cor, reproduzem animações e sons, ou trocam de design.

Nós de evento

Os nós de evento são verdes e cada um está vinculado a um elemento — clique no campo de destino do nó para escolher qual elemento ele escuta. É por eles que toda cadeia começa.

Evento	O que faz
`onClick`	Dispara quando o jogador clica no elemento vinculado.
`onHover`	Dispara quando o ponteiro passa sobre o elemento vinculado.
`onLeave`	Dispara quando o ponteiro sai do elemento vinculado.
`onChange`	Dispara quando uma caixa de seleção ou interruptor muda de estado (ligado/desligado).
`onOpen`	Dispara quando uma janela abre.
`onClose`	Dispara quando uma janela fecha.

Nós de condição

Os nós de condição (ou "If") ramificam a sua lógica. Cada um tem uma saída then e uma saída else — conecte as ações que você quer em cada caminho. Clique no campo de destino do nó para escolher o elemento ou a janela que ele testa.

Condição	O que verifica
`ifWin`	Se uma janela está atualmente aberta.
`ifSwitch`	Se um interruptor ou caixa de seleção está atualmente ligado.
`ifVis`	Se um elemento está atualmente visível.

Nós de ação

Os nós de ação fazem o trabalho. Encadeie-os em sequência para executar vários em sucessão, e clique no campo de destino de cada nó para escolher o elemento ou a janela sobre o qual ele atua.

Ação	O que faz
`openWin`	Abre uma janela.
`closeWin`	Fecha uma janela.
`toggleWin`	Alterna uma janela entre aberta e fechada.
`showEl`	Mostra um elemento.
`hideEl`	Oculta um elemento.
`toggleEl`	Alterna a visibilidade de um elemento.
`setText`	Altera o texto de um elemento (suporta árabe).
`setColor`	Altera a cor de preenchimento de um elemento.
`playAnim`	Reproduz a animação do elemento.
`sound`	Reproduz um som.
`switchDesign`	Alterna para outro design ou tela.

💡

setText suporta totalmente o árabe, então você pode controlar rótulos da direita para a esquerda diretamente a partir do grafo.

Janelas e painéis

Qualquer elemento pode se comportar como uma janela. É isso que permite que openWin, closeWin, toggleWin, ifWin, onOpen e onClose o tenham como destino.

Abra o painel Blueprint
Selecione o elemento e abra a seção "Blueprint panel" no Inspetor.
Agir como janela / painel
Ative "Act as window / panel" para transformar o elemento em uma janela que pode ser aberta.
Começa aberta (opcional)
Opcionalmente, ative "Starts open" para que a janela fique visível quando a GUI carregar pela primeira vez.

Os elementos que você desenha por cima e dentro de um painel tornam-se seus membros e abrem e fecham junto com ele. Para um grupo, seus filhos atuam como seus membros automaticamente — de modo que abrir ou fechar o grupo leva junto todo o seu conteúdo.

Conectando nós entre si

Você conecta nós arrastando entre seus pinos. É assim que os nós de evento, condição e ação formam uma cadeia funcional.

Arraste do pino out de um evento até o pino in de uma ação para acioná-la.
Encadeie ações em sequência para executar várias uma após a outra.
A partir de uma condição, conecte os pinos then e else às ações que cada ramo deve executar.
Clique no campo de destino de um nó para escolher o seu elemento ou janela em um menu suspenso.

Controles da tela

A tela do grafo pode ser totalmente movida e ampliada, para que você possa organizar comportamentos grandes com conforto.

Controle	Ação
Roda de rolagem	Amplia em direção ao cursor.
Arrastar espaço vazio	Move a tela.
Paleta NODES	Adiciona nós ao grafo.

Exportar para gui.lua

Quando você exporta, todo o grafo do Blueprint é compilado em gui.lua. Cliques, condições, abertura e fechamento de janelas, e alterações de texto e cor, tudo roda no jogo — não apenas no Test. O seu grafo de nós se torna lógica MTA:SA real, pronta para distribuir.

ℹ️

Como tudo é compilado para gui.lua, o comportamento que você conecta no Blueprint roda em jogadores reais, não apenas dentro da pré-visualização do builder.