PixelGotchi

Português · English

Um bichinho virtual de 64 pixels que cabe num chaveiro. Roda na Waveshare ESP32-S3-Matrix (25 × 25 mm, matriz RGB 8×8, botão BOOT e acelerômetro) e funciona sozinho, sem Wi-Fi nem celular. Você alimenta com um clique, brinca chacoalhando e põe para dormir virando a placa. Ele tem nome próprio, personalidade tirada do DNA e sonha com o Jogo da Vida de Conway.

▶ Experimente agora no navegador: simulador com os mesmos desenhos do firmware, editor de bichinhos e instalador USB para a placa.

Capivara	Gato

Escolha o seu caminho

Eu quero…	Vá para
Só ver e brincar, sem comprar nada	Simulador no navegador
Montar o meu do zero: o que comprar, gravar, chocar o ovo	Guia de montagem
Já tenho a placa e quero gravar o jogo	Instalador pelo navegador (Chrome/Edge + cabo USB-C) · arquivos da release
Imprimir a case (chaveiro, difusor, versão com bateria)	Case 3D · arquivos e detalhes
Criar o meu próprio bichinho e mandar para a placa	Editor de bichinhos · como funciona
Rodar no meu computador, mexer no código, rodar os testes	Desenvolvimento
Pedir ajuda a uma IA para instalar, desenhar ou montar	Prompts prontos
Contribuir com o projeto	CONTRIBUTING
Entender as regras, o menu e os sonhos	Como jogar

O que ele faz

• Seis espécies: capivara, gato, sapo, pintinho, coelho e axolote, cada uma com descanso, caminhada, comer, dormir, feliz, triste, fome e cansaço. E mais o seu, desenhado no editor.
• Nasce de um ovo que choca com 5 minutos de movimento, e se apresenta com um nome próprio (KALU, MOBITE…) tirado do DNA dele.
• Vive de verdade: fome, alegria e energia caem com o tempo, ele fica sujo e doente se for esquecido e pode virar selvagem. Bem cuidado, vive para sempre. Tudo fica salvo mesmo desligando.
• Tem vontades próprias: fareja, observa o que passa, segue borboletas, cochila. Cuidados e cliques sempre têm prioridade.
• Sonha: dormindo, uma bolha sai da cabeça e vira um mundo de Conway que muda de capítulo a cada 20–40 s. Acordado e sozinho, gliders e blinkers aparecem ao redor dele.
• Cuida dos olhos e da placa: brilho limitado a 5/255, corrente a 400 mA e cores ajustadas para ficarem distintas nos LEDs.

Do que você precisa

Para	Precisa de
Simulador e editor	Qualquer navegador moderno
Placa funcionando	Waveshare ESP32-S3-Matrix (AliExpress, Mercado Livre), cabo USB-C de dados e um computador com Chrome ou Edge
Case	Impressora 3D (PLA, sem suporte) ou um serviço de impressão
Versão com bateria	LiPo 160 mAh, TP4056, chave e diodo, mais solda: lista completa

Não precisa soldar nada nem ligar botões extras na versão básica. Confira o modelo exato antes de comprar: há outras placas "ESP32 + matriz 8×8" com pinagem diferente (fotos e detalhes).

Como jogar, em 30 segundos

Ação	O que acontece
Clique no BOOT	Dá comida (ou acorda, se estiver dormindo)
Segure 0,6 s e solte	Abre o menu já no cuidado mais urgente; no menu, clique troca e segurar confirma
Chacoalhe	Brinca
Incline	Ele vai para o lado mais baixo; no menu, troca o ícone
Vire a tela para baixo por 1,5 s	Dorme; desvirar acorda
Segure 8 s	Recomeça do zero (barra vermelha a partir de 3 s)

Quando ele precisa de algo, o ícone do cuidado aparece de tempos em tempos e um pontinho pisca na cor dele. Tabela completa, menu e status: Como jogar.

Site no ar ou no seu computador?

Os dois usam os mesmos arquivos da pasta preview/:

• Site no ar: não instala nada. Simulador, galeria de animações e instalador USB com o firmware mais recente, publicados automaticamente a cada atualização.
• No seu computador: baixe o projeto (git clone ou Code → Download ZIP), instale o Python 3 e dê dois cliques em iniciar.bat (Windows) ou rode ./iniciar.sh (macOS/Linux). Abre a mesma página em localhost, que se atualiza sozinha quando você edita os desenhos. É o caminho para quem quer modificar o bichinho.

O navegador só libera o USB (Web Serial) em HTTPS ou localhost, então o instalador funciona nos dois. Detalhes, publicação do seu próprio fork com site e todos os testes: Desenvolvimento.

Criar o seu bichinho

Abra o editor de bichinhos no navegador, sem instalar nada:

1. Comece de um dos seis bichinhos (ou do zero) e desenhe cada pose na grade 8×8 real: descanso, piscar, andar, comer, dormir, feliz, triste, com fome e cansado. Escolha as cores, a comida favorita e o tempo de cada animação.
2. A conferência avisa o que a placa não aceitaria (cores demais, animação vazia, nome com acento) e o que vai ficar estranho (largo demais para andar).
3. Testar no simulador mostra o bichinho no jogo, com os mesmos controles.
4. Enviar para a placa (Chrome/Edge + cabo USB): ele vira a 7ª espécie da seleção, ou você pode trocar o bichinho atual por um ovo dele. Não precisa compilar; a placa só precisa do firmware atual, gravado pelo instalador.

O projeto fica salvo no navegador e pode ser baixado como arquivo. Para incluir o bichinho no código do repositório, Exportar .art gera o texto no formato de art/*.art (como compilar). Também dá para pedir um desenho a uma IA com o prompt de bichinho novo.

Documentação

Documento	Conteúdo
Guia de montagem	Compra, gravação, primeiro uso, case, bateria e problemas comuns
Instalar	Instalador web e instalação manual com PlatformIO, atualização
Como jogar	Espécies, controles, menu, status, sonhos, vida e persistência
Hardware	Placa, pinos, brilho e cor dos LEDs, calibração do sensor
Case 3D	STLs, impressão, montagem, versão com bateria
Desenvolvimento	Rodar local, editar arte, testes, publicar o fork, release
Editor	Criar um bichinho, testar e enviar pela USB; formato e protocolo
Prompts para IA	Instalar, desenhar um bichinho, montar, mexer no código
Arte para 64 LEDs	Formato .art e critérios de desenho
Contribuir	Como ajudar, o que pode mudar e a lista de conferência
Testes	O que os testes automáticos garantem e o roteiro na placa
Roteiro do projeto	O que está no ar, pendências conhecidas e próximas ideias

Estado do projeto

v0.1.0 — primeira release. Verificado em software a cada push: testes do firmware com hardware simulado, testes do simulador, do pacote do editor e do instalador, e build do ESP32-S3 (CI). Ainda falta ensaiar na placa física a gravação pelo navegador, o envio de bichinhos pela USB, os gestos, a aparência dos LEDs e a case; os roteiros estão em Testes; pendências e ideias no roteiro do projeto. Relatos de quem montar são muito bem-vindos em issues.

Os desenhos são originais, feitos diretamente na grade de pixels. Referências de forma: perfil de capivara (WWF) e silhueta de gato sentado.

Licença

MIT — LICENSE.