🏆 Tablas del Tesoro
Un juego de aventuras para aprenderse de memoria las tablas de multiplicar. Se viaja por un mapa, se resuelve una operación en cada estación y al final del viaje aparece un tesoro.
🌍 Español e inglés • 📱 Apto para tablet • 🔒 Sin anuncios ni rastreo • 📶 Funciona sin conexión (PWA) • 🎮 Aprendizaje con premios
Es un clon (fork) de Math Treasure Quest, creado por AllesSuper. Mil gracias al autor original por el enorme trabajo y por compartirlo con licencia MIT: casi todo lo bueno de este juego viene de su proyecto. 💛
This is a clone (fork) of Math Treasure Quest by AllesSuper. Heartfelt thanks to the original author for the great work and for sharing it under the MIT license.
Qué cambia respecto al original
- Solo español e inglés (el original trae 16 idiomas). El español es el idioma por defecto.
- Se completaron las traducciones al español que faltaban (tienda, elogios, tesoros, insignias).
- Se eliminaron los informes de pruebas en alemán y las capturas del original.
- El proyecto seguirá personalizándose para practicar las tablas de multiplicar.
Todo lo demás se conserva: mapa de aventura, dificultad adaptativa, pistas tras un error, estrellas, rachas, monedas, insignias, 50 tesoros, tienda con potenciadores y acompañantes, modo con temporizador, modo rápido y funcionamiento sin conexión.
👨👩👧 Perfiles y zona de padres
Cada niño tiene su perfil, con sus ajustes, monedas, tesoros y progreso; al abrir el juego se elige en "¿Quién juega?" (desde el menú, con Cambiar jugador). La zona de padres está en esa misma pantalla, con el botón 🔒: pide resolver una multiplicación para entrar. Allí se crean y editan perfiles, se cambian los ajustes de cada niño y se ve el álbum de las 100 operaciones de las tablas. Todo queda guardado solo en el dispositivo.
✨ Características
- 🧠 Modo tablas: se escribe el resultado, aparece una pista con bloques si tarda y cada tabla tiene un personaje que se llena de color
- ➕ Suma, ➖ resta, ✖️ multiplicación (1×1 a 10×10), ➗ división exacta y 🌈 modo mixto
- 🗺️ Mapa de aventura con 25 estaciones (10 en modo rápido)
- 🎯 Dificultad que se adapta a cada operación
- 💡 Pistas amables cuando hay un error
- ⭐ Estrellas, 🔥 rachas, 🪙 monedas, 🎖️ insignias y 💎 un tesoro por viaje
- ⏱️ Temporizador opcional
- 🔒 Sin servidor, sin cuenta, sin anuncios, sin APIs externas; el progreso se guarda solo en el dispositivo
🚀 Cómo ejecutarlo
No necesita compilación ni dependencias. Cualquier servidor estático sirve:
npm start # http://localhost:8080
# o, sin Node:
python3 -m http.server 8080
El service worker (modo sin conexión) requiere http://localhost o HTTPS.
Para instalarlo en una tablet: abrir la dirección en el navegador y elegir Añadir a la pantalla de inicio.
📝 Backlog y hallazgos
Lo que se ha detectado para mejorar (todavía por analizar, no comprometido) está en docs/BACKLOG.md.
🧪 Pruebas
npm test # matemáticas, aprendizaje adaptativo y caché offline
npm run validate # sintaxis y JSON
npm ci && npx playwright install chromium
npm run test:browser # pruebas en navegador real
🗂️ Estructura
index.html # pantallas de la app
styles.css # tema y animaciones
app.js # motor del juego, textos (i18n) y generadores de operaciones
tables.js # motor del modo tablas (dominio por operación y repaso)
characters.js # un personaje y una melodía por tabla
manifest.json # metadatos PWA
service-worker.js # caché sin conexión
tests/ # pruebas
Los textos están en el objeto I18N de app.js (es y en; el inglés es el idioma de respaldo).
📄 Licencia y créditos
Publicado bajo la licencia MIT.
Gracias de nuevo al autor original por su esfuerzo y generosidad.
