Add Brain Training Game - Interactive Application to Combat Boredom and Improve Cognitive Skills

.gitignore

@@ -0,0 +1,39 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Temporary files
+/tmp/
+*.tmp

GAME_EXAMPLES.md

@@ -0,0 +1,223 @@
+# Brain Training Game - Visual Showcase
+
+This document shows examples of what each game looks like when playing.
+
+## Main Menu
+
+```
+╔════════════════════════════════════════════════════════╗
+║       🧠 BRAIN TRAINING GAME - Challenge Yourself! 🧠   ║
+╚════════════════════════════════════════════════════════╝
+
+⭐ Erase Boredom ⭐ Have Fun ⭐ Boost Your IQ ⭐
+
+
+🎮 SELECT YOUR GAME:
+
+1. 🔢 Number Memory Challenge
+2. 🧮 Math Challenge
+3. 🎨 Color Pattern Matching
+4. 📝 Word Scramble
+5. ⚡ Reaction Time Challenge
+6. 🚪 Exit
+
+Enter your choice (1-6): _
+```
+
+## Game 1: Number Memory Challenge 🔢
+
+**Level 1:**
+```
+🔢 NUMBER MEMORY CHALLENGE 🔢
+==================================================
+Memorize the number sequence and type it back!
+The sequence gets longer with each level.
+
+📊 Level 1 - Memorize this sequence:
+
+3 7 2 9
+
+(Screen clears after 2 seconds)
+
+??????????????????????????????????????????????????
+Now type the sequence you just saw!
+
+Your answer: 3729
+
+✅ CORRECT! +10 points!
+💯 Current Score: 10
+```
+
+**Level 5 (harder):**
+```
+📊 Level 5 - Memorize this sequence:
+
+4 8 1 9 2 7 3
+
+(Screen clears after 4.5 seconds)
+```
+
+## Game 2: Math Challenge 🧮
+
+```
+🧮 MATH CHALLENGE 🧮
+==================================================
+Solve as many math problems as you can!
+You have 30 seconds!
+
+Press Enter to start...
+
+⏰ Time remaining: 28s
+What is 7 + 9?
+Your answer: 16
+✅ Correct! +10 points
+
+⏰ Time remaining: 25s
+What is 15 - 8?
+Your answer: 7
+✅ Correct! +10 points
+
+⏰ Time remaining: 23s
+What is 6 * 4?
+Your answer: 24
+✅ Correct! +10 points
+
+⏰ TIME'S UP!
+
+🏆 Final Score: 120 points!
+📝 Questions Answered: 12
+🎯 Accuracy: 100.0%
+```
+
+## Game 3: Color Pattern Matching 🎨
+
+```
+🎨 COLOR PATTERN MATCHING 🎨
+==================================================
+Watch the color pattern and repeat it!
+Colors: R=Red, G=Green, B=Blue, Y=Yellow
+
+📊 Level 1 - Watch this pattern:
+  🔴 Red
+  🟢 Green
+  🔵 Blue
+
+(Pattern disappears after showing)
+
+??????????????????????????????????????????????????
+Now type the pattern! (e.g., RGBY)
+R=Red, G=Green, B=Blue, Y=Yellow
+
+Your answer: RGB
+
+✅ PERFECT! +15 points!
+💯 Current Score: 15
+```
+
+## Game 4: Word Scramble 📝
+
+```
+📝 WORD SCRAMBLE 📝
+==================================================
+Unscramble the words as fast as you can!
+
+🎯 Round 1/5
+Unscramble this: RNBAI
+Your answer: BRAIN
+✅ CORRECT! +48 points (faster = more points)
+💯 Current Score: 48
+
+🎯 Round 2/5
+Unscramble this: PHYTON
+Your answer: PYTHON
+✅ CORRECT! +45 points
+💯 Current Score: 93
+
+🎯 Round 3/5
+Unscramble this: LZZUEP
+Your answer: PUZZLE
+✅ CORRECT! +47 points
+💯 Current Score: 140
+
+...
+
+🏆 Final Score: 227 points!
+🎓 That's 90.8% of maximum possible!
+```
+
+## Game 5: Reaction Time Challenge ⚡
+
+```
+⚡ REACTION TIME CHALLENGE ⚡
+==================================================
+Press Enter as FAST as you can when you see GO!
+But be careful - don't press too early!
+
+Press Enter when ready...
+
+🎯 Round 1/3
+Get ready...
+
+🟢 GO! Press Enter NOW!
+⏱️  Your time: 0.287 seconds
+🚀 Lightning fast!
+
+🎯 Round 2/3
+Get ready...
+
+🟢 GO! Press Enter NOW!
+⏱️  Your time: 0.312 seconds
+⚡ Very quick!
+
+🎯 Round 3/3
+Get ready...
+
+🟢 GO! Press Enter NOW!
+⏱️  Your time: 0.295 seconds
+🚀 Lightning fast!
+
+📊 Average Reaction Time: 0.298 seconds
+🏆 AMAZING! You have superhuman reflexes!
+```
+
+## Game Over Screen
+
+```
+Thanks for playing!
+Keep your brain sharp! 🧠
+
+You completed:
+  ✓ Number Memory Challenge
+  ✓ Math Challenge  
+  ✓ Color Pattern Matching
+  ✓ Word Scramble
+  ✓ Reaction Time Challenge
+
+Come back anytime to challenge yourself!
+```
+
+---
+
+## Features Highlighted in Examples
+
+- **Colorful UI**: Uses emojis and visual elements
+- **Clear Instructions**: Each game explains how to play
+- **Immediate Feedback**: Shows if answers are correct/wrong
+- **Progress Tracking**: Displays current score and level
+- **Encouraging Messages**: Positive reinforcement throughout
+- **Progressive Difficulty**: Games get harder as you advance
+- **Time Pressure**: Some games have time limits for excitement
+- **Variety**: Different types of cognitive challenges
+
+## Why It's Fun and Engaging
+
+1. **Multiple game modes** prevent monotony
+2. **Scoring system** creates motivation to improve
+3. **Visual feedback** makes it satisfying to play
+4. **Progressive difficulty** keeps it challenging
+5. **Quick rounds** allow for short play sessions
+6. **No installation** - just run and play!
+7. **Shareable scores** - compete with friends
+8. **Instant gratification** - immediate results
+
+Perfect for erasing boredom and keeping your mind sharp! 🧠✨

GAME_GUIDE.md

@@ -0,0 +1,114 @@
+# Brain Training Game - Quick Start Guide
+
+## 🎮 How to Play
+
+### Starting the Game
+
+```bash
+python brain_training_game.py
+```
+
+or
+
+```bash
+python3 brain_training_game.py
+```
+
+## 🎯 Game Modes
+
+### 1. Number Memory Challenge 🔢
+- **Goal**: Memorize and repeat number sequences
+- **How to Play**:
+  1. Watch the number sequence displayed on screen
+  2. Wait for the screen to clear
+  3. Type the numbers you remember (with or without spaces)
+  4. Press Enter to submit
+- **Scoring**: 10 × level points per correct answer
+- **Tips**: Focus on grouping numbers (e.g., 3792 as "37" and "92")
+
+### 2. Math Challenge 🧮
+- **Goal**: Solve as many math problems as possible in 30 seconds
+- **How to Play**:
+  1. Press Enter to start the timer
+  2. Solve each problem and enter your answer
+  3. Press Enter to submit
+  4. Continue until time runs out
+- **Scoring**: 10 points per correct answer
+- **Tips**: Speed matters! Don't overthink simple problems
+
+### 3. Color Pattern Matching 🎨
+- **Goal**: Remember and repeat color sequences
+- **How to Play**:
+  1. Watch the color pattern displayed
+  2. Remember the order (R, G, B, Y)
+  3. Type the pattern when prompted
+  4. Press Enter to submit
+- **Scoring**: 15 × level points per correct pattern
+- **Tips**: Create a story or phrase to remember the colors
+
+### 4. Word Scramble 📝
+- **Goal**: Unscramble 5 words as quickly as possible
+- **How to Play**:
+  1. Look at the scrambled word
+  2. Type the unscrambled word
+  3. Press Enter to submit
+- **Scoring**: 50 points maximum per word, reduced by time taken
+- **Tips**: Look for common letter combinations (TH, ER, ING)
+
+### 5. Reaction Time Challenge ⚡
+- **Goal**: Test your reflexes by pressing Enter quickly when prompted
+- **How to Play**:
+  1. Wait for "GO!" to appear
+  2. Press Enter as fast as you can
+  3. Complete 3 rounds
+- **Scoring**: Based on average reaction time
+  - < 0.3s: Lightning fast! 🚀
+  - < 0.5s: Very quick! ⚡
+  - < 0.7s: Good reflexes! 👍
+- **Tips**: Stay focused and don't press too early!
+
+## 🏆 Scoring System
+
+Each game has its own scoring mechanism:
+- **Number Memory**: Score increases with level difficulty
+- **Math Challenge**: Fixed 10 points per correct answer
+- **Pattern Matching**: Score increases with pattern length
+- **Word Scramble**: Bonus points for speed
+- **Reaction Time**: Measured in seconds (lower is better)
+
+## 💡 Training Tips
+
+1. **Practice Regularly**: Play at least once a day to see improvement
+2. **Start Easy**: Begin with games you find easier and work up to harder ones
+3. **Track Progress**: Note your scores and try to beat them
+4. **Stay Focused**: Minimize distractions while playing
+5. **Take Breaks**: Rest between intense sessions
+6. **Mix It Up**: Rotate between different games for balanced brain training
+
+## 🎓 Cognitive Benefits
+
+- **Memory**: Number and pattern games strengthen recall
+- **Speed**: Math and reaction games improve processing speed
+- **Attention**: All games enhance focus and concentration
+- **Problem Solving**: Word scramble develops analytical thinking
+- **Mental Flexibility**: Switching between games improves adaptability
+
+## 🐛 Troubleshooting
+
+### Game doesn't start
+- Make sure Python 3.6+ is installed: `python3 --version`
+- Try running with: `python3 brain_training_game.py`
+
+### Display issues
+- Ensure your terminal supports UTF-8 encoding
+- Try maximizing your terminal window for best experience
+
+### Input not recognized
+- Make sure to press Enter after typing your answer
+- Check that you're using the correct format (numbers, letters, etc.)
+
+## 🎉 Have Fun!
+
+Remember, the goal is to have fun while improving your cognitive skills. Don't stress about scores - improvement comes with practice!
+
+Enjoy your brain training session! 🧠✨