MATH RUNNER

📖 Description

👨‍💻 Source Code & More Projects: https://github.com/Kynmmarshall

Math Runner is a fast-paced 2D educational adventure game built with Python (Pygame), where fun gameplay meets brainpower.

Run, jump, and dodge obstacles while solving dynamic math questions that stand between you and victory. Correct answers let you progress and defeat enemies, while mistakes cost you valuable lives.

What makes Math Runner unique is its innovation in adaptive learning:

• 🎭 Face Emotion Detection – The game uses real-time emotion tracking to adjust difficulty and provide hints when frustration is detected.

• 🎯 Adaptive Difficulty – Struggling with tough equations? The game automatically adjusts the level to match your pace, then ramps up again as your confidence grows.

• 💡 Smart Hint System – Hints appear when you need them most, keeping learning supportive rather than punishing.

With engaging visuals, background music, and exciting gameplay mechanics, Math Runner makes math both challenging and fun.

Whether you’re a student brushing up on your skills or just a casual gamer looking for something new, Math Runner offers an educational adventure like no other.

✨ Features

• 🏃‍♂️ Runner-style gameplay with jumping, dodging, and enemy encounters.

• 🧮 Math questions dynamically generated based on difficulty level.

• 🎶 Background music and sound effects for immersive gameplay.

• ❤️ Lives and scoring system to keep you engaged.

• 📊 High score tracking to challenge yourself every run.

• 🎭 Emotion detection (via webcam) to adapt questions and difficulty in real-time.

• 💡 Hint system triggered when frustration is detected.

• 🎮 Simple keyboard controls:

  • W → Jump

  • A / D → Move left / right

  • S → Crouch

  • P → Pause / Resume

  • ESC → Quit

🖥️ System Requirements

Minimum:

• OS: Windows 10 / 11

• Processor: Intel i3 or equivalent

• Memory: 4 GB RAM

• Graphics: Integrated graphics

• Storage: 500 MB available space

Recommended:

• OS: Windows 10 / 11

• Processor: Intel i5 or better

• Memory: 8 GB RAM

• Graphics: Dedicated GPU for smoother performance

• Webcam (for emotion detection feature)