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.
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.
- Abra o gerenciador de arquivos da sua hospedagem ou conecte com um programa de FTP (por exemplo, o FileZilla).
- Crie uma pasta para o jogo, por exemplo
/games/witch-flight/. -
Envie o conteúdo de
game/para ela:index.html, os arquivos.jse.css,SCOPE.md,DOCUMENTATION.txte as pastasarte/,audio/,fontes/elib/. -
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.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
- Botão de casa (endereço no WF_CONFIG, ou escondido)
- Saldo de créditos de brincadeira
- Recarga grátis (+10.000 créditos de brincadeira)
- Liga/desliga o som
- Melhores voos
- Menu
- Multiplicador (o título acima mostra a fase da rodada)
- Últimas rodadas
- Diminui a aposta
- Aumenta a aposta
- Liga/desliga o saque automático
- Alvo do saque automático
- BET / CASH OUT / CANCEL (mostra a aposta, ou quanto ela vale agora)
- 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.
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.
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.
1
2
3
4
5
6
- Efeitos sonoros
- Música
- Menos movimento
- Idioma (14)
- Como jogar (tutorial)
- Jogo justo (hash e semente)
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." |
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
- 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.
- O hash aparece em Menu > FAIR PLAY antes da decolagem.
- Depois do voo, a semente daquele voo aparece na mesma janela, para qualquer pessoa conferir que SHA-256(semente) é o hash mostrado antes.
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.
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
-
Acesse
https://nodejs.orge 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. - Feche e abra o terminal de novo (Windows: PowerShell ou Prompt de Comando; macOS: Terminal).
- 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 testconfere 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 startinicia um servidor local emhttp://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 buildcopia o jogo parasource/dist/(a pasta é esvaziada antes, então um arquivo apagado também sai dela). Envie o conteúdo dedist/: ele substituigame/. -
npm run formatformata todos os arquivos com o Prettier;npm run checksó confere.
Problemas comuns
-
nodeounpmnã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 rodenpm.cmd ci. ENOENT ... package.json: o terminal não está na pastasource/.EBADENGINE: seu Node.js é mais antigo que 26.13.0. Instale a LTS atual.-
npm cifalha com erro de rede: confira a conexão ou o proxy da rede da sua empresa e rode de novo. -
npm cidiz que o arquivo de lock está fora de sincronia: você mudou opackage.json; rodenpm installuma vez e depois onpm civolta a funcionar. -
EADDRINUSEcomnpm 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,APOSTASeAUTOSemjogo.js; matemática emmotor.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 doindex.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/(comlib/,arte/,audio/efontes/) e se está abrindo por http(s), não porfile://. 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,
RTPemmotor.js; rodenpm testdepois. -
Posso voltar às rodadas com contagem regressiva? Sim:
modo: 'sala'noWF_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.