Lumi - Guía del comprador

Instalación, ajustes, niveles, idiomas y soporte de Lumi 1.0.0.

Guía de personalización: cambia arte, sonido, textos y niveles →

EnglishPortuguêsEspañol

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.
Un nivel del Mundo 1: Lumi, dos frutas y el portal (1280×720).
Un nivel del Mundo 1: Lumi, dos frutas y el portal (1280×720).

Instalar en tu sitio web

  1. Descomprime el paquete.
  2. Sube el contenido de la carpeta game/ a cualquier hosting (hosting compartido, una CDN, Netlify, GitHub Pages...).
  3. Abre index.html en 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.
Selección de nivel: 10 niveles por mundo, con las estrellas ganadas en cada uno.
Selección de nivel: 10 niveles por mundo, con las estrellas ganadas en cada uno.
Nivel completado: estrellas, pasos y los botones de niveles, repetir y siguiente.
Nivel completado: estrellas, pasos y los botones de niveles, repetir y siguiente.

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.

Ajustes: sonido, controles, accesibilidad e idioma.
Ajustes: sonido, controles, accesibilidad e idioma.
En un teléfono en vertical, con las flechas en pantalla.
En un teléfono en vertical, con las flechas en pantalla.

Qué hay en el paquete

Carpeta o archivoQué es
START-HERE.txtLa versión corta de esta guía.
DOCUMENTATION.html, CUSTOMIZATION.htmlAccesos directos a esta guía y a la guía de personalización.
ANSWER-CARD.htmlLa 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.txtHistorial de versiones.

Dentro de game/

ArchivoQué hace
index.htmlLa página: pantallas, botones e iconos (SVG integrado).
css/style.cssTodos los colores, tamaños y reglas de diseño de la interfaz.
js/config.jsNúmeros de la sensación de juego, tus ajustes (LUMI_CONFIG) y los textos en inglés y portugués.
js/i18n.jsLos otros 12 idiomas y la lista de idiomas.
js/levels.jsLos 40 niveles, dibujados como texto.
js/levels-sol.jsEl menor número de pasos y la solución de cada nivel (escrito por el solucionador).
js/sim.jsLas reglas del rompecabezas (sin dibujo).
js/game.jsDibujo, animación y efectos.
js/ui.jsPantallas, controles, ajustes y progreso guardado.
js/scene.js, js/fx.js, js/audio.js, js/fit.jsEscena 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 };
AjusteSignificado
hintsPerLevelPistas gratis en cada nivel. 0 significa ilimitadas.
rewardedAdnull, 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.
debugtrue 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ácterSignificado
#Bloque (suelo y paredes)
.Vacío
oFruta
XPortal (uno por nivel)
^Pinchos
_Botón de presión (un bloque con un botón encima)
DPuerta, abierta por el botón
  • snake enumera 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.
  • world va de 1 a 4 y elige el arte, la música y dónde aparece el nivel. dark: true crea una sala oscura.
  • El id debe 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.

Modo debug (?debug): el botón rosa reproduce la solución y los pasos aparecen abajo.
Modo debug (?debug): el botón rosa reproduce la solución y los pasos aparecen abajo.

?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.

  1. Instala Node.js 18 o más reciente desde nodejs.org.
  2. Abre una terminal en la carpeta source/.
  3. Usa los comandos de abajo.
ComandoQué hace
npm startServidor local en http://localhost:5317/ (algunos navegadores bloquean el sonido y el guardado en file://).
npm testEjecuta las pruebas de reglas y resuelve todos los niveles.
npm run solveLo mismo, y escribe js/levels-sol.js.
npm run answersReconstruye 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:

NombreSignificado
fase, fasesnivel, niveles
frutafruta
bloco, bloco-pedrabloque, bloque de piedra
espinhospinchos
botao, portabotón de presión, puerta
portal-fechado, portal-abertoportal cerrado, portal abierto
gomo, cabecatrozo del cuerpo, cabeza
lanterna-bloco, pedestal, borlafarolito soltado, su soporte, borla de la cola
fundo-w1, fundo-p1fondo del mundo 1 en horizontal, en vertical
ilha-baseparte 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 solve y copia levels-sol.js otra vez.
  • ¿Puedo quitar un idioma? Sí: borra su línea de LUMI_LANGS al final de js/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/).