EduConquest

🚀 EduConquest is an infinite roguelike game that blends action and learning! Battle monsters, answer AI-generated quiz questions, and explore multiple terrains—all while improving your knowledge.

Table of Contents

• Inspiration
• Features
• Installation
• How to Play
• Technologies Used
• Challenges & Learnings
• Future Plans
• Contributing
• License

Inspiration

We all have younger siblings who spend hours on short-form content like Reels and TikTok. That inspired us to create a game where learning happens while playing—an engaging way to make education fun!

Features

• 🎮 Roguelike combat – Play as a knight and battle different monsters.
• 🧠 AI-powered quiz system – Answer dynamically generated questions based on topics you choose.
• 🧚 Companion fairy – Get hints and explanations when you struggle.
• ❤️ Healing items – Restore HP by collecting potions.
• 🌍 Multiple terrains – Explore different environments as you progress.
• 🔁 Infinite gameplay – Keep going as long as you survive!

Installation

Prerequisites: Make sure you have Python 3.x installed. You’ll also need pip to install dependencies.

1. Clone the repository:

   git clone https://github.com/yourusername/EduConquest.git
   cd EduConquest

2. Install dependencies:

   pip install -r requirements.txt

3. Run the game:

   python game.py

How to Play

1. Choose a topic for your quiz questions.
2. Move your knight using the arrow keys or WASD.
3. When you encounter a monster, answer a quiz question to attack!
   • ✅ Correct = You damage the monster.
   • ❌ Wrong = You lose HP but get an explanation.
   • 💡 Need help? Ask your fairy companion for a hint!
4. Collect potions to heal when your HP is low.
5. Defeat all monsters to advance to the next level!

Technologies Used

• Python – Core game logic
• Pygame – Game development
• Cohere API – AI-generated quiz questions

Challenges & Learnings

• AI fine-tuning – Optimizing question prompts for accuracy and speed.
• Game balancing – Making combat engaging yet educational.
• Time management – Pacing ourselves during a 36-hour hackathon.

Future Plans

🔹 More items with unique effects
🔹 New enemy types with special abilities
🔹 Scalable difficulty for both combat & quizzes

Contributing

Want to contribute? Feel free to submit a pull request! We welcome new features, optimizations, and bug fixes.

License

This project is licensed under the MIT License.