Guia do construtor de ações

1. Abra Bibliotecas e entre em uma biblioteca sua.
2. Desça até “Ações criadas por você”.
3. Em “Comece por um modelo”, escolha um ponto de partida. As ações salvas aparecem acima; clique para editar.

Bibliotecas instaladas do mercado são somente leitura: dá para ver as ações, não editá-las.

1. Escolha o modelo “Picar com batidas”.
2. Em “Nome da ação”, escreva, por exemplo, “Bater com a faca”.
3. Veja a “Pré-visualização”: a ação já toca com itens do pacote inicial. Troque o ingrediente para ver que funciona com outros.
4. No passo “Balançar / bater”, mude a amplitude de 22 para 40. A prévia muda na hora.
5. Clique em “Salvar ação”.
6. Numa receita, adicione um bloco de animação e escolha “Bater com a faca” na lista de ações.

Um papel é um espaço que quem usa a ação preenche com um item (“Faca”, “Ingrediente”, “Recipiente”). Uma ação tem de 1 a 5 papéis.

Nome do papel

O rótulo que a pessoa vê ao escolher o item.

Identificador

Nome interno criado automaticamente (tool, papel3…). Não muda.

Tipos de item aceitos

Quais tipos aparecem na lista: ingrediente, utensílio, recipiente, superfície.

Habilidades exigidas

O item precisa ter todas, por exemplo blade (lâmina) ou cuttable. É isso que decide se um item “serve”.

Estados exigidos

Estados que a ação vai usar, como sliced (fatiado) ou diced (em cubos).

Pontos e linhas exigidos

Pontos de referência usados pela ação, no formato nome:tipo, como cutLines:lines ou pile:point. Tipos: point, line, lines.

Camadas exigidas

Imagens extras que a ação mostra, como shreds (raspas) ou stream (jato).

Opcional

A cena funciona sem esse item, como a tábua. Passos de um papel vazio são pulados.

Posição inicial no palco

Onde o item começa: horizontal e vertical em %, tamanho e inclinação em graus.

Camada

Ordem de desenho: o número maior fica na frente.

Pode encolher (máscara)

Permite esconder parte do item aos poucos, como um ingrediente que diminui ao ser ralado.

Dica: Regra de ouro: um passo só pode usar o que o papel exige. Se um passo troca o estado para sliced, o papel precisa listar sliced em “Estados exigidos”. Assim nenhum item incompatível é aceito e a animação nunca quebra no meio.

Os passos acontecem em ordem, de cima para baixo. Use ↑ ↓ para reordenar e ✕ para remover. Dois grupos combinam passos:

• Ao mesmo tempo — os passos de dentro começam juntos.
• Repetir — os passos de dentro se repetem; pode conter grupos “Ao mesmo tempo”.

Repetições (padrão) é um número que quem usa a ação ajusta em cada receita. Todo campo de quantidade (vezes, voltas, batidas, rodadas) tem a opção usar repetições: marcada, o campo segue esse número.

Toda ação também ganha o controle Velocidade. As durações que você escreve valem para a velocidade 1×.

Vários passos têm “Marcar momento como”, e existe o passo “Marcar momento”. Dê um nome curto, como contact ou stroke. No Editor avançado de uma receita, partículas (migalhas, gotas, brilhos, vapor) podem disparar a cada momento marcado — por exemplo, migalhas a cada batida da faca.

Medidas: o palco tem 800 × 500 unidades. Pontos dentro de um item são em %: (0, 0) é o canto superior esquerdo, (100, 100) o inferior direito. Ângulos em graus, durações em segundos.

• Ir até

  Leva um item até um destino.

  • Quem se move.
  • Destino (veja “Destino, duração e aceleração”).
  • Ponto de contato: que parte de quem se move encosta no destino. Ex.: (50, 100) é a base do item; sem ele, vale o ponto de contato do próprio item (a ponta da faca, por exemplo).
  • Inclinação final em graus (vazio mantém a atual).

  Exemplo: Levar a faca para logo acima do ingrediente: destino Ingrediente, deslocamento y = -40.

• Percorrer uma linha

  Desliza o item ao longo de uma linha de outro item, como as linhas de corte ou a face de um ralador.

  • Papel de referência e linha (só linhas: line ou lines; pontos não servem).
  • Sentido: ida, volta ou ida e volta.
  • Vezes (fixo ou “usar repetições”).
  • Ponto de contato e “Marcar momento como” (a cada passada).
  • Com várias linhas (lines), percorre uma de cada vez.

  Exemplo: A faca passa por todas as cutLines da cenoura, marcando “contact” em cada uma.

• Girar em volta

  Faz círculos em volta de um ponto (mexer, misturar).

  • Destino: o centro do círculo (ex.: mixCenter do recipiente).
  • Raio, em unidades do palco.
  • Achatamento: 1 é um círculo; 0,35 parece um círculo visto de lado, como dentro de um bowl.
  • Voltas e direção (horário ou anti-horário).

• Balançar / bater

  Vai e volta várias vezes no lugar.

  • Eixo: horizontal, vertical ou giro.
  • Amplitude: unidades do palco (ou radianos no giro; 0,2 ≈ 11°).
  • Quantidade e “Marcar momento como” (a cada batida).

  Exemplo: Faca batendo: eixo vertical, amplitude 22, quantidade “usar repetições”.

• Mudar aparência

  Muda opacidade, tamanho, inclinação ou a parte visível.

  • Opacidade de 0 (invisível) a 1.
  • Multiplicar tamanho: 1,1 aumenta 10%; 0,5 reduz à metade.
  • Girar, em graus, somado à inclinação atual.
  • Parte visível / Encolher a cada vez: só aparecem se o papel tiver “Pode encolher” ativado. Ex.: -0,1 deixa o item 10% menor a cada vez.

• Trocar estado

  Troca a imagem do item por outro estado, como inteiro → fatiado.

  • Estado (só os listados em “Estados exigidos” do papel).

• Mostrar / esconder

  Faz o item aparecer ou sumir instantaneamente.

  • Visível: sim ou não. Para sumir aos poucos, use “Mudar aparência” → opacidade 0.

• Separar pedaços

  Esconde o item e mostra os pedaços de um estado (fatias, cubos), afastando-os.

  • Estado com pedaços (ex.: sliced ou diced).
  • Como separar: em fila, em grade (cubos) ou caindo.
  • Espaço entre pedaços, em unidades do palco.

• Camada (raspas, vapor…)

  Mostra uma camada extra de um item e a faz crescer, aparecer ou sumir.

  • Camada (só as listadas em “Camadas exigidas”).
  • Animação: crescer de baixo para cima, aparecer ou sumir.
  • Quanto por vez: 0,25 cresce um quarto a cada vez que o passo roda.
  • Onde aparece (vale na primeira vez), tamanho e proporção (altura/largura; raspas ficam bem com 0,5).

• Voltar ao início

  Leva itens de volta à posição inicial.

  • Quem volta: marque os papéis; nenhum marcado = todos.

• Esperar

  Uma pausa antes do próximo passo.

  • Duração em segundos.

• Marcar momento

  Registra um momento para disparar partículas no editor avançado.

  • Nome curto, como contact ou stroke.

• Ao mesmo tempo

  Grupo de passos que começam juntos; termina quando o mais longo termina.

  • Dois passos do grupo não podem animar a mesma coisa do mesmo item (ex.: dois movimentos da faca). Mover e encolher o mesmo item ao mesmo tempo pode.

• Repetir

  Grupo de passos que se repete várias vezes.

  • Vezes (fixo ou “usar repetições”).
  • Marcar momento a cada rodada.
  • Pode conter grupos “Ao mesmo tempo”.

Destino: escolha um papel (ou Palco) e, se quiser, um ponto ou linha desse item; sem nenhum, vale o centro do item. Também dá para indicar um ponto em % e um deslocamento em unidades do palco (ex.: y = -40 deixa o utensílio um pouco acima do alvo).

Duração e aceleração são opcionais; sem elas cada passo usa um valor padrão. Aceleração: Suave começa e termina devagar, Acelerando é boa para golpes, Freando para pousos e Com impulso passa um pouco do ponto e volta.

Uma ação só aceita itens com as habilidades, estados, pontos e camadas exigidos. No editor de itens (Bibliotecas → item):

Uma habilidade padrão

Marque em “O que ele pode fazer” (cortar, cubos, ralar, lâmina, ralador, despejar, recipiente…).

Uma habilidade sua (ex.: descascavel)

Escreva em “Outras habilidades”, separadas por vírgula.

cutLines (lines) e o estado sliced

“Pode ser cortado” → Adicionar corte → Gerar fatias.

crossLines (lines) e o estado diced

“Pode ser cortado em cubos” → cortes verticais e Adicionar corte horizontal → Gerar cubos.

A camada shreds

“Pode ser ralado” → Gerar raspas.

gratingSurface (line) e pile (point)

“É um ralador” → marque o topo e a base da face de ralar e onde as raspas caem.

spout (point) e a camada stream

“Pode ser despejado” → bico → Gerar jato automaticamente.

Uma cor escolhível em cada animação

Itens com camada de cor (panela com líquido, pedaço, forma, travessa) mostram um seletor “Cor” ao lado do item na animação.

spout (point) e a cor do conteúdo, para sólidos

“Sólido que se despeja (farinha, açúcar…)” → bico e cor do conteúdo.

opening e mixCenter (point), camada contents

“Guarda líquidos e misturas” → pontos e camadas do recipiente.

Dica: O editor de itens cria só os nomes acima. Use-os nas exigências da sua ação para que itens desenhados por usuários possam ser compatíveis. Os itens do pacote inicial já trazem todos.

O modelo “Ralar devagar” mostra os recursos mais avançados:

1. Papéis. Ralador: exige grater, gratingSurface:line e pile:point. Ingrediente: exige gratable e a camada shreds, com “Pode encolher” (some de baixo para cima) e tamanho 0,7.
2. Ir até: o ingrediente vai até gratingSurface com contato (50, 100) — sua base encosta no topo da face —, inclinado a -7°.
3. Repetir (usar repetições, marcando stroke) com um grupo Ao mesmo tempo: percorrer gratingSurface (o ingrediente desce); mudar aparência, encolher -0,12 (fica menor); camada shreds, crescer 0,25, em pile (as raspas aumentam).
4. Voltar ao início: só o ingrediente.

Experimente: mais raspas por passada (aumente “Quanto por vez”), passadas mais lentas (aumente a duração do percurso), vapor em vez de raspas (troque a camada e a exigência do papel).

O quadro “Corrija antes de salvar” aponta o passo com problema (ex.: “Passo 2.1”). A ação só pode ser salva sem erros.

O passo usa um papel que não existe

Um papel foi removido. Escolha outro em “Quem se move” ou no destino.

O estado “…” precisa estar em Estados exigidos

Adicione o estado ao papel, ou escolha outro estado no passo.

O ponto/linha “…” precisa estar em Pontos e linhas exigidos

Adicione nome:tipo ao papel (ex.: pile:point).

“…” é um ponto; para percorrer, use uma linha

“Percorrer” precisa de line ou lines.

A camada “…” precisa estar em Camadas exigidas

Adicione a camada ao papel.

Dois passos do mesmo grupo mexem na mesma coisa

Dentro de “Ao mesmo tempo”, coloque um dos passos depois do grupo.

Para encolher “…”, ative Pode encolher

Ligue a máscara no papel.

Item com ✕ na pré-visualização

O item não é compatível; a mensagem sobre o palco diz o que falta (uma habilidade, uma linha de corte…).

• Em receitas: ao enviar a receita para revisão, a definição da ação é congelada junto. Editar a ação depois não muda a versão aprovada; envie a receita de novo para atualizar.
• No mercado: as ações de uma biblioteca entram no pacote dela (um pacote pode ter só ações). Nome, descrição e nomes dos papéis passam pela mesma revisão humana e seguem as Diretrizes da Comunidade. Quem instala recebe uma cópia somente leitura, atualizada quando uma nova versão é aprovada.
• Excluir uma ação faz rascunhos que a usam deixarem de mostrar a animação; versões já aprovadas continuam funcionando com a cópia congelada.

• O destino é calculado pela posição inicial do item de referência; se ele se moveu antes, o destino não acompanha.
• O endereço de uma ação (usado pelas receitas) é fixo depois de salvo; mudar o nome não o altera.
• Ações não têm imagens próprias; camadas como raspas e vapor vêm dos itens.
• No máximo 5 papéis e 40 passos (12 dentro de cada “Repetir”, 6 dentro de cada “Ao mesmo tempo”).

• Comece por um modelo parecido com o que você quer.
• Teste a prévia com dois ou três itens diferentes antes de publicar.
• Prefira pontos e linhas dos itens (como cutLines) a posições fixas no palco: a ação se adapta a itens de tamanhos diferentes.
• Use “usar repetições” nos ciclos para que cada receita ajuste a quantidade.
• Marque momentos importantes (contact, stroke) para permitir partículas.