Blocos de Variáveis e Listas

Os blocos de variáveis e listas guardam e manipulam os dados do projeto. Variáveis globais são compartilhadas por todos os atores; variáveis locais pertencem a cada ator — e cada clone recebe sua própria cópia no momento da criação.

Listas são coleções indexadas a partir de 1, ideais para dados de fase, inventários e tabelas. O padrão “listas de dados + ator gerador + clones” é a forma recomendada de construir cenários grandes.

mude [variável] para [valor]comando

Define o valor da variável diretamente, substituindo o anterior.

adicione [valor] a [variável]comando

Soma ao valor atual. Com valores negativos, subtrai. É o bloco mais usado em física: “adicione vy a y”.

[variável]reporter

O reporter com o nome da variável devolve seu valor para qualquer expressão.

adicione [item] a [lista]comando

Acrescenta um item ao final da lista.

apague tudo de [lista]comando

Esvazia a lista. Chame antes de reconstruir dados de fase para evitar duplicatas ao reiniciar.

substitua o item [n] de [lista]comando

Troca o valor de uma posição específica.

item [n] de [lista]reporter

Lê o item na posição indicada (a primeira posição é 1).

mude tipo para (item i de TILE_GRID)
tamanho de [lista]reporter

Quantidade de itens — o limite natural de um “Repita” que percorre a lista.

[lista] contém [item]?booleano

Verdadeiro se algum item da lista for igual ao valor. Útil para inventários: “itens contém chave?”.

Rode função [ator-função]comando

Executa o corpo de um ator do tipo função no contexto do ator chamador, passando atributos como parâmetros. Permite reutilizar lógica entre atores sem duplicar blocos.