Lumi - Guía de personalización

Recetas para cambiar el aspecto, el sonido, los textos y los niveles sin programar.

← Volver a la guía del comprador

EnglishPortuguêsEspañol

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

ParaHerramienta
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 vesDónde está
Cabeza y cuerpo de Lumiassets/lumi-cabeca.webp, lumi-cabeca-feliz.webp, lumi-cabeca-ai.webp, lumi-gomo.webp
Suelo y rocaassets/bloco.webp, bloco-pedra.webp (mundo 1), versiones -w2, -w3, ilha-base.webp
Fruta, pinchos, portalassets/fruta.webp, espinhos.webp, portal-fechado.webp, portal-aberto.webp
Botón, puerta, farolitoassets/botao-solto.webp, botao-press.webp, porta.webp, lanterna-bloco.webp, pedestal.webp, borla.webp
Fondosassets/fundo-w1/w2/w3.webp (horizontal), fundo-p1/p2/p3.webp (vertical)
Logoassets/logo.webp
Estrellas del resultadoassets/hud/star-on.webp, star-off.webp
Botones, paneles, etiquetasLos dibuja css/style.css (sin imagen)
IconosLa lista de <symbol> al inicio de index.html (SVG)
Textosjs/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) y bloco-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 6: sonidos y música

Reemplaza los archivos .mp3, conservando los nombres.

ArchivoCuándo suena
sfx/step, bump, land, landbigpaso, chocar con una pared, aterrizar, aterrizar desde lo alto
sfx/eat, dropcomer una fruta (el tono sube con cada una), soltar la cola
sfx/plate, door, doorclosebotón pulsado, puerta que se abre, puerta que se cierra
sfx/gate, enter, winel portal se abre, Lumi entra, nivel completado
sfx/spike, undo, restart, hintpinchos, deshacer, reiniciar, pista
music/m-menu, music/m-gamemenú, 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 de STR. 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 name de cada nivel en js/levels.js (inglés y portugués) y la lista N en js/i18n.js.

Añadir un idioma

  1. En js/i18n.js, copia un bloque de idioma dentro de T (por ejemplo es: { ... }), dale el código nuevo (por ejemplo sv) y traduce los textos.
  2. Haz lo mismo en N para los nombres de los niveles (opcional: si falta un nombre, se usa el inglés).
  3. Añade ['sv', 'Svenska'] a LUMI_LANGS al 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úmeroEfecto
moveMsTiempo de un paso. Menor = juego más rápido.
squashCuánto se aplasta el cuerpo al aterrizar.
trauma, shakeMaxPxFuerza de la sacudida de pantalla.
hitstopMsLa pequeña pausa en los pinchos y en la victoria.
lightRadio de luz en las salas oscuras (lumi, lantern, gate), en celdas.
ceremony.pauseMsEspera entre entrar al portal y la ventana de resultado.

Publica tu juego modificado

  1. Prueba en source/ con npm start: juega un nivel de cada mundo, en la computadora y en un teléfono.
  2. Ejecuta npm test.
  3. Copia los archivos modificados a game/ (o sube source/ sin tools/, package.json ni documentation/).
  4. 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.