Mecanoguay

Pequeños dedos. Grandes misiones. Un arcade espacial para que los niños descubran el teclado, practiquen mecanografía y salven la galaxia en compañía.

Jugar ahora · Jugar a dobles · Instalar en local · Licencia MIT

Sin cuentas ni instalación para jugar. Necesitas un navegador y un teclado físico, preferiblemente español con Ñ. La interfaz se adapta a pantallas pequeñas, pero el juego se controla con teclas, no con la pantalla táctil.

Para empezar a aprender

1. Pulsa APRENDER SIN PRISA. La primera misión empieza con F y J.
2. Busca las rayitas de esas teclas y coloca encima los dedos índices.
3. Mira la letra del marcianito sin escudo. El copiloto ilumina la tecla y te indica qué dedo usar.
4. Completa 24 marcianitos. En esta práctica no pierdes vidas y los enemigos no invaden: puedes equivocarte y volver a intentarlo.
5. Al terminar, mira tu precisión y prueba otra misión. El juego propone hasta cuatro letras con errores registrados para seguir practicando.

El objetivo es aprender a encontrar las teclas y acertar. La velocidad puede llegar después. Familias y profes podéis empezar acompañando la búsqueda de F/J y pasar al modo cooperativo cuando apetezca compartir una misión.

Elige tu aventura

Modo	Qué haces	Cómo se aprende
Aprender sin prisa	Una misión de 24 marcianitos, sin perder vidas.	Guía de dedos y práctica basada en errores reales.
Aventura arcade	Defiendes tu nave con cinco vidas.	Empieza en F/J y añade letras al dominar oleadas.
Entrenamientos	Eliges filas, todas las letras, palabras o frases.	Practicas un grupo concreto, sin bloquear niveles.
Dobles: en equipo	Cada piloto completa 24 objetivos a su ritmo.	Ambos deben terminar para ganar juntos.
Dobles: cara a cara	Compites con la persona que elijas.	Cada piloto usa su propio reto de letras.
Duelo online	Entras en una cola pública de dos jugadores.	Carrera competitiva con hándicap entre rivales habituales.

La campaña empieza con F/J y pasa por la fila central, las dos filas y el teclado completo hasta llegar a palabras. La primera etapa necesita cuatro oleadas dominadas; las siguientes, tres. Una oleada requiere al menos un 90 % de precisión, completar 24 objetivos en 36 segundos o menos y practicar todas las letras del nivel, o 24 distintas si hay más de 24. El copiloto mantiene visible ese objetivo. Si prefieres aprender sin presión, vuelve a la práctica tranquila.

Hay más de 300 palabras españolas y diez aventuras cortas en modo karaoke. Las palabras y las frases muestran sus tildes correctas, aunque estos ejercicios aceptan escribir sin tildes ni signos de puntuación. La Ñ sí cuenta como una tecla propia. Es un juego de mecanografía; todavía no practica la escritura de acentos y signos.

Jugar a dobles

1. Abre Mecanoguay en los dos ordenadores y pulsa JUGAR A DOBLES.
2. Elige un apodo. No uses apellidos ni datos personales.
3. Elegid EN EQUIPO para cooperar o CARA A CARA para competir.
4. Usad el mismo código de seis caracteres y la misma modalidad. Cada persona puede escoger letras distintas: por ejemplo, F/J para quien empieza y todas las letras para quien ya sabe.
5. Pulsa ENTRAR EN LA SALA. También puedes copiar la invitación desde la sala de espera y abrirla en el otro ordenador.

En equipo, los errores cuentan para la precisión pero no quitan vidas. Si terminas antes, puedes animar a tu compañero: la victoria llega cuando los dos completáis vuestros 24 marcianitos. La cooperación no modifica el ELO ni la clasificación competitiva.

En cara a cara gana quien completa primero sus 24 objetivos o sigue en pie cuando el rival pierde. Los puntos premian la dificultad y no deciden el ganador. La revancha conserva el código y la pareja mientras ambos permanecen conectados; una tercera persona no puede entrar.

Cada navegador mantiene un piloto anónimo. Para probar con un único ordenador, usa una ventana normal y otra de incógnito. Dos pestañas del mismo perfil representan al mismo piloto. Las salas son temporales; un reinicio del servidor puede interrumpir la partida.

Controles

Tecla o control	Acción
Letra del objetivo	Dispara. En palabras, escribe una letra cada vez.
Espacio	Limpia el goo del parabrisas.
Espacio, en Frases	Separa las palabras.
Enter, en Frases	Limpia el parabrisas.
Escape / Pausa	Pausa una partida individual. Las partidas online continúan.
Ocultar guía	Retira el mapa del teclado cuando ya no lo necesites.
Sonido	Activa o silencia los efectos.

La garra suelta una formación de marcianitos. Al acertar, explotan en goo verde, azul o morado que se pega al cristal. El limpiaparabrisas devuelve la visión. En arcade y duelos competitivos, equivocarse cuesta una vida y la formación puede llegar hasta la nave.

Progreso y datos

La campaña, las estadísticas por tecla, la preferencia de sonido y los récords personales se guardan en este navegador. La práctica tiene sus propios récords y no sube por sí sola el nivel de campaña.

Para jugar online, el navegador guarda un identificador y un token anónimos. El servidor conserva el apodo, el reto elegido y los resultados competitivos necesarios para ELO, hándicap y clasificación diaria. Borrar los datos del navegador crea un piloto nuevo y elimina el acceso al progreso local anterior.

No hay cuentas, chat ni perfiles públicos. En la cola pública y la clasificación competitiva se muestra el apodo del piloto. Los controles ofrecen foco visible; la guía se puede ocultar, el sonido silenciar y los efectos respetan la preferencia de movimiento reducido.

Instalar en local

Necesitas Node.js 22.12 o posterior, npm y un navegador.

git clone https://github.com/DjinnFoundry/mecanoguay.git
cd mecanoguay
npm ci
npm run dev

Abre http://127.0.0.1:5173. Un único proceso sirve tanto el juego como las conexiones de dobles. Para jugar en dos ordenadores de la misma red, abre en ambos la dirección IP del ordenador que ejecuta el servidor, por ejemplo http://192.168.1.20:5173.

Puedes elegir otro puerto con MECANOGUAY_PORT y otra carpeta de datos con MECANOGUAY_DATA_DIR.

Desarrollo y pruebas

TypeScript, Vite y Canvas 2D para el juego; WebSocket para dobles. No necesita una base de datos externa para jugar en local.

npm test                 # Reglas, aprendizaje, salas, protocolo y almacenamiento
npm run typecheck        # Comprobar TypeScript
npm run build            # Compilar la versión de producción
npm run test:e2e          # Flujos reales en Chrome, incluidos dos pilotos

Las pruebas de navegador necesitan Google Chrome instalado. Si no lo tienes, puedes instalarlo para Playwright con npx playwright install chrome. Las pruebas levantan su propio servidor y usan datos de prueba separados.

Para servir la versión compilada con dobles, ejecuta npm start. npm run preview solo sirve los archivos estáticos y no incluye el servidor WebSocket.

Archivo o carpeta	Responsabilidad
src/game/	Motor, niveles, contenido y aprendizaje.
src/duel/	Salas, partidas cooperativas, reglas competitivas y protocolo.
src/app.ts	Conecta los controles, el juego y las partidas online.
src/ui.ts, src/coach.ts	Pantallas y copiloto de teclado.
server.ts	Servidor local y persistencia JSON.
worker.ts	Cloudflare Worker y Durable Object con SQLite.
e2e/	Pruebas de navegador.

Publicar tu propia versión

La web usa Cloudflare Workers, Static Assets y un Durable Object con jurisdicción europea. wrangler.jsonc contiene la configuración del proyecto, incluida la ruta de la web oficial.

Si haces un fork, cambia el nombre del Worker y el dominio en wrangler.jsonc por los tuyos. Identifícate en Cloudflare y selecciona tu cuenta:

npx wrangler login
export CLOUDFLARE_ACCOUNT_ID="tu_account_id"
npm run dev:cloudflare
npm run deploy

El Worker conserva los datos competitivos en SQLite. Las salas y partidas activas permanecen en memoria. No subas .env, .dev.vars, credenciales ni datos de jugadores al repositorio.

Contribuir

Se agradecen mejoras que ayuden a encontrar las teclas, hagan los mensajes más comprensibles o faciliten jugar juntos. Abre una issue con lo que esperabas y lo que ocurrió. Para cambios de código, incluye una prueba cuando cambies reglas y comprueba los flujos de teclado.

Si añades capturas, usa apodos inventados y evita mostrar datos personales de menores.

Licencia y créditos

Creado por DjinnFoundry para aprender jugando. Puedes usar, estudiar, modificar y compartir el código bajo la licencia MIT, también en casa o en el aula.

Las tipografías Press Start 2P y Atkinson Hyperlegible mantienen sus licencias SIL OFL. Las aventuras del catálogo están identificadas como textos originales CC0. Consulta los créditos y avisos de terceros.