Guia

Como é o código-fonte de um jogo de combinar números, e o que editar

As regras de pares, os reforços, o arquivo de configuração que você edita sem build e as partes que pedem o código TypeScript.

Arte do Tenguin: um pinguim de cachecol vermelho acenando sobre um bloco de gelo, ao lado das peças 3 e 7.

O código-fonte de um jogo de combinar números vale a compra quando você quer um quebra-cabeça de "faça dez" pronto, com mapa de fases, reforços e conteúdo diário, e prefere ajustar preços e marca a escrever o motor de pares. O Tenguin é esse pacote: o jogador junta números iguais ou dois que somam dez, ao longo de dez temas de ilhas ilustradas, por US$ 39 no preço de lista.

Este guia é para quem vai abrir a pasta. Ele explica as regras que o código já garante, o que fica no arquivo de configuração, o que pede o código-fonte e quais ajustes podem causar problema num site no ar. Se você só quer o resumo: a maior parte dos ajustes comerciais é um arquivo de texto e um recarregar de página.

As regras que o código-fonte do jogo de combinar números já resolve

O jogador toca numa peça e depois em outra. O par some se os números forem iguais ou somarem dez. As duas peças podem estar uma acima da outra, lado a lado, na diagonal, com espaços já limpos entre elas, ou no fim de uma linha e no começo da seguinte.

Limpar uma linha inteira dispara uma Avalanche, e uma sequência de acertos aumenta o multiplicador de pontos. Quando não sobra par, a Nevasca copia os números que ainda estão no tabuleiro para o fim. Cada fase dá até três estrelas.

A passagem de uma linha para a outra e os espaços vazios são as checagens que um motor de pares precisa acertar: um par que parece válido para o jogador também precisa ser válido para o código. Aqui essas checagens já fazem parte do jogo entregue.

Testar as regras na demo do Tenguin

Reforços, conteúdo diário e modo Relax

Cinco reforços aparecem aos poucos, o que dá às primeiras fases uma curva de aprendizado:

  • Dica.
  • Desfazer, a partir da fase 3.
  • Nevasca, que completa o tabuleiro com cópias dos números restantes.
  • Bicada, que tira uma peça, a partir da fase 8.
  • Curinga, um floco que combina com qualquer número, a partir da fase 12.

Um desafio diário montado a partir da data de hoje, missões diárias e baús de capítulo dão ao jogador um motivo para voltar. O modo Relax não tem estrelas nem pressa e libera Nevasca sem limite, para quem só quer limpar peças.

As roupas do pinguim vêm em quatro categorias: cachecóis, chapéus, cores e efeitos. São compradas com moedas ganhas no jogo, e algumas fases liberam uma. Não há dinheiro real envolvido.

O que vem no download

  • Uma pasta game/ pronta para hospedar, com artes, fontes, arquivos de áudio e dependências do runtime, tudo local.
  • Código-fonte legível, com configuração e avisos de licença de terceiros.
  • 49 testes automáticos.
  • Um guia ilustrado offline para o comprador em 14 idiomas, com capturas em inglês.

A interface vem em 14 idiomas: inglês, português, espanhol, francês, alemão, italiano, holandês, polonês, turco, russo, indonésio, japonês, coreano e chinês simplificado. A base é TypeScript, JavaScript e HTML5, com Vite para o build do código-fonte. Os arquivos incluem HTML, CSS, JavaScript, JSON, TypeScript, WebP, PNG e MP3.

Um detalhe ao olhar a página do item: os painéis ilustrados são arte promocional, e a galeria de capturas mostra o jogo de verdade. Avalie o visual pelas capturas e pela demo.

O arquivo de configuração: mudanças sem build

A maior parte dos ajustes fica no tenguin.config.js, um arquivo de texto ao lado do index.html. Mude um valor, suba o arquivo e recarregue. Sem Node.js e sem build. Ele guarda:

  • O título da página e o caminho da logo.
  • A cor de destaque.
  • O idioma padrão.
  • As moedas iniciais.
  • As recompensas de vitória, de estrela e do modo Relax.
  • Os preços dos reforços e das roupas.

Isso cobre duas necessidades comuns: a sua marca na tela e uma economia ajustada ao seu público. Se os jogadores acham os reforços caros, você muda um número, não o código.

Um ajuste pede cuidado: a chave de salvamento. Escolha antes do lançamento e não mexa depois. Mudar num site no ar faz todos os jogadores perderem o progresso.

O que pede o código TypeScript

Layout das fases, diálogos, as artes dentro do jogo e novos clipes de voz mudam na edição com código-fonte, que depois é recompilada com Node.js 22.13 ou mais novo. O Node não é necessário para hospedar o jogo, só para recompilar.

O mapa de fases tem dez temas de ilhas ilustradas. Depois do décimo, o progresso continua com fases geradas e os temas existentes reaproveitados. Criar um décimo primeiro tema exige artes novas e novas posições no mapa dentro do código, então planeje como trabalho de arte com um pouco de código, e não como um ajuste.

Rode os 49 testes depois de cada mudança no código. É o jeito mais rápido de ver se uma edição quebrou uma regra em outro lugar.

  1. Faça uma cópia do pacote.
  2. Faça a mudança no código-fonte.
  3. Rode os testes.
  4. Gere o build e troque a pasta game/ hospedada pela saída completa.
  5. Jogue algumas fases no celular e num navegador de computador.

Hospedagem, incorporação e acessibilidade

Suba o conteúdo de game/ para uma hospedagem HTTP(S) de arquivos estáticos, numa subpasta se preferir. Não precisa de PHP nem banco de dados. Abrir os arquivos direto do disco com file:// não funciona, então teste a partir de um servidor web.

O jogo roda nas versões atuais do Chrome, Edge, Firefox e Safari, no computador, tablet ou celular. O jogador carrega pelo seu endereço; não é um app offline instalável. Os ajustes têm peças grandes, alto contraste, modo calmo e vibração nos celulares compatíveis, o que ajuda se o seu público inclui pessoas mais velhas ou crianças.

O pacote não traz projeto de app nativo nem provedor de anúncios conectado. Se você precisa de um deles, ou quer o jogo instalado no seu servidor, fazemos orçamento por projeto.

Pedir orçamento de trabalho sob medida

Limites e licença num parágrafo

O Tenguin não tem salvamento na nuvem, contas online, ranking remoto, compras com dinheiro real nem provedor de anúncios conectado, e apps nativos, hospedagem e desenvolvimento sob medida não estão incluídos. O progresso fica no armazenamento local do navegador. Uma compra dá uma licença perpétua e não exclusiva para um produto final, seu ou de um cliente, que os jogadores podem usar de graça ou com monetização por anúncios. Você pode mudar o código, as artes e o áudio dentro desse produto e trocar a nossa marca pela sua, mas não pode revender nem compartilhar o template, o código ou os recursos isoladamente. O suporte dura 6 meses, ou 12 com a extensão no checkout. O preço de lista é US$ 39; até 30 de novembro de 2026, uma promoção de Black Friday tira 15% de todos os templates, então o Tenguin sai por US$ 33,15, e a partir de 1º de dezembro os preços voltam ao de lista.

Ler os termos de licença e suporte

Perguntas frequentes sobre o Tenguin

Quais são as regras de um jogo de combinar números?

No Tenguin, duas peças somem quando têm o mesmo número ou somam dez, e só há espaços já limpos entre elas. Os pares podem ser na vertical, na horizontal, na diagonal ou ir do fim de uma linha ao começo da próxima.

Preciso compilar o jogo?

Não. Suba o conteúdo de game/ para uma hospedagem HTTP(S). O build só é necessário se você mudar o código-fonte.

O que dá para mudar sem recompilar?

Título, caminho da logo, cor de destaque, idioma padrão, moedas iniciais, recompensas, preços dos reforços e das roupas, tudo no tenguin.config.js.

Quantas fases o jogo tem?

As fases seguem um mapa com dez temas de ilhas. Depois do décimo tema, o jogo continua com fases geradas e temas reaproveitados.

Posso fazer um concurso com prêmios?

Não recomendamos. O conteúdo diário usa o relógio do aparelho e os recordes são locais, então não servem de base justa para prêmios.

Funciona em tablet?

Sim. Roda nos navegadores atuais de computador, tablet e celular, com a opção de peças grandes nos ajustes.

Para quem serve, e dois quebra-cabeças para comparar

Um jogo de combinar números combina com portais casuais, sites com pegada educativa e marcas que querem um quebra-cabeça calmo com um motivo diário para voltar. A regra do dez é fácil de explicar, e os reforços chegam devagar o bastante para ensinar no caminho.

Para comparar, o Gridspark é um puzzle de blocos 8×8 com o movimento ZAP e um desafio diário, por US$ 29 no preço de lista. O Bodoku é um quebra-cabeça de lógica com fantasmas, 180 fases em seis alas de um castelo, por US$ 59 no preço de lista. Os dois têm 14 idiomas na interface.

Ver o Gridspark, puzzle de blocos

Ver o Bodoku, quebra-cabeça de lógica

Dois templates no mesmo pedido têm 5% de desconto em cada licença, três têm 10%, quatro 15% e cinco ou mais 20%.

Comprar o código-fonte do Tenguin