Lumi - Guia de personalização

Receitas para mudar o visual, o som, os textos e as fases sem programar.

← Voltar ao guia do comprador

EnglishPortuguêsEspañol

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

ParaFerramenta
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 Lumiassets/lumi-cabeca.webp, lumi-cabeca-feliz.webp, lumi-cabeca-ai.webp, lumi-gomo.webp
Chão e pedraassets/bloco.webp, bloco-pedra.webp (mundo 1), versões -w2, -w3, ilha-base.webp
Fruta, espinhos, portalassets/fruta.webp, espinhos.webp, portal-fechado.webp, portal-aberto.webp
Botão, porta, lanternaassets/botao-solto.webp, botao-press.webp, porta.webp, lanterna-bloco.webp, pedestal.webp, borla.webp
Fundosassets/fundo-w1/w2/w3.webp (deitado), fundo-p1/p2/p3.webp (em pé)
Logoassets/logo.webp
Estrelas do resultadoassets/hud/star-on.webp, star-off.webp
Botões, painéis, etiquetasDesenhados por css/style.css (sem imagem)
ÍconesA lista de <symbol> no começo de index.html (SVG)
Textosjs/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) e bloco-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 6: sons e música

Troque os arquivos .mp3, mantendo os nomes.

ArquivoQuando toca
sfx/step, bump, land, landbigpasso, bater na parede, pousar, pousar de cima
sfx/eat, dropcomer uma fruta (o tom sobe a cada uma), soltar a cauda
sfx/plate, door, doorclosebotão pressionado, porta abrindo, porta fechando
sfx/gate, enter, winportal abre, Lumi entra, fase concluída
sfx/spike, undo, restart, hintespinhos, desfazer, reiniciar, dica
music/m-menu, music/m-gamemenu, 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 de STR. 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 name de cada fase em js/levels.js (inglês e português) e a lista N em js/i18n.js.

Acrescentar um idioma

  1. Em js/i18n.js, copie um bloco de idioma dentro de T (por exemplo es: { ... }), dê a ele o código novo (por exemplo sv) e traduza os textos.
  2. Faça o mesmo em N para os nomes das fases (opcional: um nome que falta usa o inglês).
  3. Acrescente ['sv', 'Svenska'] em LUMI_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úmeroEfeito
moveMsTempo de um passo. Menor = jogo mais rápido.
squashQuanto o corpo achata ao pousar.
trauma, shakeMaxPxForça do tremor de tela.
hitstopMsA pequena pausa nos espinhos e na vitória.
lightRaio de luz nas salas escuras (lumi, lantern, gate), em células.
ceremony.pauseMsEspera entre entrar no portal e a janela de resultado.

Publicar o seu jogo alterado

  1. Teste em source/ com npm start: jogue uma fase de cada mundo, no computador e no celular.
  2. Rode npm test.
  3. Copie os arquivos alterados para game/ (ou envie source/ sem tools/, package.json e documentation/).
  4. Envie e recarregue com Ctrl+F5. Se ainda aparecer a versão antiga, veja "Atualizar o jogo e limpar o cache" no guia principal.