--- name: pixel-plays-jogo description: Use para criar, melhorar ou entregar minijogos Pixel Plays para navegador, com JavaScript puro, Canvas, pixel art isométrica, controles, física e arquivos jogáveis. --- # Criar e entregar minijogos Pixel Plays **Fonte de verdade:** https://github.com/amirmushichge/pixel-plays. Leia `README.md`, `engine.js`, `shell.js` e um jogo comparável (`tie-break`, `balote` etc.) antes de implementar; não presuma APIs inexistentes. **O contrato em `../../references/contrato-de-entrega.md` e a skill `pixel-plays-teste` são obrigatórios tanto para jogos novos quanto para revisões.** ## Arquitetura - Uma mecânica física facilmente perceptível, cenário compacto, regras, sucesso/fracasso, pontuação, reinício e instruções. - Modo integrado: `/index.html` carrega `../shell.js`, chama `PixelPlays.mount({id, rules})`, declara `window.PP_SCENE` antes de `../engine.js` e implementa `groundColor`, `bake`, `update`, `draw`, loop `requestAnimationFrame`. Canvas `#c`, botão `#mute` e registro em `shell.js`/`GAMES` obrigatórios. - Modo arquivo independente: `index.html` deve rodar fora do repositório sem internet, com renderer incorporado ou dependências locais incluídas no ZIP. Nunca fornecer um HTML que dependa de `../engine.js` inexistente. - Reutilize renderizador 360×280, profundidade, projeção, sombreamento, figuras e árvores do projeto, preservando licença e atribuição. Sem sprites externos ou bibliotecas pesadas sem pedido expresso. ## Processo 1. Defina ação, estados, controles mouse/toque/teclado, feedback, som opcional e objetivo. Escolha exemplo de mecânica: `balote` (arrastar/lançar), `stari-most` (segurar/soltar), `laundry` (arrastar), `tie-break` (timing) ou `mini-ramp` (impulso). Use `tie-break` como referência visual para personagens e acabamento. 2. Faça o diorama flutuante e o personagem legíveis na resolução nativa. Separe `bake` estático de `draw` dinâmico; não replique listeners nem aloque buffers a cada quadro. Siga `pixel-plays-visual`. 3. Declare estados explícitos para impedir ações prematuras. **Em golfe:** jogador fica parado durante voo, quique e rolamento; somente após a bola parar caminha até ela e libera nova tacada ao chegar. Nunca corre junto com a bola. 4. Calibre intensidade: **0% não desloca a bola; 5–10% devem permitir tacadas curtas**, sem velocidade mínima artificial. Escala monotônica e trajetória prevista coerente com a física. Após golpe, direção e força retornam a zero; elevação permanece quando escolhida pelo usuário. 5. Nos controles de golfe, botão direito + arrastar = direção/força, scroll = altura, soltar = executar; impedir `contextmenu` no canvas e oferecer alternativa teclado/toque. Cuidar de `pointercancel`, captura e evento wheel. 6. Corrija sombras e laterais em conjunto com colisões: sombra da bola acompanha altura/posição, sombra do jogador acompanha corpo; limites desenhados coincidem com limites físicos, inclusive cantos arredondados. 7. Teste carregamento, input, física, transições, mobile, licença e visual usando a matriz da skill `pixel-plays-teste`. Corrija falhas e revalide antes de publicar o resultado. 8. **Entregue arquivos reais quando houver escrita:** HTML independente, ZIP completo, README, screenshot PNG real e resumo dos testes, com links verificados. Não entregue só código/descrição se for possível criar os artefatos. Se faltarem ferramentas, explicite quais verificações/arquivos não foram possíveis; nunca afirme ter testado sem executar. ## Licenças Código original sob MIT (créditos no ZIP); músicas de `MUSIC.md` **não** autorizadas para reutilização. Usar áudio próprio/licenciado ou nenhum. Para objetivos pedagógicos, aplicar também `pixel-plays-educacao`.