Skip to content

TheNarratorVIMMXX/EduMath

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

38 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

es

๐Ÿš€ EduMath - Educational Math Game

Python Arcade Type Grades License Version

An exciting educational math game with a captivating space theme, designed for elementary school students. Travel through the cosmos solving math problems, earning stars, and becoming a master math astronaut!


๐ŸŽฌ Preview

EduMath Preview

๐Ÿ‘จโ€๐ŸŽ“ Developer Info


๐ŸŽฎ What is EduMath?

EduMath transforms math practice into an exciting space exploration adventure. Designed for students in grades 1 through 6, the game adapts its difficulty to each student's level, making math practice fun and engaging.

๐ŸŒŸ Why this game?

  • Adaptive Learning: Each grade has carefully calibrated difficulty
  • Immediate Feedback: Learn from mistakes instantly with visual and audio cues
  • Motivational Design: Earn stars and achievements to track your progress
  • Attractive Theme: Beautiful space environment with animated characters
  • Educational Focus: Reinforces essential math skills through repetition and practice

๐ŸŽฏ How to Play

Getting Started

  1. Launch the game โ€” Double-click the executable file
  2. Watch the intro โ€” Enjoy the animated welcome screen
  3. Press ENTER โ€” Advance to the grade selection menu
  4. Choose your grade โ€” Click your school grade (1st to 6th)
  5. Start solving โ€” Answer 10 math questions suited to your level

Game Controls

Control Action
Mouse Click Select grade buttons and navigate menus
Number Keys (0-9) Enter your answer (numpad also works)
Minus Key (-) Enter negative numbers
Backspace Delete the last digit
Enter Submit your answer or continue
ESC Exit the game at any time

Understanding the Interface

During the Game

  • Top Left: Your current grade
  • Top Center: Question progress (e.g. "Question 3/10")
  • Progress Bar: Visual representation of your advancement
  • Top Right: Stars earned this session (โญ)
  • Center: The math problem to solve
  • Input Field: Where you type your answer (with blinking cursor)
  • Bottom: Feedback messages and instructions

Results Screen

  • Mission Status: Your astronaut rank based on your performance
  • Star Display: Visual representation of correct answers
  • Statistics: Detailed breakdown of your performance
  • Total Stars: Accumulated stars across all sessions

๐Ÿ“Š Grade Levels & Difficulty

The game adapts to six different levels, each with appropriate challenges:

๐ŸŽ“ 1st Grade (Ages 6โ€“7)

Operations: Addition (+), Subtraction (-)
Number Range: 1โ€“20
Example: 8 + 5 = ??? or 12 - 4 = ???
Focus: Basic number sense and single-digit operations

๐ŸŽ“ 2nd Grade (Ages 7โ€“8)

Operations: Addition (+), Subtraction (-)
Number Range: 10โ€“50
Example: 27 + 18 = ??? or 35 - 12 = ???
Focus: Two-digit operations and mental math

๐ŸŽ“ 3rd Grade (Ages 8โ€“9)

Operations: Addition (+), Subtraction (-), Multiplication (ร—)
Number Range: 10โ€“60
Example: 7 ร— 8 = ??? or 45 - 17 = ???
Focus: Introduction to multiplication tables

๐ŸŽ“ 4th Grade (Ages 9โ€“10)

Operations: Addition (+), Subtraction (-), Multiplication (ร—), Division (รท)
Number Range: 20โ€“100
Example: 48 รท 6 = ??? or 12 ร— 7 = ???
Focus: All four basic operations

๐ŸŽ“ 5th Grade (Ages 10โ€“11)

Operations: All four operations
Number Range: 100โ€“500
Example: 384 + 127 = ??? or 144 รท 12 = ???
Focus: Larger numbers and mental calculation strategies

๐ŸŽ“ 6th Grade (Ages 11โ€“12)

Operations: All four operations
Number Range: 500โ€“1500
Example: 875 - 392 = ??? or 25 ร— 48 = ???
Focus: Advanced calculations and numerical fluency


๐Ÿ† Scoring & Achievements

Star System

  • โญ 1 star for each correct answer
  • 10 stars maximum per session
  • Cumulative tracking across all game sessions

Astronaut Ranks

Score Rank Message
90โ€“100% ๐Ÿš€ Expert Astronaut "EXPERT ASTRONAUT!"
70โ€“89% ๐ŸŒŸ Space Explorer "SPACE EXPLORER!"
50โ€“69% โญ Cadet in Training "CADET IN TRAINING!"
0โ€“49% ๐Ÿ’ช Keep Practicing "KEEP PRACTICING!"

What Happens When You Answer?

โœ… Correct Answer

  • Visual feedback: Green "EXCELLENT!" message with particle burst
  • Audio: Cheerful success sound
  • Robot emotion: Excited and happy
  • Reward: +1 star added to your total
  • Next: Automatic advance to the next question

โŒ Wrong Answer

  • Visual feedback: Red message showing the correct answer
  • Audio: Soft error sound (not annoying)
  • Robot emotion: Sad but encouraging
  • Learning: See the correct answer to understand
  • Next: Advance to next question after reviewing

๐ŸŽจ Game Features

Visual Elements

  • Animated background: Twinkling stars and spinning planets
  • Particle effects: Colorful celebrations on correct answers
  • Gradient interface: Beautiful color transitions throughout
  • Smooth animations: Professional-level movement and transitions
  • Flying rockets: Decorative spacecraft on transitions

Audio Experience

  • Background music: Relaxing space-themed soundtrack (continuous loop)
  • Success sound: Rewarding chime for correct answers
  • Error sound: Soft notification for mistakes
  • Volume: Balanced for comfortable gameplay

Character Interactions

Guide Robot โ€” Your friendly companion throughout the game

  • Happy: Default state, cheering you on
  • Excited: Celebrates your correct answers
  • Sad: Shows empathy when you make mistakes

๐ŸŽฎ Game Flow

GAME START
    โ†“
INTRO SCREEN (Animated title)
    โ†“
PRESS ENTER
    โ†“
GRADE SELECTION MENU (Choose 1st to 6th)
    โ†“
CLICK YOUR GRADE
    โ†“
GAME LOOP (10 questions)
    โ†“
    โ€ข Question is displayed
    โ€ข Type your answer
    โ€ข Press ENTER
    โ€ข Receive feedback
    โ€ข See next question
    โ†“
RESULTS SCREEN
    โ†“
    โ€ข See your rank
    โ€ข Check statistics
    โ€ข Review total stars
    โ€ข Click "BACK TO MAIN MENU"
    โ†“
RETURN TO GRADE SELECTION

๐Ÿ’ก Tips for Parents & Teachers

Maximizing Learning

  • Regular practice: Short 10-minute daily sessions are more effective than long ones
  • Right grade: Always select the correct level for appropriate difficulty
  • Review mistakes: When the game shows the correct answer, discuss it with the student
  • Celebrate progress: Use the star system to track improvement over time
  • No pressure: The game is designed to be encouraging, not stressful

Educational Benefits

โœ… Mental math skills: Quick calculation practice
โœ… Number sense: Understanding relationships between numbers
โœ… Operation fluency: Mastery of +, -, ร—, รท
โœ… Error learning: Immediate correction and explanation
โœ… Progress tracking: Visual motivation through stars and ranks
โœ… Self-paced: Students control their own learning speed


๐Ÿ“ฅ Installation & System Requirements

Running the Game

  1. Download the executable (.exe) from Releases
  2. Double-click to launch
  3. No installation required โ€” runs directly

System Requirements

Component Requirement
OS Windows 10 / 11
RAM 2 GB minimum
Display 1000ร—700 minimum resolution
Audio Speakers or headphones recommended
Storage ~30 MB free space

Troubleshooting

  • Won't start? Right-click โ†’ Run as administrator
  • No sound? Check volume mixer and system audio
  • Blurry screen? Make sure resolution is at least 1000ร—700
  • Crashes unexpectedly? Restart and try again; contact the developer if it persists

๐ŸŒ Language Note

The game interface is currently in Spanish. Math operations are universal, but feedback messages and instructions appear in Spanish.


๐Ÿ”ฎ Coming Soon

Future updates may include:

  • Multi-language support (English, French, etc.)
  • Difficulty customization within each grade
  • Timed challenge mode
  • Two-player competition mode
  • Extended question sets (20, 50 questions)
  • Sound on/off toggle
  • Save and load progress between sessions
  • Printable progress reports

๐Ÿ“ž Support & Feedback

Developer: Carlos Gabriel Magallanes Lรณpez
Email: cgmagallanes23@gmail.com

Found a bug? Have a suggestion? Want to share your high score? Feel free to reach out!


๐Ÿ“œ License & Credits

License: Proprietary โ€” Strictly for personal and educational use
Copyright: ยฉ 2025 Carlos Gabriel Magallanes Lรณpez โ€” All rights reserved

โš ๏ธ Important: This software is proprietary. You may download and use the executable for personal or educational purposes only. Redistribution, modification, reverse engineering, or commercial use are strictly prohibited without written authorization.

For licensing or commercial inquiries: cgmagallanes23@gmail.com

Credits: Developed with the Python Arcade library
Purpose: Math education for elementary school students

๐Ÿ“‹ See the LICENSE file for full terms and conditions.


๐ŸŒŸ Download EduMath and start your journey to becoming a master math astronaut! ๐Ÿš€

Ideal for:

  • Elementary school students (Grades 1โ€“6)
  • Homeschooling parents
  • Classroom teachers
  • Math tutors
  • After-school programs

Turn math into an adventure! โญ

About

Educational math game for children (grades 1-6) with a space theme. Includes interactive gameplay, adjustable difficulty levels, and engaging animations.

Topics

Resources

License

Stars

Watchers

Forks

Contributors