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.
-
Faça um backup. Copie a pasta inteira do pacote (ou pelo menos
game/ousource/) para outro lugar antes de mudar qualquer coisa. Se algo quebrar, coloque a cópia de volta. -
Escolha onde editar. Os arquivos em
game/e emsource/são os mesmos arquivos legíveis: nada é compilado. Você pode editargame/direto e enviá-lo, ou editarsource/e rodarnpm run build(veja o guia técnico) para gerar uma cópia nova emsource/dist/. Escolha um e fique nele, para que as suas mudanças não acabem em dois lugares. -
Veja a sua mudança. Abra o jogo por um endereço web (a sua hospedagem, ou
npm startno seu computador), não com um clique duplo noindex.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
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)
| 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
-
Abra
arte/fundo/e veja as quatro camadas:f_ceu(céu),f_nuvens(nuvens),f_montanhas(morros) ef_perto(a camada da frente). Elas correm em velocidades diferentes enquanto a bruxa voa. - 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).
- 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.
- Exporte em WebP com o mesmo nome e substitua o arquivo antigo.
- Recarregue o jogo sem o cache.
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)
-
Abra cada camada de
arte/final/que você quer mudar (por exemplohat.webp,hat_front.webp,cape_1.webp,cape_2.webp,cape_front_1.webp,cape_front_2.webp). - Mude as cores com matiz/saturação no seu editor. Não mova, não redimensione e não corte nada.
- Exporte com os mesmos nomes.
Um personagem novo (avançado)
- 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).
- 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.
-
Escreva onde cada camada fica no desenho de 1536 × 1024 (o canto superior esquerdo dela,
xey) emarte/camadas.json, ao lado do nome dela. -
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). -
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 4: logo e nome do jogo
-
Substitua
arte/novo/final/logo.webppelo seu logo no mesmo tamanho (ele aparece na tela de carregamento). -
No
index.html, mude o texto dentro de<title>Witch Flight</title>(a aba do navegador) e oalt="Witch Flight"do logo.
Receita 5: sons e música
- 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 |
- Faça o seu som no Audacity, exporte em MP3 com o mesmo nome e substitua o arquivo.
-
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
-
Abra
estilo.css. No topo, o bloco:roottem os valores principais:--serif(a fonte dos títulos),--num(a fonte dos números e textos) e--creme(a cor clara do texto). -
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. -
As fontes ficam em
fontes/(Cinzel e Merriweather, licença livre). Para usar outra fonte, copie os arquivos WOFF2 dela parafontes/, acrescente um bloco@font-facepara ela emfontes/fontes.csse coloque o nome dela em primeiro lugar em--serifou--num.
Receita 7: textos e idiomas
-
Abra
idiomas.js. Cada idioma é um bloco (en: { ... },pt: { ... }...). -
Mude o texto entre as aspas. Mantenha
{0}e{1}(o jogo coloca números ali) e<br>(uma quebra de linha). -
Para oferecer menos idiomas, apague os blocos deles e os nomes deles em
WF_NOMES, no topo. Mantenha oen: ele é a reserva para qualquer texto que falte.
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.
Receita 9: modo de rodada e o botão de início
-
Abra
index.htmle encontrewindow.WF_CONFIG = { modo: 'solo' };perto do fim. -
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). -
home: '/'faz o botão da casinha no canto superior esquerdo ir para a sua página inicial;home: falseesconde o botão.
Exemplo: window.WF_CONFIG = { modo: 'sala', home: '/games/' };
Receita 10: retorno ao jogador e velocidade
- Abra
motor.js. -
RTP: 0.97é o retorno ao jogador (97%). Um número menor deixa, em média, mais créditos no jogo. -
K: 0.00009é a velocidade da subida: um número maior faz o multiplicador crescer mais rápido. -
Se você usa Node.js, rode
npm testemsource/: ele mede o retorno dos seus números novos.
Publicar o seu jogo alterado
-
Envie os arquivos alterados (ou a pasta
game/inteira, ou o conteúdo desource/dist/depois donpm run build) para a sua hospedagem, substituindo os antigos. - Recarregue sem o cache. Se a versão antiga ainda aparecer, veja "Atualizar o jogo e limpar o cache" no guia técnico.
- Mantenha o
SCOPE.mdjunto com o jogo e o aviso "Virtual credits only." visível.
Dúvidas: willian@polargames.com.br.