Antes de começar
Você pode mudar o visual, o som, os textos e as fases de Lumi sem programar. Trabalhe na pasta source/, teste e copie o que mudou para game/ (ou envie source/ sem a pasta tools/).
- Guarde uma cópia do pacote original.
- Mude uma coisa de cada vez e recarregue a página (Ctrl+F5) para ver.
Ferramentas gratuitas
| Para | Ferramenta |
|---|---|
Arquivos de texto (.js, .css, .html) | Visual Studio Code, Notepad++ |
Imagens (.webp, com transparência) | GIMP, Krita, Photopea (no navegador), Squoosh para converter PNG em WebP |
Som (.mp3) | Audacity |
De onde vem cada parte da tela
| O que você vê | Onde está |
|---|---|
| Cabeça e corpo de Lumi | assets/lumi-cabeca.webp, lumi-cabeca-feliz.webp, lumi-cabeca-ai.webp, lumi-gomo.webp |
| Chão e pedra | assets/bloco.webp, bloco-pedra.webp (mundo 1), versões -w2, -w3, ilha-base.webp |
| Fruta, espinhos, portal | assets/fruta.webp, espinhos.webp, portal-fechado.webp, portal-aberto.webp |
| Botão, porta, lanterna | assets/botao-solto.webp, botao-press.webp, porta.webp, lanterna-bloco.webp, pedestal.webp, borla.webp |
| Fundos | assets/fundo-w1/w2/w3.webp (deitado), fundo-p1/p2/p3.webp (em pé) |
| Logo | assets/logo.webp |
| Estrelas do resultado | assets/hud/star-on.webp, star-off.webp |
| Botões, painéis, etiquetas | Desenhados por css/style.css (sem imagem) |
| Ícones | A lista de <symbol> no começo de index.html (SVG) |
| Textos | js/config.js (inglês, português) e js/i18n.js (outros idiomas) |
Receita 1: cores da interface
Abra css/style.css. As primeiras linhas guardam a paleta:
--ink: #1b1147; /* contornos */
--panel: #3b2a9c; /* janela, em cima */
--panel2: #2a1c74; /* janela, embaixo */
--cream: #fff6dc; /* texto */
--gold: #ffd75e; /* botão principal, em cima */
--gold2: #ffa52e; /* botão principal, embaixo */
--goldink: #5a2a08; /* texto sobre o dourado */
--vio: #8468f7; /* outros botões, em cima */
--vio2: #5f43dc; /* outros botões, embaixo */
Mude os valores e todos os botões, janelas e etiquetas acompanham. Mantenha um contraste forte entre --gold e --goldink, e entre --cream e --panel.
Receita 2: fundos
Troque assets/fundo-w1.webp (deitado, cerca de 1920×1080) e assets/fundo-p1.webp (em pé, cerca de 1080×1920) pelas suas imagens, mantendo os nomes. Os mundos 2 e 3 usam -w2, -p2, -w3, -p3; o mundo bônus reaproveita um céu mais escuro. A imagem é cortada para preencher a tela, então deixe a parte importante perto do centro.
Receita 3: o personagem
Lumi é feita de quatro imagens, todas virada para a direita, com fundo transparente:
lumi-cabeca.webp(rosto normal),lumi-cabeca-feliz.webp(feliz, nas telas de resultado e de final),lumi-cabeca-ai.webp(machucada, nos espinhos);lumi-gomo.webp(um pedaço do corpo, repetido).
Mantenha o mesmo tamanho de imagem e o personagem centralizado, para os pedaços se encaixarem. O jogo espelha a cabeça quando Lumi vira para a esquerda.
Receita 4: chão, objetos e o visual de um mundo novo
- Chão:
bloco.webp(um quadrado com grama em cima) ebloco-pedra.webp(a pedra usada abaixo da superfície). O jogo repete a pedra como uma parede contínua e estende a grama pelo topo. - Os mundos 2 e 3 têm os seus próprios
bloco-w2,bloco-pedra-w2,bloco-w3,bloco-pedra-w3. - Objetos: troque
fruta,espinhos,portal-fechado,portal-aberto,botao-solto,botao-press,porta,lanterna-bloco,pedestal.
Mantenha quadrada a imagem quadrada e larga a imagem larga: o jogo escala as imagens, não as estica.
Receita 5: logo e nome do jogo
- Troque
assets/logo.webp(fundo transparente, cerca de 900 px de largura). - Mude o nome da aba do navegador em
index.html:<title>Lumi</title>. - A linha pequena "v1.0 · Polar Games" está em
index.html(class="foot"); mude ou apague.
Receita 6: sons e música
Troque os arquivos .mp3, mantendo os nomes.
| Arquivo | Quando toca |
|---|---|
sfx/step, bump, land, landbig | passo, bater na parede, pousar, pousar de cima |
sfx/eat, drop | comer uma fruta (o tom sobe a cada uma), soltar a cauda |
sfx/plate, door, doorclose | botão pressionado, porta abrindo, porta fechando |
sfx/gate, enter, win | portal abre, Lumi entra, fase concluída |
sfx/spike, undo, restart, hint | espinhos, desfazer, reiniciar, dica |
music/m-menu, music/m-game | menu, fases (tocam em loop e fazem transição suave) |
Mantenha os efeitos curtos (menos de 1 segundo) e com volume parecido.
Receita 7: textos e idiomas
- Textos em inglês e português:
js/config.js, dentro deSTR. Os outros idiomas:js/i18n.js. - Mude só o texto entre as aspas. Mantenha
{n},{m}e{w}: o jogo troca esses códigos por números. - Nomes das fases: o
namede cada fase emjs/levels.js(inglês e português) e a listaNemjs/i18n.js.
Acrescentar um idioma
- Em
js/i18n.js, copie um bloco de idioma dentro deT(por exemploes: { ... }), dê a ele o código novo (por exemplosv) e traduza os textos. - Faça o mesmo em
Npara os nomes das fases (opcional: um nome que falta usa o inglês). - Acrescente
['sv', 'Svenska']emLUMI_LANGS, no fim do arquivo.
Textos longos não são problema: as letras encolhem para caber no botão.
Receita 8: mudar ou acrescentar fases
As fases são desenhos de texto em js/levels.js; o guia principal explica os caracteres. Para acrescentar uma fase, copie uma, dê a ela um novo id e name, desenhe e escolha o world. Depois, em source/:
npm run solve
npm run answers
O solucionador diz quais fases não podem ser terminadas e escreve a meta das 3 estrelas. Um mundo pode ter mais ou menos de 10 fases; a tela de fases mostra 5 por linha.
Receita 9: dicas e vídeo com recompensa
Em js/config.js, hintsPerLevel é o número de dicas grátis em cada fase (0 = ilimitadas). rewardedAd conecta a sua rede de anúncios: o guia principal traz o exemplo.
Receita 10: velocidade e toque do jogo
O bloco FEEL no começo de js/config.js:
| Número | Efeito |
|---|---|
moveMs | Tempo de um passo. Menor = jogo mais rápido. |
squash | Quanto o corpo achata ao pousar. |
trauma, shakeMaxPx | Força do tremor de tela. |
hitstopMs | A pequena pausa nos espinhos e na vitória. |
light | Raio de luz nas salas escuras (lumi, lantern, gate), em células. |
ceremony.pauseMs | Espera entre entrar no portal e a janela de resultado. |
Publicar o seu jogo alterado
- Teste em
source/comnpm start: jogue uma fase de cada mundo, no computador e no celular. - Rode
npm test. - Copie os arquivos alterados para
game/(ou enviesource/semtools/,package.jsonedocumentation/). - Envie e recarregue com Ctrl+F5. Se ainda aparecer a versão antiga, veja "Atualizar o jogo e limpar o cache" no guia principal.