🎮 LIM - Juego de Matemáticas Interactivo

Un juego educativo de matemáticas desarrollado en Python que ofrece diferentes modos de juego para practicar operaciones aritméticas básicas de forma divertida e interactiva.

📋 Descripción

LIM es un juego de matemáticas con interfaz de consola colorida que permite a los usuarios mejorar sus habilidades matemáticas a través de tres modos de juego diferentes. El sistema incluye registro de usuarios, niveles de dificultad, sistema de puntos y rankings.

✨ Características

• 🎯 Sistema de usuarios: Registro, login y seguimiento de progreso individual
• 🏆 Sistema de puntos y rankings: Acumula puntos y sube de rango
• 🎲 Tres modos de juego diferentes:
  • 🏇 Carrera de Caballos
  • ⚔️ Batalla de Operaciones (1v1)
  • 🧠 Misión Matemática
• 🧮 Cuatro tipos de operaciones:
  • ➕ Suma
  • ➖ Resta
  • ✖️ Multiplicación
  • ➗ División
• 📊 Tres niveles de dificultad:
  • 🟢 Fácil
  • 🟡 Medio
  • 🔴 Difícil
• 🎨 Interfaz colorida usando Rich Console
• ⏱️ Desafíos con tiempo límite

🎮 Modos de Juego

🏇 Carrera de Caballos

• Tiempo límite: 30 segundos
• Objetivo: Responde correctamente las operaciones para que el caballo avance
• Meta: Completa el 100% antes de que acabe el tiempo
• Recompensa: 10 puntos si completas la carrera

⚔️ Batalla de Operaciones (1v1)

• Modo: Dos jugadores
• Desafío: 10 ejercicios matemáticos
• Objetivo: Resolver en el menor tiempo posible con la mayor precisión
• Criterios de victoria: Más respuestas correctas + menor tiempo
• Recompensa: Hasta 10 puntos para el ganador
• Penalización: -5 puntos para el perdedor

🧠 Misión Matemática

• Tiempo límite: 25 segundos
• Objetivo: Responde la mayor cantidad de preguntas correctamente
• Recompensa: Hasta 20 puntos

🛠️ Requisitos

Dependencias

python >= 3.7
keyboard
tqdm
rich
msvcrt (incluido en Windows)

📦 Instalación

Opción 1: Ejecutable (.exe)

El juego incluye un archivo ejecutable listo para usar:

1. Descarga o clona el repositorio completo
2. Localiza el archivo LIM.exe en la carpeta del proyecto
3. Haz doble clic en LIM.exe para iniciar el juego

⚠️ IMPORTANTE:

• NO muevas el archivo LIM.exe fuera de su carpeta
• El ejecutable debe permanecer en el directorio del proyecto para acceder a las carpetas Datos_juego/ y texto/
• Si mueves el .exe, el juego no podrá leer los archivos de configuración y datos

Opción 2: Ejecución desde Python

1. Clona o descarga el repositorio:

git clone <url-del-repositorio>
cd LlM

2. Instala las dependencias:

pip install keyboard tqdm rich

3. Ejecuta el juego:

python LIM.py

🎯 Cómo Jugar

1. Inicia el juego haciendo doble clic en LIM.exe o ejecutando python LIM.py
2. Regístrate o inicia sesión con tu usuario
3. Selecciona un modo de juego desde el menú principal
4. Elige una operación matemática (suma, resta, multiplicación o división)
5. Selecciona el nivel de dificultad (fácil, medio o difícil)
6. ¡Juega y acumula puntos!

📁 Estructura del Proyecto

LlM/
├── LIM.py                      # Archivo principal del juego
├── LIM.exe                     # Ejecutable del juego
├── LIM.spec                    # Especificación para PyInstaller
├── README.md                   # Este archivo
├── Datos_juego/                # Datos persistentes del juego
│   ├── Usuarios.txt            # Base de datos de usuarios
│   ├── Claves.txt              # Contraseñas de usuarios
│   ├── Puntos_usuario.txt      # Puntos de cada usuario
│   └── Puntos_partida.txt      # Puntos por partida
└── texto/                      # Archivos de texto para la interfaz
    ├── ayuda.txt               # Instrucciones de juego
    ├── menu.txt                # Menú principal
    ├── logueo.txt              # Pantalla de login
    ├── registro.txt            # Pantalla de registro
    ├── dificultad.txt          # Selector de dificultad
    ├── operaciones_matematicas.txt
    └── Completa/               # Títulos y adornos
       ├── SumaTitulo.txt
       ├── RestaTitulo.txt
       ├── MultiplicacionTitulo.txt
       ├── DivisionTitulo.txt
       └── adornos.txt

🎖️ Sistema de Puntos

• Carrera de Caballos: 10 puntos (si completas)
• Batalla de Operaciones: Hasta 10 puntos (ganador) / -5 puntos (perdedor)
• Misión Matemática: Hasta 20 puntos

🔧 Compilación a Ejecutable

El proyecto incluye un archivo .spec para compilar con PyInstaller:

pyinstaller LIM.spec

Esto generará un ejecutable en la carpeta dist/.

💡 Características Técnicas

• Interfaz colorida usando la biblioteca Rich
• Barras de progreso con tqdm
• Temporizadores con threading
• Validación de entrada de usuario
• Sistema de persistencia de datos en archivos de texto
• Generación de números aleatorios para ejercicios

🤝 Contribuciones

Las contribuciones son bienvenidas. Si deseas mejorar el juego:

1. Haz un fork del proyecto
2. Crea una rama para tu feature (git checkout -b feature/NuevaCaracteristica)
3. Commit tus cambios (git commit -m 'Agrega nueva característica')
4. Push a la rama (git push origin feature/NuevaCaracteristica)
5. Abre un Pull Request

📝 Notas

• El juego está diseñado para Windows (utiliza msvcrt y comandos de sistema específicos)
• Los datos de usuario se almacenan en archivos de texto plano en la carpeta Datos_juego/
• Se recomienda tener permisos de escritura en el directorio del juego

🎓 Propósito Educativo

Este juego fue diseñado como una herramienta educativa para ayudar a estudiantes a practicar operaciones matemáticas básicas de una manera divertida e interactiva, promoviendo el aprendizaje a través del juego.