Antes de empezar
Puedes cambiar el aspecto, el sonido, los textos y los niveles de Lumi sin programar. Trabaja en la carpeta source/, prueba y copia lo que cambiaste a game/ (o sube source/ sin la carpeta tools/).
- Guarda una copia del paquete original.
- Cambia una cosa a la vez y recarga la página (Ctrl+F5) para verla.
Herramientas gratuitas
| Para | Herramienta |
|---|---|
Archivos de texto (.js, .css, .html) | Visual Studio Code, Notepad++ |
Imágenes (.webp, con transparencia) | GIMP, Krita, Photopea (en el navegador), Squoosh para convertir PNG a WebP |
Sonido (.mp3) | Audacity |
De dónde viene cada parte de la pantalla
| Lo que ves | Dónde está |
|---|---|
| Cabeza y cuerpo de Lumi | assets/lumi-cabeca.webp, lumi-cabeca-feliz.webp, lumi-cabeca-ai.webp, lumi-gomo.webp |
| Suelo y roca | assets/bloco.webp, bloco-pedra.webp (mundo 1), versiones -w2, -w3, ilha-base.webp |
| Fruta, pinchos, portal | assets/fruta.webp, espinhos.webp, portal-fechado.webp, portal-aberto.webp |
| Botón, puerta, farolito | assets/botao-solto.webp, botao-press.webp, porta.webp, lanterna-bloco.webp, pedestal.webp, borla.webp |
| Fondos | assets/fundo-w1/w2/w3.webp (horizontal), fundo-p1/p2/p3.webp (vertical) |
| Logo | assets/logo.webp |
| Estrellas del resultado | assets/hud/star-on.webp, star-off.webp |
| Botones, paneles, etiquetas | Los dibuja css/style.css (sin imagen) |
| Iconos | La lista de <symbol> al inicio de index.html (SVG) |
| Textos | js/config.js (inglés, portugués) y js/i18n.js (otros idiomas) |
Receta 1: colores de la interfaz
Abre css/style.css. Las primeras líneas guardan la paleta:
--ink: #1b1147; /* contornos */
--panel: #3b2a9c; /* ventana, arriba */
--panel2: #2a1c74; /* ventana, abajo */
--cream: #fff6dc; /* texto */
--gold: #ffd75e; /* botón principal, arriba */
--gold2: #ffa52e; /* botón principal, abajo */
--goldink: #5a2a08; /* texto sobre el dorado */
--vio: #8468f7; /* otros botones, arriba */
--vio2: #5f43dc; /* otros botones, abajo */
Cambia los valores y todos los botones, ventanas y etiquetas los siguen. Mantén un contraste fuerte entre --gold y --goldink, y entre --cream y --panel.
Receta 2: fondos
Reemplaza assets/fundo-w1.webp (horizontal, de unos 1920×1080) y assets/fundo-p1.webp (vertical, de unos 1080×1920) por tus imágenes, conservando los nombres. Los mundos 2 y 3 usan -w2, -p2, -w3, -p3; el mundo extra reutiliza un cielo más oscuro. La imagen se recorta para llenar la pantalla, así que deja lo importante cerca del centro.
Receta 3: el personaje
Lumi está hecha de cuatro imágenes, todas mirando a la derecha, con fondo transparente:
lumi-cabeca.webp(cara normal),lumi-cabeca-feliz.webp(feliz, en las pantallas de resultado y final),lumi-cabeca-ai.webp(herida, en los pinchos);lumi-gomo.webp(un trozo del cuerpo, repetido).
Conserva el mismo tamaño de imagen y mantén al personaje centrado, para que los trozos encajen. El juego refleja la cabeza cuando Lumi gira a la izquierda.
Receta 4: suelo, objetos y el aspecto de un mundo nuevo
- Suelo:
bloco.webp(un cuadrado con pasto arriba) ybloco-pedra.webp(la roca que se usa bajo la superficie). El juego repite la roca como una pared continua y extiende el pasto por la parte de arriba. - Los mundos 2 y 3 tienen sus propios
bloco-w2,bloco-pedra-w2,bloco-w3,bloco-pedra-w3. - Objetos: reemplaza
fruta,espinhos,portal-fechado,portal-aberto,botao-solto,botao-press,porta,lanterna-bloco,pedestal.
Mantén cuadrada la imagen cuadrada y ancha la imagen ancha: el juego las escala, no las estira.
Receta 5: logo y nombre del juego
- Reemplaza
assets/logo.webp(fondo transparente, de unos 900 px de ancho). - Cambia el nombre de la pestaña del navegador en
index.html:<title>Lumi</title>. - La línea pequeña "v1.0 · Polar Games" está en
index.html(class="foot"); cámbiala o bórrala.
Receta 6: sonidos y música
Reemplaza los archivos .mp3, conservando los nombres.
| Archivo | Cuándo suena |
|---|---|
sfx/step, bump, land, landbig | paso, chocar con una pared, aterrizar, aterrizar desde lo alto |
sfx/eat, drop | comer una fruta (el tono sube con cada una), soltar la cola |
sfx/plate, door, doorclose | botón pulsado, puerta que se abre, puerta que se cierra |
sfx/gate, enter, win | el portal se abre, Lumi entra, nivel completado |
sfx/spike, undo, restart, hint | pinchos, deshacer, reiniciar, pista |
music/m-menu, music/m-game | menú, niveles (se repiten en bucle y se funden entre sí) |
Mantén los efectos cortos (menos de 1 segundo) y con un volumen parecido.
Receta 7: textos e idiomas
- Textos en inglés y portugués:
js/config.js, dentro deSTR. Los otros idiomas:js/i18n.js. - Cambia solo el texto entre las comillas. Conserva
{n},{m}y{w}: el juego los reemplaza por números. - Nombres de los niveles: el
namede cada nivel enjs/levels.js(inglés y portugués) y la listaNenjs/i18n.js.
Añadir un idioma
- En
js/i18n.js, copia un bloque de idioma dentro deT(por ejemploes: { ... }), dale el código nuevo (por ejemplosv) y traduce los textos. - Haz lo mismo en
Npara los nombres de los niveles (opcional: si falta un nombre, se usa el inglés). - Añade
['sv', 'Svenska']aLUMI_LANGSal final del archivo.
Los textos largos no son problema: las letras se encogen para caber en el botón.
Receta 8: cambiar o añadir niveles
Los niveles son dibujos de texto en js/levels.js; la guía principal explica los caracteres. Para añadir un nivel, copia uno, dale un id y un name nuevos, dibújalo y elige el world. Después, en source/:
npm run solve
npm run answers
El solucionador dice qué niveles no se pueden terminar y escribe la meta de las 3 estrellas. Un mundo puede tener más o menos de 10 niveles; la pantalla de niveles los muestra de 5 en 5 por fila.
Receta 9: pistas y video con recompensa
En js/config.js, hintsPerLevel es el número de pistas gratis en cada nivel (0 = ilimitadas). rewardedAd conecta tu red de anuncios: la guía principal trae el ejemplo.
Receta 10: velocidad y sensación de juego
El bloque FEEL al inicio de js/config.js:
| Número | Efecto |
|---|---|
moveMs | Tiempo de un paso. Menor = juego más rápido. |
squash | Cuánto se aplasta el cuerpo al aterrizar. |
trauma, shakeMaxPx | Fuerza de la sacudida de pantalla. |
hitstopMs | La pequeña pausa en los pinchos y en la victoria. |
light | Radio de luz en las salas oscuras (lumi, lantern, gate), en celdas. |
ceremony.pauseMs | Espera entre entrar al portal y la ventana de resultado. |
Publica tu juego modificado
- Prueba en
source/connpm start: juega un nivel de cada mundo, en la computadora y en un teléfono. - Ejecuta
npm test. - Copia los archivos modificados a
game/(o subesource/sintools/,package.jsonnidocumentation/). - Sube y recarga con Ctrl+F5. Si aún ves la versión vieja, consulta "Actualizar el juego y limpiar la caché" en la guía principal.