🎮 O que é o KidForge?

KidForge é uma IDE visual onde você cria jogos 2D de plataforma sem escrever código. Arraste personagens, blocos e itens para o cenário, defina regras de comportamento e exporte seu jogo como um arquivo HTML que funciona em qualquer navegador.

🖥 Interface Principal

┌────────────────────────────────────────────────────────────┐
│  Logo  💾 📂 🚀 🧹 ✨ ▶ ⚙️  👑            🇧🇷 PT / 🇺🇸 EN │  ← Barra Superior
├──────────────┬─────────────────────────┬───────────────────┤
│              │  ✏️  🏷️  🧽  │ Tamanho │ 🎵  🎨 │          │
│  BIBLIOTECA  │                         │    REGRAS         │
│  de sprites  │     PALCO (canvas)      │    e Lógica       │
│              │                         │                   │
│  Herói       │  ← área de edição →     │  + Nova regra     │
│  Blocos      │                         │                   │
│  Itens       │       [minimap]         │  💡 Dicas         │
│  Perigos     │                         │                   │
│  Menus       │                         │                   │
├──────────────┴─────────────────────────┴───────────────────┤
│  [Cena 1 ⭐] [Cena 2] [Cena 3]  +  + Nova cena             │  ← Abas de Cenas
└────────────────────────────────────────────────────────────┘

1 Conheça as Cenas

Seu jogo é composto por cenas. Existem dois tipos:

TipoÍconePara quê serve
Jogo🎮Fase de plataforma com física (gravidade, pulo, colisão)
Menu📋Tela estática com botões clicáveis (tela inicial, vitória)

Para adicionar uma cena, clique em + Nova cena nas abas inferiores. Dê um nome e escolha o tipo.

Para definir qual cena abre primeiro, clique nos três pontinhos (⋯) da aba e escolha "Definir como inicial". A cena inicial fica marcada com ⭐.

2 Construa a Fase

Adicionando objetos

  1. Veja a biblioteca de sprites no painel esquerdo.
  2. Clique e arraste qualquer sprite para o palco.
  3. O sprite encaixa automaticamente na grade.

Tipos de sprite

SpriteTipoComportamento no jogo
Heroína / CavaleiroHeróiControlado pelo jogador
Grama / TijoloBlocoPlataforma sólida
Moeda / JoiaItemColetável (+1 ponto)
Meta (bandeira)MetaVencer ao tocar
EspinhoPerigoPerde ao tocar
MonstrinhoInimigoPatrulha e causa dano
💡 Toda fase precisa de pelo menos um herói para funcionar.

Tamanho do mundo

Use as pílulas na barra do palco para escolher o tamanho da fase:

  • Pequeno — 24 × 14 tiles
  • Médio — 60 × 15 tiles
  • Grande — 120 × 15 tiles

Para navegar em mundos grandes, use as setas ‹ › nas laterais do palco ou arraste o destaque no minimapa (canto inferior direito).

3 Monte o Menu

  1. Crie uma cena do tipo Menu.
  2. Arraste um botão (verde, rosa ou azul) para o palco.
  3. Selecione a ferramenta 🏷️ Texto e clique no botão para digitar um rótulo (ex.: "JOGAR").
  4. Adicione uma regra: ao clicar → ir pra cena… e escolha a fase de destino.

4 Defina as Regras

As regras controlam o que acontece no jogo. Cada regra tem três partes:

QUANDO algo acontece ENTÃO faça isso (em qual cena?)

Gatilhos disponíveis (QUANDO)

GatilhoDescrição
▶ ao começarUma vez, quando a cena carrega
⬅ Seta esquerdaEnquanto a tecla ← / A estiver pressionada
➡ Seta direitaEnquanto a tecla → / D estiver pressionada
⬆ Seta cima / EspaçoEnquanto ↑ / W / Espaço estiver pressionado
💥 Herói tocarQuando o herói colide com este sprite
👆 ao clicarQuando o botão é clicado (menus)

Ações disponíveis (ENTÃO)

AçãoDescrição
⬅ andar p/ esquerdaMove o herói para a esquerda
➡ andar p/ direitaMove o herói para a direita
⬆ pularHerói pula (só funciona no chão)
🪙 ser coletado +1 pontoItem desaparece e pontua
💥 herói perdeMostra tela de Game Over
🏆 vencerMostra tela de Vitória
🚪 ir pra cena…Vai para outra cena
💡 Quando você coloca um herói, as regras de movimentação são criadas automaticamente. O mesmo vale para itens (coletar), perigos (perder) e a meta (vencer).

Para adicionar uma regra manualmente, clique em + Nova regra no painel direito.

5 Ferramentas do Palco

FerramentaÍconeComo usar
Colocar✏️Arraste sprites da biblioteca para o palco
Texto🏷️Clique em um objeto para adicionar/editar rótulo
Apagar🧽Clique em um objeto para removê-lo

Música de fundo: Clique em 🎵 e escolha uma trilha para a cena atual.

Cor de fundo: Clique em 🎨 para abrir o seletor de cor do cenário.

6 Teste o Jogo

Clique em ▶ Jogar na barra superior. O jogo inicia a partir da cena marcada com ⭐.

AçãoTecla
Mover esquerda← ou A
Mover direita→ ou D
Pular↑, W ou Espaço

Clique em ■ Parar para voltar ao editor.

7 Configurações

Clique em ⚙️ na barra superior para personalizar as telas de fim de jogo:

CampoPadrãoDescrição
Título na Vitória🏆 VOCÊ VENCEU!Texto exibido ao vencer
Título no Game Over💥 GAME OVERTexto exibido ao perder
Texto do BotãoJogar NovamenteTexto do botão de reinício

8 Salvar e Carregar

💾 Salvar — Baixa um arquivo .kidforge com todo o seu projeto.

📂 Carregar — Abre um arquivo .kidforge salvo anteriormente.

⚠️ Guarde o arquivo .kidforge para continuar editando depois. O arquivo HTML exportado não pode ser reimportado.

9 Exportar o Jogo

Clique em 🚀 Exportar Jogo. Um arquivo HTML será baixado. Esse arquivo:

  • Funciona sem internet em qualquer navegador moderno.
  • Contém todos os sprites, músicas e lógica do jogo.
  • Pode ser enviado para amigos ou publicado online.
👑 Na versão Free, o jogo exportado tem uma marca d'água discreta. A versão Pro remove a marca d'água e libera recursos extras.

👑 Recursos Pro

RecursoFreePro
CenasAté 3Ilimitadas
Sprites customizados (upload de imagem)
Marca d'água no jogo exportado

Para ativar o Pro, clique em 👑 e insira sua chave no formato KFPRO-XXXX-XXXX.

Subindo sprites customizados

  1. Clique em + Imagem no painel direito.
  2. Escolha um arquivo PNG, JPEG ou GIF (máx. 512×512 px).
  3. Dê um nome e selecione o tipo (Herói, Bloco, Item, Perigo, Botão ou Cenário).
  4. Clique em Adicionar. O sprite aparece na biblioteca.
  5. Depois de colocar no palco, use os botões +/- para ajustar o tamanho em tiles.

💡 Dicas Rápidas

✨ Precisa de inspiração? Clique em ✨ para carregar um exemplo pronto com 3 fases.
🎮 Cena sumiu? Verifique se a cena inicial (⭐) está definida corretamente.
▶ Jogo não abre? Toda cena de jogo precisa ter pelo menos um herói.
⚠️ Regra quebrada? Se uma cena de destino foi excluída, aparece um aviso amarelo — atualize a regra.
💾 Quer desfazer? Não há undo disponível — salve com frequência usando 💾.