Witch Flight 1.0.0: guia de personalização

Receitas passo a passo para trocar arte, sons, textos e ajustes, sem programar.

Guia principal do comprador

EnglishPortuguêsEspañol

Antes de começar

Este guia tem receitas passo a passo para mudar a aparência e os sons do Witch Flight, para quem não programa. O guia técnico completo é o DOCUMENTATION.html.

  1. Faça um backup. Copie a pasta inteira do pacote (ou pelo menos game/ ou source/) para outro lugar antes de mudar qualquer coisa. Se algo quebrar, coloque a cópia de volta.
  2. Escolha onde editar. Os arquivos em game/ e em source/ são os mesmos arquivos legíveis: nada é compilado. Você pode editar game/ direto e enviá-lo, ou editar source/ e rodar npm run build (veja o guia técnico) para gerar uma cópia nova em source/dist/. Escolha um e fique nele, para que as suas mudanças não acabem em dois lugares.
  3. Veja a sua mudança. Abra o jogo por um endereço web (a sua hospedagem, ou npm start no seu computador), não com um clique duplo no index.html. Depois de cada mudança, recarregue sem o cache (Ctrl+F5, ou Cmd+Shift+R no macOS).

Ferramentas gratuitas

Tarefa Ferramenta gratuita
Editar arquivos de texto (.html, .css, .js) Visual Studio Code, Notepad++ (Windows), TextEdit no modo texto simples (macOS)
Editar imagens e salvar em WebP GIMP, Krita, Photopea (no navegador)
Converter PNG ou JPG para WebP Squoosh (squoosh.app, no navegador)
Editar sons e converter para MP3 Audacity
Enviar para a sua hospedagem FileZilla, ou o gerenciador de arquivos do painel da sua hospedagem

Sempre mantenha o mesmo nome de arquivo e o mesmo tamanho da imagem (largura × altura em pixels) quando trocar um arquivo. O jogo posiciona as imagens pelo tamanho delas.

De onde vem cada parte da tela

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)
Parte da tela Arquivo
Céu com estrelas arte/ceu.webp e arte/fundo/f_ceu.webp
Nuvens, morros, o castelo e as árvores da frente arte/fundo/f_nuvens.webp, f_montanhas.webp, f_perto.webp, arte/ui/final/castelo.webp
Lua arte/ui/final/lua2.webp
A bruxa arte/final/ (uma imagem por camada: body, head, hat, hair_back_1... )
Moedas, fumaça, rastros de vento, coisas que passam no céu arte/novo/final/moeda-*.webp, fumaca-*.webp, vento-*.webp, extra-0*.webp
Barra superior, painel, botões, pílulas, ícones arte/ui/final/
Logo na tela de carregamento arte/novo/final/logo.webp
Números dourados (x3.47, prêmios) arte/final/font-gold.webp + font-gold.json
Placas BIG / MEGA / EPIC WIN arte/final/placa_big.webp, placa_mega.webp, placa_epic.webp
Textos idiomas.js
Cores, tamanhos, posições estilo.css

Receita 1: trocar o fundo

  1. Abra arte/fundo/ e veja as quatro camadas: f_ceu (céu), f_nuvens (nuvens), f_montanhas (morros) e f_perto (a camada da frente). Elas correm em velocidades diferentes enquanto a bruxa voa.
  2. Anote o tamanho do arquivo que você quer trocar (clique com o botão direito > Propriedades > Detalhes no Windows, ou abra no seu editor de imagens).
  3. Faça a sua imagem nova exatamente nesse tamanho. Mantenha transparentes as áreas transparentes das nuvens, dos morros e da camada da frente, para que as camadas de trás apareçam.
  4. Exporte em WebP com o mesmo nome e substitua o arquivo antigo.
  5. Recarregue o jogo sem o cache.
Modo Solo: a bruxa flutua e espera uma aposta.
Modo Solo: a bruxa flutua e espera uma aposta.

Receita 2: trocar a bruxa

A bruxa é feita de camadas separadas (corpo, cabeça, chapéu, mechas de cabelo, capa, rostos) que o motor de animação dobra em tempo real, por isso o cabelo e a capa se movem com física. Você pode mudar as cores dela ou trocá-la por um personagem na mesma pose.

Mudar as cores (fácil)

  1. Abra cada camada de arte/final/ que você quer mudar (por exemplo hat.webp, hat_front.webp, cape_1.webp, cape_2.webp, cape_front_1.webp, cape_front_2.webp).
  2. Mude as cores com matiz/saturação no seu editor. Não mova, não redimensione e não corte nada.
  3. Exporte com os mesmos nomes.

Um personagem novo (avançado)

  1. Desenhe o personagem novo na mesma pose e no mesmo tamanho do original (tela de 1536 × 1024, a bruxa na vassoura virada para a direita).
  2. Divida-o nas mesmas camadas, cada uma recortada bem justa sobre fundo transparente: corpo com a vassoura, cabeça, chapéu, a frente do chapéu, olhos fechados, olhos assustados, boca aberta, boca em "o", as quatro mechas de cabelo (partes de trás e do meio) e as duas partes da capa.
  3. Escreva onde cada camada fica no desenho de 1536 × 1024 (o canto superior esquerdo dela, x e y) em arte/camadas.json, ao lado do nome dela.
  4. Mantenha as máscaras PNG de arte/final/mask_*.png: elas dizem ao motor qual parte de cada camada de cabelo e de capa pode dobrar. Se o seu cabelo ou a sua capa tiver um formato muito diferente, pinte máscaras novas (branco = livre para mexer, preto = fixo).
  5. As posições dos ossos (pescoço, chapéu, raízes do cabelo) ficam em bruxa.js, em pixels dessa tela de 1536 × 1024. Se a cabeça ou o chapéu do seu personagem estiver em outro lugar, mude esses números.

Receita 3: botões, painel e ícones

Todas as imagens da interface ficam em arte/ui/final/. Os painéis, pílulas e barras são esticados pelo jogo mantendo os cantos, então você pode mudar as cores à vontade.

  1. Abra a imagem (por exemplo botao_laranja.webp, o botão grande BET / CASH OUT, ou painel_alto.webp).
  2. Mude a imagem no seu editor no mesmo tamanho. Mantenha os cantos e as bordas com a mesma largura, porque o jogo corta a imagem em nove partes e só estica o meio.
  3. Exporte com o mesmo nome.

As palavras do botão grande também são imagens: txt_bet.webp, txt_cashout.webp, txt_cancel.webp. Para traduzi-las, faça imagens novas com as suas palavras no mesmo tamanho.

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.

Receita 5: sons e música

  1. Abra audio/. Cada MP3 tem um nome fixo e um momento fixo:
Arquivo Quando toca
music.mp3 música de fundo, em loop
bet.mp3, click.mp3 aposta e botões
go.mp3, takeoff.mp3, wind.mp3 a decolagem e o vento enquanto ela voa
cashout.mp3, coin.mp3 o saque (CASH OUT) e as moedas chegando ao saldo
poof.mp3, voz-grito.mp3 a queda e o grito da bruxa
voz-uhul.mp3, voz-riso.mp3 a voz da bruxa num saque
bigwin.mp3, v-big.mp3, v-mega.mp3, v-epic.mp3 as comemorações de vitória
count.mp3 o prêmio sendo contado na placa
  1. Faça o seu som no Audacity, exporte em MP3 com o mesmo nome e substitua o arquivo.
  2. Mantenha os loops (music, wind, count) sem silêncio no começo e no fim, para que eles se repitam sem emenda.

Os sinos da contagem regressiva do modo Sala são feitos por código (sem arquivo).

Receita 6: cores e fontes

  1. Abra estilo.css. No topo, o bloco :root tem os valores principais: --serif (a fonte dos títulos), --num (a fonte dos números e textos) e --creme (a cor clara do texto).
  2. Para mudar uma cor, encontre-a (por exemplo #ffe9a8, o dourado dos valores do menu) e escreva outro código de cor. Qualquer seletor de cores online gratuito dá o código.
  3. As fontes ficam em fontes/ (Cinzel e Merriweather, licença livre). Para usar outra fonte, copie os arquivos WOFF2 dela para fontes/, acrescente um bloco @font-face para ela em fontes/fontes.css e coloque o nome dela em primeiro lugar em --serif ou --num.

Receita 7: textos e idiomas

  1. Abra idiomas.js. Cada idioma é um bloco (en: { ... }, pt: { ... }...).
  2. Mude o texto entre as aspas. Mantenha {0} e {1} (o jogo coloca números ali) e <br> (uma quebra de linha).
  3. Para oferecer menos idiomas, apague os blocos deles e os nomes deles em WF_NOMES, no topo. Mantenha o en: ele é a reserva para qualquer texto que falte.
O menu: efeitos, música, menos movimento, idioma, como jogar e jogo justo.
O menu: efeitos, música, menos movimento, idioma, como jogar e jogo justo.

Receita 8: apostas, saldo e comemorações

Abra jogo.js e procure estes nomes perto do topo:

  • const APOSTAS = [10, 20, 50, ...]: os valores de aposta dos botões – e +, do menor para o maior.
  • const AUTOS = [1.2, 1.5, 2, ...]: os alvos do saque automático na lista.
  • 10000 (três lugares): o saldo inicial, o botão de recarga grátis e a recarga automática quando os créditos acabam.
  • tiers: { big: 10, mega: 25, epic: 50 }: quantas vezes a aposta um saque precisa pagar para abrir cada comemoração.
  • marcos: [2, 3, 5, 10, ...]: os multiplicadores que tocam um sino e piscam.

Salve, recarregue e confira se o jogo ainda abre. Se a página ficar em branco, uma vírgula ou um colchete se perdeu: coloque o backup de volta e tente de novo.

MEGA WIN: 25 vezes a aposta ou mais.
MEGA WIN: 25 vezes a aposta ou mais.

Receita 9: modo de rodada e o botão de início

  1. Abra index.html e encontre window.WF_CONFIG = { modo: 'solo' }; perto do fim.
  2. modo: 'sala' liga o modo Sala ('sala' é o valor no código; contagem regressiva e voos contínuos); modo: 'solo' é o padrão (a rodada começa quando o jogador aposta).
  3. home: '/' faz o botão da casinha no canto superior esquerdo ir para a sua página inicial; home: false esconde o botão.

Exemplo: window.WF_CONFIG = { modo: 'sala', home: '/games/' };

Modo Sala: a contagem para o próximo voo.
Modo Sala: a contagem para o próximo voo.

Receita 10: retorno ao jogador e velocidade

  1. Abra motor.js.
  2. RTP: 0.97 é o retorno ao jogador (97%). Um número menor deixa, em média, mais créditos no jogo.
  3. K: 0.00009 é a velocidade da subida: um número maior faz o multiplicador crescer mais rápido.
  4. Se você usa Node.js, rode npm test em source/: ele mede o retorno dos seus números novos.

Publicar o seu jogo alterado

  1. Envie os arquivos alterados (ou a pasta game/ inteira, ou o conteúdo de source/dist/ depois do npm run build) para a sua hospedagem, substituindo os antigos.
  2. Recarregue sem o cache. Se a versão antiga ainda aparecer, veja "Atualizar o jogo e limpar o cache" no guia técnico.
  3. Mantenha o SCOPE.md junto com o jogo e o aviso "Virtual credits only." visível.

Dúvidas: willian@polargames.com.br.