Amazona Verse
Juego educativo 3D para el navegador, para todas las edades: familias, escuelas y curiosos de la naturaleza. Lo protagoniza Vittata, la cotorra puertorriqueña.
Capítulo 1 jugable: "El día que el cielo se rompió" (guion de Kelvin García). Ciencias alineadas al DEPR 2022 y NGSS, sin cuentas ni anuncios.
Jugar: https://amazona-verse.vercel.app (landing) · https://amazona-verse.vercel.app/juego/ (juego)
Estado: versión 25. Qué falta y fechas estimadas: ROADMAP.md.
Cómo correrlo
Hace falta un servidor local: abrir index.html con doble clic no carga los modelos.
python3 -m http.server 8765
Después abre http://localhost:8765 en el navegador.
Controles
- Escritorio:
- WASD o flechas: moverse.
- Espacio: saltar y volar (mantener para planear).
- V: aterrizar.
- E o Enter: acción.
- Q/R o arrastrar el ratón: girar la cámara.
- Esc: cancelar.
- Móvil: joystick a la izquierda, botones de vuelo y acción a la derecha; arrastrar la pantalla gira la cámara.
#fps al final de la URL muestra un panel de rendimiento: FPS, llamadas de dibujo y memoria.
Build y pruebas
tools/build/build.sh HEAD
tools/build/test.sh tools/build/salida/<ref>/ --extra
build.sh exporta un commit sin tocar la copia de trabajo y deja site/ listo para publicar, con su manifiesto. Comprime con meshopt y WebP y valida las referencias.test.sh levanta la build y corre las 13 baterías: selfTest, missionTest, accessoryTest, templateTest, eduTest, maestroTest, criaderoTest, movementTest, saveTest, comicTest, e2eTest, contextTest y streamingTest. También mide la carga inicial; el presupuesto es ≤ 8 MB.- Más detalle en
docs/equipo/BUILD.md. Las baterías también se pueden correr a mano desde la consola, por ejemplo await AV.selfTest().
Aula
Menú de pausa → Aula:
- Idioma de la lección en ES/EN.
- Texto corto.
- Lectura en voz alta.
Al pie, Docentes abre el Modo Maestro, protegido con una suma (no hay cuentas). Incluye:
- Guía de 45 minutos.
- Progreso de este dispositivo.
- Paradas de aprendizaje.
- Criadero.
- Reporte en CSV o JSON, sin datos personales.
Arquitectura
- Motor:
src/engine y src/game, con el personaje en src/personaje.
- Contenido:
content/cap1, más los datos comunes en content/comun (huevos y especies) y una plantilla en content/plantilla (index.html?pack=plantilla).
- Landing:
web/ (página del producto).
- Sitio publicable:
sitio/ (landing en la raíz + juego en /juego/), generado con tools/build/sitio.sh <build>/site. Vercel publica main con Root Directory sitio.
- Herramientas: de Blender, build y video en
tools/.
- Capas, contratos y cómo hacer un fork:
docs/ARQUITECTURA.md.
Licencias
- Código y contenido: © Kelvin García / Amazona Verse.
- Three.js (MIT) y meshoptimizer (MIT).
- Fuentes: Fredoka y Atkinson Hyperlegible (OFL).
- Edificios: derivados de kits de KitBash3D, usados bajo la licencia de Kelvin. Cada recurso de terceros conserva su propia licencia.
