Descripción general
Lumi es un juego de rompecabezas con plataformas en HTML5. Lumi es una oruga de farolito de papel: camina por una cuadrícula, cae con la gravedad, come frutas para crecer y, desde el Mundo 2, suelta el último trozo de su cola como un farolito que se queda donde cae. Come todas las frutas para abrir el portal y entra en él.
- 40 niveles en 4 mundos (10 en cada uno), todos comprobados por el solucionador incluido.
- 3 estrellas por nivel, pistas, deshacer ilimitado, reiniciar, pantalla de toca para empezar, pantalla final.
- Teclado, flechas en pantalla y deslizamiento. Teléfono (vertical y horizontal), tableta, computadora y pantalla ultrawide.
- 14 idiomas de interfaz. Efectos de sonido y música incluidos.
- HTML, CSS y JavaScript simples. Sin paso de compilación, sin framework, sin código de servidor.
Instalar en tu sitio web
- Descomprime el paquete.
- Sube el contenido de la carpeta
game/a cualquier hosting (hosting compartido, una CDN, Netlify, GitHub Pages...). - Abre
index.htmlen el navegador. Eso es todo.
Abre el juego mediante http:// o https://. Hacer doble clic en index.html en tu computadora (una dirección file://) también funciona en la mayoría de los navegadores, pero ahí el sonido y el progreso guardado pueden quedar bloqueados.
Ponerlo dentro de una página (iframe)
<iframe src="https://your-site.com/lumi/index.html" width="960" height="540" style="border:0" allow="autoplay; fullscreen"></iframe>
El juego ocupa el tamaño que tenga el marco, en vertical o en horizontal.
Portales de juegos
El juego muestra primero una pantalla de "toca para empezar", para que el navegador permita el sonido después del primer toque. No hay ninguna solicitud externa: las fuentes, el arte y el sonido están dentro de la carpeta.
Requisitos
- Para publicar: cualquier hosting de archivos estáticos. Sin PHP, base de datos ni Node.js.
- Para jugar: una versión actual de Chrome, Edge, Firefox, Safari u Opera, en computadora o en móvil.
- Para usar las herramientas de niveles (opcional): Node.js 18 o más reciente.
Cómo jugar y las pantallas
- Mover: flechas del teclado o WASD, las flechas en pantalla o un deslizamiento.
- Soltar la cola (desde el Mundo 2): Space, el botón del farolito o doble toque en el modo de deslizamiento. Lumi necesita al menos 3 trozos.
- Deshacer: Z o el botón de deshacer, todas las veces que quieras. Reiniciar: R o el botón de reiniciar. Pista: H o la bombilla. Pausa: Esc o el botón de pausa.
- Las frutas son sólidas: solo la cabeza las come. Los pinchos devuelven a Lumi un paso atrás. Un botón de presión abre la puerta mientras haya algo encima; un farolito soltado cuenta. Algunas salas son oscuras: solo Lumi, sus farolitos y el portal dan luz.
- Estrellas: 3 por el menor número de pasos (la "meta"), 2 por hasta un 35% más, 1 por terminar.
Ajustes
Cuatro pestañas: sonido (efectos, música, vibración), controles (flechas o deslizamiento, tamaño de los botones, modo zurdo), accesibilidad (menos movimiento, sacudida de pantalla, salas oscuras más claras) e idioma.
Qué hay en el paquete
| Carpeta o archivo | Qué es |
|---|---|
START-HERE.txt | La versión corta de esta guía. |
DOCUMENTATION.html, CUSTOMIZATION.html | Accesos directos a esta guía y a la guía de personalización. |
ANSWER-CARD.html | La solución de cada nivel, para imprimir o tener a mano. |
documentation/ | Las guías en inglés, portugués y español, y sus imágenes. |
game/ | El juego, listo para subir. |
source/ | El mismo juego más las herramientas de niveles (tools/) y package.json. Edita aquí y luego copia a game/. |
THIRD-PARTY-LICENSES/ | La licencia de la fuente. |
CHANGELOG.txt | Historial de versiones. |
Dentro de game/
| Archivo | Qué hace |
|---|---|
index.html | La página: pantallas, botones e iconos (SVG integrado). |
css/style.css | Todos los colores, tamaños y reglas de diseño de la interfaz. |
js/config.js | Números de la sensación de juego, tus ajustes (LUMI_CONFIG) y los textos en inglés y portugués. |
js/i18n.js | Los otros 12 idiomas y la lista de idiomas. |
js/levels.js | Los 40 niveles, dibujados como texto. |
js/levels-sol.js | El menor número de pasos y la solución de cada nivel (escrito por el solucionador). |
js/sim.js | Las reglas del rompecabezas (sin dibujo). |
js/game.js | Dibujo, animación y efectos. |
js/ui.js | Pantallas, controles, ajustes y progreso guardado. |
js/scene.js, js/fx.js, js/audio.js, js/fit.js | Escena de fondo, resortes y partículas, sonido, y texto que se encoge para caber en su botón. |
assets/ | Arte (.webp), sonido (sfx/, music/, .mp3) y la fuente (fonts/). |
Todos los archivos se pueden leer (sin minificar) y están comentados.
Ajustes
Abre game/js/config.js y busca LUMI_CONFIG:
var LUMI_CONFIG = { hintsPerLevel: 3, rewardedAd: null };
| Ajuste | Significado |
|---|---|
hintsPerLevel | Pistas gratis en cada nivel. 0 significa ilimitadas. |
rewardedAd | null, o tu función que muestra un video con recompensa. Cuando se acaban las pistas, el juego muestra un botón "+1 pista" que llama a esa función. |
debug | true muestra el botón de solución a todo el mundo (ver abajo). Déjalo fuera cuando publiques. |
Video con recompensa para pistas extra
var LUMI_CONFIG = {
hintsPerLevel: 3,
rewardedAd: function (done) {
// muestra tu anuncio aquí y luego:
done(true); // true = el jugador lo vio y recibe 1 pista más
}
};
Números de la sensación de juego
El bloque FEEL al inicio de config.js guarda todos los números de animación (tiempo del paso, aplastamiento, sacudida de pantalla, pausa del golpe, radio de luz en las salas oscuras...). Cambia un número, recarga la página y siente la diferencia.
Niveles
Cada nivel de js/levels.js es un pequeño dibujo hecho con caracteres, de la fila de arriba hacia abajo:
{ id: "my-level", world: 1, name: { en: "My Level", pt: "Minha fase" },
rows: [
'..........',
'.......X..',
'..o...###.',
'#####.....',
],
snake: [[2, 2], [1, 2], [0, 2]] },
| Carácter | Significado |
|---|---|
# | Bloque (suelo y paredes) |
. | Vacío |
o | Fruta |
X | Portal (uno por nivel) |
^ | Pinchos |
_ | Botón de presión (un bloque con un botón encima) |
D | Puerta, abierta por el botón |
snakeenumera los trozos de Lumi como[column, row], la cabeza primero, contados desde 0 en la esquina superior izquierda. Cada trozo debe empezar en una celda vacía.worldva de 1 a 4 y elige el arte, la música y dónde aparece el nivel.dark: truecrea una sala oscura.- El
iddebe ser único: el progreso guardado lo usa.
Comprueba tus niveles
Después de cambiar levels.js, ejecuta el solucionador desde source/. Demuestra que cada nivel se puede terminar y escribe el menor número de pasos (la meta de las 3 estrellas) y la solución que usa la pista:
npm run solve
Luego npm run answers reconstruye la tarjeta de respuestas. Copia js/levels.js y js/levels-sol.js a game/js/.
Un nivel que no está en levels-sol.js no se puede jugar: ejecuta siempre el solucionador después de editar los niveles.
Botón de solución y tarjeta de respuestas
Añade ?debug a la dirección (por ejemplo index.html?debug) para desbloquear todos los niveles y obtener un botón rosa de reproducir junto a la pista. Haz clic en él (o pulsa P) y el juego reinicia el nivel y reproduce la solución, mostrando la secuencia de pasos en la parte inferior. Haz clic otra vez para detenerla.
?lv=12 abre directamente el nivel 12; se pueden combinar: index.html?debug&lv=12.
ANSWER-CARD.html trae las mismas soluciones en papel: las flechas son pasos y el punto naranja es "soltar la cola".
Idiomas
Inglés, portugués, español, francés, alemán, italiano, neerlandés, polaco, turco, indonesio, ruso, japonés, coreano y chino simplificado. El juego empieza en el idioma del navegador cuando es uno de estos; si no, en inglés. El jugador puede cambiarlo en los ajustes.
- Los textos nunca saltan de línea ni se salen de su botón: cuando una traducción es larga, solo se hacen más pequeñas las letras.
- La fuente incluida (Baloo 2) cubre los alfabetos latinos. El ruso, el japonés, el coreano y el chino usan la fuente del dispositivo.
- Para cambiar un texto o añadir un idioma, consulta la guía de personalización.
Datos guardados
El progreso y los ajustes se guardan en el navegador (localStorage, clave lumi.v1): niveles desbloqueados, mejor número de pasos por nivel, idioma, volúmenes y opciones de control. No se envía nada a un servidor. Borrar los datos del sitio elimina el progreso.
Editar el código fuente
El juego no tiene paso de compilación: los archivos de source/ son los mismos que se ejecutan. Solo necesitas Node.js para las herramientas opcionales.
- Instala Node.js 18 o más reciente desde nodejs.org.
- Abre una terminal en la carpeta
source/. - Usa los comandos de abajo.
| Comando | Qué hace |
|---|---|
npm start | Servidor local en http://localhost:5317/ (algunos navegadores bloquean el sonido y el guardado en file://). |
npm test | Ejecuta las pruebas de reglas y resuelve todos los niveles. |
npm run solve | Lo mismo, y escribe js/levels-sol.js. |
npm run answers | Reconstruye documentation/answer-card.html. |
No hay nada que instalar con npm install: las herramientas no tienen dependencias.
Nombres internos
El código lo escribió un estudio brasileño y algunos nombres están en portugués. Los más comunes:
| Nombre | Significado |
|---|---|
fase, fases | nivel, niveles |
fruta | fruta |
bloco, bloco-pedra | bloque, bloque de piedra |
espinhos | pinchos |
botao, porta | botón de presión, puerta |
portal-fechado, portal-aberto | portal cerrado, portal abierto |
gomo, cabeca | trozo del cuerpo, cabeza |
lanterna-bloco, pedestal, borla | farolito soltado, su soporte, borla de la cola |
fundo-w1, fundo-p1 | fondo del mundo 1 en horizontal, en vertical |
ilha-base | parte inferior de la isla flotante |
Actualizar el juego y limpiar la caché
Los navegadores guardan archivos viejos. Después de subir una versión nueva, cambia el nombre de la carpeta o añade una versión a las direcciones de los archivos en index.html (por ejemplo js/ui.js?v=2), y recarga con Ctrl+F5 para probar.
Preguntas y problemas
- No hay sonido. Los navegadores solo permiten el sonido después de un toque o de una tecla: para eso sirve la pantalla de "toca para empezar". Revisa el volumen en los ajustes y el botón de silencio en la pantalla de título.
- El juego no abre en mi computadora. Ábrelo mediante una dirección web o con
npm start, no con doble clic en el archivo. - El progreso desapareció. Vive en el navegador: otro navegador, una ventana privada o datos del sitio borrados empiezan desde cero.
- Un nivel que edité no abre. Ejecuta
npm run solvey copialevels-sol.jsotra vez. - ¿Puedo quitar un idioma? Sí: borra su línea de
LUMI_LANGSal final dejs/i18n.js. - ¿Puedo venderlo como app? La licencia de tu compra decide lo que puedes hacer; consulta los términos de licencia del marketplace.
Soporte y créditos
Preguntas sobre la instalación o la personalización: willian@polargames.com.br. Envía la dirección donde está publicado el juego y lo que cambiaste.
Juego, arte, sonido y código por Polar Games. Fuente: Baloo 2 (SIL Open Font License 1.1, en THIRD-PARTY-LICENSES/).