ViperPet 🐍💻

Una mascota virtual estilo Tamagotchi diseñada específicamente para el M5Stack Cardputer ADV.

(Puedes agregar un screenshot aquí luego)

✨ Características (v0.3)

• Evoluciones Visuales: Tu mascota crecerá desde un Huevo (Egg) hasta convertirse en Adulto (Adult) pasando por Baby y Young, cambiando su apariencia conforme sube de nivel.
• Minijuego Integrado: Pon a prueba tus reflejos con el teclado del Cardputer para ganar felicidad extra.
• Sistema de Decaimiento Offline: El tiempo real cuenta. Tu mascota sentirá hambre y perderá energía mientras el Cardputer esté apagado (limitado para que no muera inmediatamente).
• Racha de Cuidados (Care Streak): Mantén los stats de tu mascota saludables al encender el dispositivo para aumentar tu multiplicador de racha (🔥).
• Comida Variada: Diferentes alimentos con impactos distintos en Hambre, Energía, Felicidad y Salud.
• Simulación de Sueño Realista: Pon a tu mascota a dormir y la pantalla disminuirá su brillo, ahorrando batería y recuperando energía.
• Sonidos Non-Blocking: Melodías y beeps que no bloquean la interfaz. (Opción de Silenciar en Configuración).
• Auto-guardado: Progreso asegurado en memoria interna (NVS) con validación por Checksum.

🎮 Controles (Teclado del Cardputer)

En la pantalla principal:

• F = Abrir Menú de Comida (Feed)
• P = Jugar Minijuego (Play)
• S = Dormir/Despertar (Sleep)
• I = Pantalla de Estadísticas (Info)
• M = Menú de Sistema (Guardar, Reset, Configuración)

En los menús (Comida, Configuración, Sistema):

• ; (Arriba) / . (Abajo) = Navegar por las opciones
• Enter = Seleccionar / Confirmar
• B = Volver Atrás (Back)

🚀 Instalación y Uso

Opción 1: Usar M5Launcher (Recomendado)

Si tienes M5Launcher instalado en tu Cardputer (para poder tener múltiples apps en la tarjeta SD):

1. Descarga el archivo firmware.bin desde la sección de Releases de este repositorio.
2. Cópialo en la raíz de la tarjeta MicroSD de tu Cardputer (o dentro de una carpeta si lo prefieres).
3. Inserta la SD, enciende el Cardputer, navega con M5Launcher y ejecuta firmware.bin.

Opción 2: Compilar desde Código Fuente (PlatformIO)

Si eres desarrollador y quieres modificar el código:

1. Instala Visual Studio Code y la extensión de PlatformIO.
2. Clona este repositorio:

   git clone https://github.com/TuUsuario/ViperPet.git

3. Abre la carpeta del proyecto en VSCode. PlatformIO instalará automáticamente las dependencias (M5Cardputer, M5GFX, M5Unified).
4. Conecta tu Cardputer por USB.
5. Haz clic en el botón de Upload (flecha a la derecha) en la barra inferior de PlatformIO.

📦 Exportar el archivo .bin para compartir

Si modificas el código y compilas mediante PlatformIO, puedes encontrar el binario generado en la siguiente ruta de tu proyecto: .pio/build/m5stack-cardputer/firmware.bin ¡Este es el archivo exacto que puedes compartir con tus amigos o en foros para que lo usen con M5Launcher!

📄 Licencia

Este proyecto está bajo la licencia MIT. Siéntete libre de modificarlo, mejorarlo y compartirlo.