Witch Flight 1.0.0: guia do comprador

Jogo crash em HTML5 com créditos fictícios gratuitos. Código-fonte editável incluído.

Guia de personalização (receitas)

EnglishPortuguêsEspañol

Visão geral

Witch Flight é um jogo crash em HTML5. O jogador faz uma aposta, uma bruxa decola na vassoura e um multiplicador sobe enquanto ela voa. Saque antes que ela caia para ganhar a aposta vezes o multiplicador; se ela cair primeiro, a aposta é perdida. Ele vem como jogo pronto para hospedar (game/) e com o código-fonte completo e editável (source/). Roda em qualquer navegador atual, em celulares, tablets, computadores e telas ultrawide, na vertical e na horizontal, sem servidor, banco de dados ou conta.

Recursos: dois modos de rodada (Solo, o padrão, e Sala), saque automático, comemorações BIG / MEGA / EPIC WIN, uma janela de jogo justo (hash antes da decolagem, semente depois), lista dos melhores voos, rodadas recentes, recarga grátis, botões de som e música, opção "reduzir movimento", tutorial de 3 passos e 14 idiomas de interface. A bruxa é animada com uma malha articulada em tempo real: o cabelo e a capa se movem com física.

Somente jogo recreativo. O jogador recebe créditos de jogo fictícios e gratuitos. Eles não têm valor monetário e não podem ser comprados, transferidos, vendidos ou resgatados. Não há depósitos, saques, prêmios ou recompensas de valor econômico. O preço da compra é de uma licença de software. O uso para jogos de azar com dinheiro real ou com outro valor real não é permitido pela licença. Leia o SCOPE.md (na raiz do pacote e dentro de game/): ele faz parte dos termos da licença.

A tela do jogo (1280×720) durante um voo.
A tela do jogo (1280×720) durante um voo.

Instalar no seu site

O jogo jogável é a pasta game/. É HTML, CSS e JavaScript puros: não precisa de build, Node.js nem banco de dados para hospedar.

  1. Abra o gerenciador de arquivos da sua hospedagem ou conecte com um programa de FTP (por exemplo, o FileZilla).
  2. Crie uma pasta para o jogo, por exemplo /games/witch-flight/.
  3. Envie o conteúdo de game/ para ela: index.html, os arquivos .js e .css, SCOPE.md, DOCUMENTATION.txt e as pastas arte/, audio/, fontes/ e lib/.
  4. Abra o endereço no navegador, por exemplo https://your-site.example/games/witch-flight/.

O jogo usa caminhos relativos, então funciona em qualquer pasta ou subdomínio. Abrir o index.html direto do seu disco (file://) não funciona, porque os navegadores bloqueiam ali os sons e os arquivos de dados: teste numa hospedagem ou com npm start (veja "Editar o código-fonte").

Colocar dentro de uma página (iframe)

<iframe src="/games/witch-flight/" style="width:100%;aspect-ratio:16/9;border:0" allow="fullscreen; autoplay"></iframe>

Mantenha visível o aviso na tela "Virtual credits only." (somente créditos virtuais) e mantenha o SCOPE.md junto com o jogo quando publicá-lo para o público.

Requisitos

  • Qualquer hospedagem web estática HTTP ou HTTPS (hospedagem compartilhada, uma CDN, GitHub Pages, Netlify...). Sem PHP, banco de dados ou código de servidor.
  • Um navegador atual com WebGL: Chrome, Edge, Firefox, Safari (macOS e iOS), Samsung Internet ou Opera.
  • Só para os testes, o servidor local e o build: Node.js 26 LTS (a linha LTS atual) e npm, veja "Editar o código-fonte".
  • Não precisa de internet para jogar: arte, sons, fontes e a biblioteca PixiJS estão todos dentro de game/. O jogo não faz requisições a outros sites.

Como jogar e as telas

O jogador escolhe a aposta com – e + e toca em BET (apostar). A bruxa decola e o multiplicador sobe; o botão grande vira CASH OUT (sacar) e mostra quanto a aposta vale naquele momento. Tocar nele paga a aposta vezes o multiplicador. Se ela cair primeiro ("FLEW AWAY"), a aposta é perdida. Todos os valores são créditos de jogo fictícios.

A tela do jogo (1280×720) durante um voo. 1 2 3 4 5 6 7 8 9 10 11 12 13 14
A tela do jogo (1280×720) durante um voo.
  1. Botão de casa (endereço no WF_CONFIG, ou escondido)
  2. Saldo de créditos de brincadeira
  3. Recarga grátis (+10.000 créditos de brincadeira)
  4. Liga/desliga o som
  5. Melhores voos
  6. Menu
  7. Multiplicador (o título acima mostra a fase da rodada)
  8. Últimas rodadas
  9. Diminui a aposta
  10. Aumenta a aposta
  11. Liga/desliga o saque automático
  12. Alvo do saque automático
  13. BET / CASH OUT / CANCEL (mostra a aposta, ou quanto ela vale agora)
  14. Aviso "Virtual credits only." (mantenha visível)

Saque automático

Marque a caixa ao lado de AUTO CASH OUT e escolha um alvo (x1.20 a x100) na lista: o jogo saca sozinho quando o multiplicador chega nele.

Um saque: o prêmio aparece ao lado da bruxa e as moedas voam até o saldo.
Um saque: o prêmio aparece ao lado da bruxa e as moedas voam até o saldo.

Comemorações

Um saque de 10 vezes a aposta ou mais abre BIG WIN, de 25 vezes abre MEGA WIN e de 50 vezes EPIC WIN: a placa conta o prêmio subindo enquanto moedas voam até o saldo. Um toque pula a contagem.

BIG WIN: um saque de 10 vezes a aposta ou mais (valores em créditos fictícios de brincadeira).
BIG WIN: um saque de 10 vezes a aposta ou mais (valores em créditos fictícios de brincadeira).
EPIC WIN: 50 vezes a aposta ou mais.
EPIC WIN: 50 vezes a aposta ou mais.
FLEW AWAY: ela caiu antes do saque e a aposta foi perdida.
FLEW AWAY: ela caiu antes do saque e a aposta foi perdida.

Menu, melhores voos e jogo justo

O botão de menu abre efeitos sonoros, música, "reduzir movimento", o idioma, o tutorial (HOW TO PLAY) e FAIR PLAY (jogo justo). A coroa abre os melhores voos deste navegador. O + verde ao lado do saldo dá uma recarga grátis de 10.000 créditos de jogo.

O menu: efeitos, música, menos movimento, idioma, como jogar e jogo justo. 1 2 3 4 5 6
O menu: efeitos, música, menos movimento, idioma, como jogar e jogo justo.
  1. Efeitos sonoros
  2. Música
  3. Menos movimento
  4. Idioma (14)
  5. Como jogar (tutorial)
  6. Jogo justo (hash e semente)
Os melhores voos deste navegador.
Os melhores voos deste navegador.
Celular em pé (390×844): o mesmo jogo, reorganizado.
Celular em pé (390×844): o mesmo jogo, reorganizado.

Modos de rodada

O jogo tem duas formas de conduzir as rodadas. Escolha a que combina com o seu site.

Solo (padrão) Sala
Quando a rodada começa quando o jogador aperta BET (0,8 s depois; a aposta ainda pode ser cancelada) sozinha, depois de uma contagem regressiva de 5 segundos
Sem aposta feita a bruxa fica parada no ar, o título diz PLACE YOUR BET, nada voa os voos continuam; quem perdeu a contagem assiste e entra no próximo
Etiquetas de saque de outros jogadores ocultas visíveis (jogadores simulados)
Rodadas recentes na primeira visita vazia 5 voos aleatórios, para a fila não ficar vazia
Tutorial, passo 1 "Faça sua aposta: a bruxa decola na hora." "Faça sua aposta durante a contagem."
Modo Solo: a bruxa flutua e espera uma aposta.
Modo Solo: a bruxa flutua e espera uma aposta.
Modo Sala: a contagem para o próximo voo.
Modo Sala: a contagem para o próximo voo.

Por que Solo é o padrão: num jogo de um jogador só não existe rodada compartilhada para esperar. Fazer o jogador assistir a um voo em que ele não apostou só o atrasa, e rodadas sem aposta criam resultados que ninguém jogou. Sala mantém o ritmo clássico dos jogos crash multijogador, com contagem regressiva entre os voos.

Como trocar

Abra o index.html (em game/ na sua hospedagem, ou em source/) e encontre este bloco perto do fim:

<script>
  window.WF_CONFIG = { modo: 'solo' };
</script>

Troque 'solo' por 'sala' (o valor no código para o modo Sala) e recarregue a página. Para testar sem editar, acrescente ?modo=sala ou ?modo=solo ao endereço: o endereço vale mais que o bloco.

O que vem no pacote

witch-flight-static-1.0.0/
  START-HERE.txt          first steps
  DOCUMENTATION.html      opens this guide
  CUSTOMIZATION.html      opens the customization guide (recipes, no coding)
  CHANGELOG.txt
  SCOPE.md                what the product is and what the licence does not allow
  documentation/          this guide and the customization guide (EN/PT/ES), screenshots
  game/                   UPLOAD THE CONTENTS OF THIS FOLDER
    index.html            the page and the settings block WF_CONFIG
    estilo.css            the styles
    jogo.js               the game (rounds, buttons, scene, effects)
    motor.js              the math
    idiomas.js            the 14 languages
    som.js, justo.js, bruxa.js, rig.js, ui.js
    lib/pixi.js           PixiJS 7.4.2 (MIT), not minified
    arte/, audio/, fontes/  images, sounds, fonts
    SCOPE.md, DOCUMENTATION.txt
  source/                 the complete editable project
    the same game files as game/
    tests/                npm test
    tools/                build.mjs (npm run build), serve.mjs (npm start)
    package.json, package-lock.json, .prettierrc, README.md
    licenses/             licences of PixiJS and Prettier
  THIRD-PARTY-LICENSES/   PixiJS, Prettier and the two fonts

game/ é exatamente o que o npm run build gera a partir de source/ (conferido arquivo por arquivo antes de empacotar).

Arquivo O que é
index.html a página: barra superior, cena, painel, janelas e o bloco de configurações
estilo.css layout para celular, computador e ultrawide, botões, janelas, comemorações
jogo.js o jogo: rodadas, botões, cena, efeitos, comemorações
motor.js a matemática: ponto de queda, curva do multiplicador, pagamento
idiomas.js textos em 14 idiomas
som.js dados salvos e som (efeitos, música, sinos da contagem)
justo.js SHA-256 para a janela de jogo justo
bruxa.js o esqueleto da bruxa: ossos, correntes do cabelo e da capa, ordem das camadas
rig.js o motor de animação: deforma as camadas da bruxa, física do cabelo e da capa
ui.js painéis e botões esticados desenhados sem emendas

Configurações

O bloco de configurações (index.html)

window.WF_CONFIG é lido toda vez que a página abre, então você pode mudá-lo na sua hospedagem com um editor de texto, sem build.

window.WF_CONFIG = { modo: 'solo', home: '/games/', bots: false };
Opção O que faz
modo 'solo' (padrão) ou 'sala' (modo Sala). Veja "Modos de rodada"
home endereço do botão de início no canto superior esquerdo (padrão '../', a pasta acima do jogo), ou false para esconder o botão
bots true ou false mostra ou esconde as etiquetas de saque dos jogadores simulados. Quando não está definido, elas aparecem só no modo Sala

Valores do jogo (jogo.js)

São constantes perto do topo do jogo.js. Edite source/jogo.js e rode npm run build, ou edite game/jogo.js direto na sua hospedagem (o arquivo em game/ é o mesmo arquivo legível, nada é compilado).

O quê Onde Padrão
Valores de aposta (os botões – e +) const APOSTAS 10, 20, 50, 100, 200, 500, 1000, 2000, 5000
Alvos do saque automático const AUTOS x1.2, 1.5, 2, 3, 5, 10, 20, 50, 100
Saldo inicial e recarga grátis procure por 10000 10.000 créditos de jogo
Contagem da Sala, pausa do Solo, tempo em que a queda fica na tela FEEL.aposta, FEEL.apostaSolo, FEEL.depois 5 s, 0,8 s, 2,6 s
Marcos do multiplicador (sino e brilho) FEEL.marcos 2, 3, 5, 10, 20, 50, 100, 200, 500
Limites de BIG / MEGA / EPIC WIN (vezes a aposta) FEEL.tiers 10, 25, 50
Moedas voando até o saldo FEEL.moedas 42 por segundo (24 em telas de toque)
Tremor de tela FEEL.tremor no máximo 10 px

Matemática e retorno ao jogador

As regras ficam em motor.js (cerca de 20 linhas):

Valor Padrão O que faz
RTP 0.97 Retorno ao jogador. A chance de um voo chegar a x é RTP / x, então sacar em qualquer alvo devolve 97% em média
K 0.00009 Velocidade da curva: x2 em cerca de 7,7 s, x5 em 17,9 s, x10 em 25,6 s
MAX 1000 Maior multiplicador que um voo pode alcançar

Depois de mudar esses valores, rode npm test: ele simula 2 milhões de voos para seis alvos de saque e falha se o retorno se afastar do RTP.

Jogo justo

  1. Quando começa uma fase de apostas, o jogo sorteia uma semente aleatória e calcula o hash SHA-256 dela. O ponto de queda vem da semente, então ele fica definido antes de qualquer aposta.
  2. O hash aparece em Menu > FAIR PLAY antes da decolagem.
  3. Depois do voo, a semente daquele voo aparece na mesma janela, para qualquer pessoa conferir que SHA-256(semente) é o hash mostrado antes.
FAIR PLAY: o hash do próximo voo antes da decolagem e a semente do anterior depois.
FAIR PLAY: o hash do próximo voo antes da decolagem e a semente do anterior depois.

No modo Solo, uma semente só é usada quando o jogador aposta; cancelar e apostar de novo mantém a mesma semente.

Endereços de teste

No seu próprio computador (localhost, 127.x, 192.168.x, 10.x), duas opções de endereço ajudam nos testes: ?crash=40 força a próxima queda em x40, e ?congela=3.47 congela a tela em x3.47 para capturas de tela. Num domínio público as duas são ignoradas, então os jogadores não conseguem usá-las.

Idiomas

A interface está traduzida 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). O jogo abre no idioma do aparelho e o jogador pode trocar no menu (LANGUAGE). As palavras pintadas (o botão BET / CASH OUT / CANCEL, o logo e as placas BIG / MEGA / EPIC WIN) são imagens e ficam em inglês em todos os idiomas. Os números usam o formato 1,250, porque a fonte dourada dos números é uma imagem com esses caracteres.

O menu em japonês, um dos 14 idiomas.
O menu em japonês, um dos 14 idiomas.

Todos os textos ficam em idiomas.js, um bloco por idioma com as mesmas chaves de en. {0} e {1} são trocados por números e <br> é uma quebra de linha. Para adicionar um idioma, copie o bloco en, dê a ele um código novo (por exemplo sv), traduza os valores e acrescente o nome dele em WF_NOMES. O npm test confere se todo idioma tem todas as chaves e mantém os marcadores.

Dados salvos

O jogo guarda o saldo, a aposta, o saque automático, as rodadas recentes, os melhores voos, o idioma, o som e o estado do tutorial no localStorage do navegador, em chaves que começam com witch-flight.template.save.v1. (a constante SALVO em som.js). Nada é enviado para lugar nenhum. Limpar os dados do site no navegador reinicia o jogo. Se você publicar duas cópias do jogo no mesmo domínio, dê a cada uma o seu próprio prefixo SALVO.

Editar o código-fonte (Node.js para iniciantes)

O jogo não precisa de build: todo arquivo em game/ é o próprio arquivo-fonte legível. O Node.js só é usado para rodar os testes, um servidor local e a cópia de source/ para uma dist/ nova. Você também pode editar os arquivos de game/ com qualquer editor de texto.

1. Instalar o Node.js

  1. Acesse https://nodejs.org e baixe a versão LTS (Node.js 26 LTS). Windows e macOS: rode o instalador com as opções padrão. Linux: use o gerenciador de pacotes ou os binários oficiais.
  2. Feche e abra o terminal de novo (Windows: PowerShell ou Prompt de Comando; macOS: Terminal).
  3. Confira as versões: os dois comandos precisam mostrar um número, e o Node precisa ser 26.13.0 ou mais novo.
node --version
npm --version

2. Instalar as ferramentas do projeto

Abra o terminal na pasta source/ (Windows: abra a pasta no Explorador de Arquivos, clique na barra de endereço, digite powershell e aperte Enter; macOS: arraste a pasta até o ícone do Terminal). Depois rode:

npm ci

Isso instala dentro de node_modules/ a versão exata do Prettier escrita no package-lock.json. Precisa de internet uma vez. O jogo em si não tem dependências do npm.

3. Testar, jogar e fazer o build

npm test
npm start
npm run build
  • npm test confere a matemática e o retorno ao jogador, o hash do jogo justo, as traduções e se existe todo arquivo que o jogo pede. Todos os testes precisam passar.
  • npm start inicia um servidor local em http://localhost:8080/. Abra no navegador; recarregue depois de salvar um arquivo. Aperte Ctrl+C para parar. Outra porta: PORT=8090 npm start (Windows PowerShell: $env:PORT=8090; npm start).
  • npm run build copia o jogo para source/dist/ (a pasta é esvaziada antes, então um arquivo apagado também sai dela). Envie o conteúdo de dist/: ele substitui game/.
  • npm run format formata todos os arquivos com o Prettier; npm run check só confere.

Problemas comuns

  • node ou npm não é reconhecido: o Node.js não está instalado ou o terminal foi aberto antes da instalação. Reinstale e abra um terminal novo.
  • O Windows diz que a execução de scripts está desabilitada (npm.ps1): use o Prompt de Comando, ou rode npm.cmd ci.
  • ENOENT ... package.json: o terminal não está na pasta source/.
  • EBADENGINE: seu Node.js é mais antigo que 26.13.0. Instale a LTS atual.
  • npm ci falha com erro de rede: confira a conexão ou o proxy da rede da sua empresa e rode de novo.
  • npm ci diz que o arquivo de lock está fora de sincronia: você mudou o package.json; rode npm install uma vez e depois o npm ci volta a funcionar.
  • EADDRINUSE com npm start: a porta 8080 está ocupada; use outra porta como mostrado acima.

Personalizar e trocar o visual

O guia de personalização (CUSTOMIZATION.html) tem receitas passo a passo para quem não programa: trocar a bruxa, o fundo, os botões, o logo, os sons e a música, as cores e os textos, e mudar apostas, comemorações e o modo de rodada. Em resumo:

  • Arte: arte/ (imagens WebP e máscaras PNG). Troque um arquivo por outro com o mesmo nome e o mesmo tamanho.
  • Sons: audio/ (MP3). Troque um arquivo por outro com o mesmo nome.
  • Layout e cores: estilo.css.
  • Textos: idiomas.js.
  • Valores e efeitos: FEEL, APOSTAS e AUTOS em jogo.js; matemática em motor.js.

Nomes internos

O código foi escrito em português. Os nomes são só nomes; isto é o que eles significam:

Nome no código O que é
jogo, motor, som, justo, bruxa, idiomas, estilo, fontes, arte jogo, motor (matemática), som, justo, bruxa, idiomas, estilo, fontes, arte
camadas, fundo, novo camadas, fundo, conjunto de arte mais novo
Luma o nome da bruxa no motor de animação (Luma.Rig)
S.saldo, S.aposta, S.m, S.quebra saldo, aposta atual, multiplicador, ponto de queda
S.fase: aposta, voo, caiu fase da rodada: apostas, voo, caiu
apostar, decola, sacar, caiu fazer a aposta, decolar, sacar, ela caiu
MODO (solo, sala) o bloco de configurações: modo Solo ou Sala
FEEL, APOSTAS, AUTOS tempos e efeitos, valores de aposta, alvos do saque automático
guarda, SALVO dados salvos no navegador, o prefixo das chaves
festa, placa, moedas, painel, botao comemoração de vitória, placa, moedas, painel, botão

Atualizar o jogo e limpar o cache

Depois que você envia uma versão nova, navegadores e hospedagens podem manter os arquivos antigos por um tempo. Se uma mudança não aparecer:

  • Recarregue sem o cache: Ctrl+F5 ou Ctrl+Shift+R (Windows/Linux), Cmd+Shift+R (macOS). No celular, feche a aba e abra de novo.
  • Limpe os arquivos em cache do site nas configurações do navegador ("Imagens e arquivos em cache"). Não limpe "cookies e dados do site", a não ser que queira zerar o jogo salvo.
  • Teste numa janela anônima.
  • Se a sua hospedagem ou CDN (por exemplo, a Cloudflare) tiver cache, limpe esse cache.
  • Acrescente uma versão ao endereço uma vez, por exemplo index.html?v=2, ou a um arquivo alterado dentro do index.html (jogo.js?v=2).

Os dados salvos sobrevivem a uma atualização desde que o prefixo SALVO não mude.

O que o produto é (e o que não é)

  • Somente créditos de jogo gratuitos e fictícios, sem valor monetário. Eles não podem ser comprados, transferidos, vendidos ou resgatados. Nenhum prêmio de nenhum tipo.
  • Nenhum sistema de pagamento, depósito, saque, conta ou carteira: nenhum está escondido, desligado ou incluído no pacote.
  • A licença padrão não permite usar este jogo, ou qualquer versão modificada dele, para jogos de azar com dinheiro real ou com qualquer coisa de valor real: sem compra de créditos, sem troca de créditos por dinheiro, sem prêmios baseados em resultados, sem ligação a carteira de apostas, sistema de pagamento ou operador de dinheiro real, sem publicidade de jogos de azar com dinheiro real.
  • Você precisa seguir as leis de todos os lugares onde publicar o jogo (classificação etária, menores de idade, defesa do consumidor). Mantenha visível o aviso "Virtual credits only.".
  • O suporte não cobre carteira, depósito, saque nem qualquer integração com dinheiro real; esses pedidos são recusados.

O texto completo está no SCOPE.md.

Perguntas e problemas

  • A página fica em branco ou mostra só a barra de carregamento. Confira se você enviou o conteúdo de game/ (com lib/, arte/, audio/ e fontes/) e se está abrindo por http(s), não por file://. O console do navegador (F12) mostra o arquivo que falta.
  • Sem som. Os navegadores só liberam o som depois do primeiro toque. Confira o botão do alto-falante, o menu (efeitos sonoros, música) e o volume do aparelho.
  • Posso mudar o RTP? Sim, RTP em motor.js; rode npm test depois.
  • Posso voltar às rodadas com contagem regressiva? Sim: modo: 'sala' no WF_CONFIG (veja "Modos de rodada").
  • Os jogadores podem comprar créditos ou ganhar prêmios? Não. O jogo não tem sistema de pagamento nem de prêmios, e a licença não permite acrescentar um.
  • Funciona offline? Depois de carregado, sim; ele não precisa de nenhum outro site.
  • Posso tirar o aviso "Virtual credits only."? Num lançamento público ele precisa ficar visível (veja SCOPE.md).
  • O jogo fica lento num celular antigo. Ligue "reduzir movimento" no menu: isso tira o tremor de tela e acalma os efeitos.

Suporte e créditos

E-mail de suporte: willian@polargames.com.br (bugs, instalação, layout nos navegadores suportados, traduções, personalização visual e de áudio e as configurações deste guia). Inclua o seu código de compra, o navegador e o aparelho, e uma captura de tela.

Código de terceiros no pacote: PixiJS 7.4.2 (MIT). Fontes: Cinzel e Merriweather (SIL Open Font License 1.1). Ferramenta de desenvolvimento: Prettier (MIT). Textos das licenças em THIRD-PARTY-LICENSES/. Arte, música, voz e efeitos fazem parte do jogo e estão cobertos pela licença da sua compra.