Velvet Pool

1. Visão geral

• Regras de bola 8, faltas e bola na mão
• CPU Fácil, Médio e Difícil
• Treino com desfazer, mover bolas e remontar mesa
• Dois jogadores no mesmo aparelho
• Efeitos na branca, cinco panos e cinco tacos
• Conquistas, estatísticas e pontuação local

Vanilla JavaScript + WebGL2
English, Portuguese, Spanish

2. Instalação rápida

1. Extraia o ZIP completo. A pasta game/ já está pronta para publicar.
2. Envie o conteúdo de game/ para uma pasta do seu servidor HTTP(S). Preserve todos os caminhos relativos.
3. Abra a URL do index.html. Não abra por file://. Não precisa PHP, banco de dados ou conta de serviço.

Para testar no computador, abra um terminal dentro de game/ e execute:

python -m http.server 8765

http://localhost:8765/

3. Requisitos e áudio

Use navegador moderno com JavaScript, módulos ES e WebGL2. Habilite aceleração de hardware para os jogos 3D. O primeiro toque libera o áudio; autoplay pode ser bloqueado pelo navegador. Use HTTPS para hospedar publicamente. Em iframe, permita fullscreen e autoplay quando necessário.

4. Controles

Mova o mouse para mirar, clique para travar, arraste para baixo e solte para bater. O botão direito destrava a mira e a roda ajusta o ângulo. No toque, mire na mesa e puxe a força. O botão Spin ajusta o efeito da bola branca.

5. Guia visual da interface

6. Mapa de arquivos

Os caminhos abaixo são relativos a source/. game/ contém os arquivos prontos; documentation/ contém estes manuais e imagens; licenses/ preserva os avisos de terceiros.

7. Personalização

Edite panos e tacos em progress.js e preserve seus IDs. Ajuste as decisões da CPU em ai.js e a física em physics.js separadamente. Após mudar física ou regras, execute os testes de bola 8. Troque a marca em assets/logo/ e ajuste as dimensões correspondentes no CSS.

Faça backup antes de editar. Altere um recurso por vez e teste menu, partida, pausa, resultado e recarregamento. IDs de itens e chaves de save devem permanecer estáveis para preservar jogadores existentes.

8. Desenvolvimento opcional

Esta edição usa módulos JavaScript estáticos. Não há build nem npm obrigatório. Edite source/ e copie os arquivos alterados para game/.

Testes automatizados opcionais: com Node.js 24 LTS, abra o terminal em source/ e execute npm test (equivale a node tests/run.js). Não precisa instalar dependências. A suíte verifica física, regras de bola 8, partidas CPU e consistência das traduções. Ela não substitui testes de navegador, aparelho ou áudio.

9. Saves e recordes locais

Partidas elegíveis concluídas contra a CPU salvam pontuação local. Treino e dois jogadores locais não geram recorde no ranking. Estatísticas e cosméticos ficam neste navegador. Trocar apelido não cria conta online.

Os dados pertencem à origem do navegador (protocolo, host e porta). Trocar domínio não transfere saves. Limpar dados ou usar navegação privada pode apagar o progresso. Faça backup do armazenamento antes de migrar. A edição usa chaves próprias, separadas das versões de portal.

10. Dependências, licenças e publicação

Todos os recursos de execução necessários estão no pacote, incluindo fontes, áudio e bibliotecas utilizadas. Não há CDN obrigatória. Isso não significa instalação PWA/offline automática: um novo carregamento ainda precisa acessar seu servidor HTTP. Não foram incluídos servidor multiplayer, ranking online, SDK de anúncios, projetos nativos ou editor interno. A licença de marketplace permite usar os recursos como parte do produto conforme seus termos; não permite revendê-los isoladamente. Preserve os avisos completos em licenses/ e nos diretórios de fontes/vendor.

11. Solução de problemas e FAQ

Tela vazia / blank screen

Confirme HTTP(S), WebGL e caminhos com maiúsculas/minúsculas. Leia o console. / Check HTTP(S), WebGL, case-sensitive paths and browser console.

JS recusado / module refused

O servidor deve enviar .js e .mjs com MIME JavaScript; .wasm com application/wasm. Não use text/plain para módulos. / Serve .js and .mjs with JavaScript MIME, and .wasm as application/wasm.

Sem áudio / no audio

Toque no jogo, verifique volume e permissões do navegador. / Tap the game, check volume and browser permissions.

Save desapareceu / save lost

Confira domínio, porta, modo privado e limpeza de dados. / Check domain, port, private mode and storage clearing.

Posso adicionar multiplayer? / add multiplayer?

Requer desenvolvimento e servidor próprios; não é um recurso incluído. / Requires your own development and server; not included.

Funcionará em qualquer celular? / any phone?

Os controles se adaptam à tela. O desempenho depende do navegador e hardware; teste seus aparelhos alvo. / Controls adapt to screen size; performance depends on browser and hardware. Test your target devices.

12. Suporte e atualizações

Suporte e desenvolvimento personalizado: willian@polargames.com.br. Envie versão, URL, navegador, passos para reproduzir e captura. O suporte segue os termos do item no marketplace. Atualizações são distribuídas pelo canal da compra; confira o changelog antes de substituir arquivos e preserve saves. Esta documentação não promete prazo fixo de atendimento ou novos recursos em datas específicas.