Tkinter Pet: Mascota Virtual de Escritorio

Una aplicación de escritorio autocontenida que simula una mascota virtual con temática de la Matrix. Cuida de tu entidad digital, gestiona su Hambre y Felicidad, e interactúa con ella a través de una interfaz gráfica simple e intuitiva.

---

Demostración

---

Acerca del Proyecto

Tkinter Pet es una mascota virtual de escritorio construida con Python y su librería gráfica estándar, tkinter. El proyecto sirve como una demostración de cómo crear una aplicación de GUI completa, manejar assets (imágenes y sonidos), crear animaciones y empaquetarla en un único archivo ejecutable (.exe) para una fácil distribución en Windows.

Características

• Interfaz Gráfica Intuitiva: Construida con tkinter, es simple, limpia y fácil de usar.
• Mascotas Aleatorias: Cada vez que se inicia el juego, se elige al azar un personaje (Neo, Trinity, etc.) con su propio set de imágenes.
• Animaciones GIF: Las acciones clave, como "Alimentar", se visualizan con animaciones GIF para una experiencia más dinámica.
• Retroalimentación de Audio: Efectos de sonido para acciones exitosas, errores y eventos del juego.
• Lógica de Juego por Inactividad: El estado de la mascota se deteriora si el jugador no interactúa, creando una jugabilidad atractiva.
• Distribución Sencilla: Empaquetado con PyInstaller en un único archivo .exe que no requiere instalación ni dependencias externas para el usuario final.

---

Instalación y Uso (Para Usuarios Finales)

1. Ve a la sección de Releases de este repositorio.
2. Descarga el archivo TkinterPet.exe de la última versión.
3. ¡Haz doble clic en el archivo para jugar! No se necesita instalación.

---

Guía para Desarrolladores

Si deseas modificar o contribuir al proyecto, sigue estos pasos.

Requisitos

• Python 3.8+
• Git

Configuración del Entorno

1. Clona el repositorio:

   git clone https://github.com/francoBa/tkinter-pet.git
   cd tkinter-pet

2. Crea y activa un entorno virtual:

   # En Windows
   python -m venv env
   .\env\Scripts\activate

3. Instala las dependencias de desarrollo:

   pip install -r requirements.txt

Ejecutar en Modo de Desarrollo

Para probar la aplicación sin empaquetarla, ejecuta:

python app.py

Empaquetar para Distribución

El proyecto usa PyInstaller para crear un archivo .exe para Windows. Asegúrate de tener un icono: Coloca un archivo icon.ico en la raíz del proyecto. Ejecuta el comando de PyInstaller:

pyinstaller --name "TkinterPet" --onefile --windowed --add-data "assets;assets" --icon="icon.ico" app.py

El ejecutable final se encontrará en la carpeta dist/.

Licencia

Distribuido bajo la Licencia MIT. Ver el archivo LICENSE para más información.