Problemas comuns

O Windows bloqueou o instalador

A tela azul “O Windows protegeu o computador” aparece porque a Brasa ainda não tem assinatura digital. Clique em Mais informações e depois em Executar assim mesmo. Baixe sempre pela página Download.

O Play não compila: “CMake não encontrado”

A Saída mostra CMake não encontrado e a barra de status mostra CMake ausente. Isso acontece quando o Visual Studio Build Tools não foi instalado, por exemplo se você clicou em Instalar sem no instalador.

Para resolver, escolha um:

• Rode o instalador da Brasa de novo e, na etapa das ferramentas de compilação, clique em Baixar e instalar o Build Tools.
• Instale o Build Tools à mão, pelo site da Microsoft, marcando a carga de trabalho Desenvolvimento para desktop com C++ e o componente Ferramentas do CMake do C++ para Windows.

Depois, feche e abra a Brasa. Se o CMake estiver num lugar diferente do padrão, informe o caminho em Projeto › Preferências… › Caminho do CMake.

O Play não compila: erro no meu código

A Saída mostra uma linha como Player.cpp(23,5): error .... Clique nela para abrir o arquivo na linha do erro. As mensagens mais comuns estão em Lendo erros do compilador.

Confira também:

• Cada objeto tem o BRASA_ENTITY(Nome); com o mesmo nome do objeto no editor.
• O .cpp do objeto começa com o #include do .hpp dele, por exemplo #include "Player.hpp".
• A classe não ficou declarada duas vezes: ela fica só no .hpp do objeto.

O jogo compilou mas não aparece nada

• A instância está na room que abre primeiro? A room inicial aparece como (inicial) em Recursos.
• O objeto tem sprite? Objetos sem sprite não desenham nada (a não ser que você desenhe no onRender).
• A instância está dentro da área da room e da câmera?
• visible não ficou false?

Parou de compilar depois de atualizar a Brasa

Normalmente o Play refaz o build do zero sozinho depois de uma atualização. Se ainda assim não compilar, apague a pasta .brasa/ do projeto e aperte Play: nada do seu projeto se perde. Veja SDK e build.

O som não toca

• O arquivo é WAV, OGG ou MP3? Outros formatos não funcionam.
• O nome no código é o nome do arquivo sem o .wav, com as mesmas maiúsculas e minúsculas: Audio::play("explosao") para explosao.wav.
• Clique no ▶ ao lado do som em Recursos: se não tocar ali, o problema é o arquivo.

O texto com acento não aparece

O drawText só desenha letras sem acento (ASCII). Escreva PONTUACAO em vez de PONTUAÇÃO.

Duas colisões contam pontos duas vezes

Se dois tiros acertam o mesmo inimigo no mesmo passo, os dois onCollide rodam. Confira isDestroyed() antes de pontuar, como no tutorial.

Como ver o valor de uma variável?

Escreva na Saída com brasa::logInfo:

#include <format>  // no topo do arquivo

brasa::logInfo(std::format("vidas = {}", state().lives));