Módulo 1 · Aula 1.8 · Funções: Criar um Bloco

Carga horária	Dificuldade	Ferramenta	Competências
8 h/a	⭐⭐⭐	Scratch	C1, C2

Objetivos de aprendizagem

Criar um bloco próprio (função) em Meus Blocos.
Adicionar um parâmetro (entrada) ao bloco e usá-lo dentro da definição.
Usar um bloco próprio dentro de outro bloco próprio.
Explicar por que funções evitam repetição de código.

Pré-requisitos

Aula 1.5 (pulo com "repita").

Materiais

Computador; projeto 1-8-blocos-do-gato.sb3 (professor).

Conceitos

Função (bloco personalizado): um conjunto de blocos com um nome. Em vez de montar o pulo de novo em cada lugar, você cria o bloco "pular" uma vez e usa quantas vezes quiser.
"defina [nome]": o chapéu rosa onde fica o que o bloco faz.
Parâmetro (entrada): um valor que muda a cada uso. "pular (60)" e "pular (120)" usam a mesma definição com alturas diferentes. Dentro da definição, o parâmetro aparece como uma bolinha rosa (altura) que você arrasta para onde precisar.
Em GDScript (Módulo 8) a mesma ideia é escrita func pular(altura):.

Exemplos

"causar dano (quantidade)", "tocar efeito (nome)", "mostrar mensagem (texto) por (segundos)".

Tutorial passo a passo

Parte A. Criar o bloco "pular" (60 min)

Projeto novo blocos-do-gato-v1.sb3. Gato com tamanho 60.
Clique na categoria Meus Blocos (bolinha rosa, a última) e em Criar um Bloco.

Captura real da janela Criar um Bloco do Scratch

Figura: captura real da janela Criar um Bloco (scratch.mit.edu, 29/10/2026).

No campo rosa nome do bloco, digite pular.
Clique em Adicionar uma entrada numérica ou texto. Aparece um campo novo dentro do bloco; digite altura.
Deixe Executar sem atualização de tela desmarcado (marcado, o pulo aconteceria instantaneamente, sem animação). Clique em OK.
Na área de código aparece o chapéu "defina pular (altura)". Encaixe embaixo dele o pulo (código abaixo). Para usar a altura, arraste a bolinha rosa altura do próprio chapéu para dentro do bloco "( ) / ( )".

Parte B. Usar o bloco (30 min)

Em Meus Blocos aparece o bloco novo "pular ( )". Monte os roteiros das teclas espaço (pular 60) e seta para cima (pular 120).

Parte C. Bloco que usa bloco (60 min)

Crie outro bloco, comemorar, com a entrada vezes.
Dentro do "defina comemorar (vezes)", use "repita (vezes) vezes" com "pular (30)" dentro, e depois "diga (Uhul!) por (1) segundos".
Tecla c: "comemorar (3)".

Captura real dos blocos pular e comemorar no editor do Scratch

Figura: captura real do projeto de referência, com "defina pular (altura)" e os blocos novos na categoria Meus Blocos (scratch.mit.edu, 29/10/2026).

O código completo

Ator Gato:

defina pular (altura)
repita (10) vezes
    adicione ((altura) / (10)) a y
fim
repita (10) vezes
    adicione ((0) - ((altura) / (10))) a y
fim

defina comemorar (vezes)
repita (vezes) vezes
    pular (30)
fim
diga (Uhul!) por (1) segundos

quando ⚑ for clicado
vá para x: (0) y: (-100)

quando a tecla [espaço] for pressionada
pular (60)

quando a tecla [seta para cima] for pressionada
pular (120)

quando a tecla [c] for pressionada
comemorar (3)

Projeto pronto: ../projetos/1-8-blocos-do-gato/1-8-blocos-do-gato.sb3.

Explicação do código

A altura é dividida em 10 passinhos: pular (60) sobe 6 por quadro, pular (120) sobe 12.
"(0) - (altura / 10)" é o mesmo passinho, negativo, para descer.
"comemorar" não sabe como pular: ele só chama "pular". Se você melhorar o "pular", o "comemorar" melhora junto. Essa é a grande vantagem das funções.

Resultado esperado (testado)

Espaço: o gato sobe exatamente 60 e volta para y = -100. Seta para cima: sobe 120 e volta. c: três pulinhos e "Uhul!", terminando no chão.

Problemas comuns

Sintoma	Causa	Solução
Não acho a bolinha `altura`	ela não fica na paleta	arraste do chapéu "defina pular (altura)"
A bolinha `altura` não funciona fora da definição	parâmetro só existe dentro do "defina"	usar só dentro
O pulo é instantâneo	marcou "Executar sem atualização de tela"	botão direito no "defina" > Editar e desmarcar
O gato não volta ao chão	a descida usa só "altura / 10" (positivo)	usar "0 - (altura / 10)"
Quero mudar o nome do bloco		botão direito no bloco > Editar

Exercício guiado

Crie o bloco "andar (passos) para a direita" que move o gato com "repita (passos) vezes: adicione 2 a x".

Desafio individual

Crie "piscar (vezes)" (aproveite o exercício da Aula 1.5) e use quando a tecla h for apertada: "piscar (4)".

Desafio avançado (opcional)

Crie um bloco com duas entradas: "pular (altura) e girar (graus)". Dica: na janela, clique duas vezes em "Adicionar uma entrada numérica ou texto" e use Adicionar um rótulo para escrever "e girar" entre elas.

Critérios de avaliação

Os dois blocos próprios funcionam com valores diferentes.
O aluno explica o que é parâmetro com um exemplo próprio.

Checklist de conclusão

Criei "pular" com a entrada altura
Usei a bolinha altura dentro da definição
Chamei "pular" com dois valores diferentes
Criei "comemorar", que usa "pular"

Extensão

Olhe o seu Caça-Estrelas: que parte se repete? (Dica: "vá para x: (número aleatório...) y: (170)" aparece três vezes.) Crie o bloco "voltar ao topo" e substitua as três cópias.