Mathopolis: Build & Brighten!
# ๐๏ธ Mathopolis - Build Your Dream City with Math!
*An engaging educational game where math skills build magnificent cities!*
## ๐ About Mathopolis
Welcome to **Mathopolis** - where mathematics meets creativity! This innovative educational game transforms learning math into an exciting city-building adventure. Solve math problems to earn blocks, then use those blocks to construct your dream metropolis!
Perfect for students, educators, and anyone who wants to sharpen their math skills while having fun.
## โจ Features
### ๐งฎ **Progressive Math Learning**
- **5 Difficulty Levels**: From Beginner to Expert
- **Multiple Operations**: Addition, Subtraction, Multiplication, Division
- **Adaptive Difficulty**: Problems scale with your progress
- **Real-time Feedback**: Instant validation and encouragement
### ๐๏ธ **Creative City Building**
- **Drag & Drop Interface**: Intuitive block placement
- **Special Blocks**: Rainbow ๐, Gold โญ, Diamond ๐ blocks with bonus points
- **Building Templates**: Pre-designed structures for quick building
- **Undo System**: Mistake-friendly with 7-step history
### ๐จ **Immersive Experience**
- **Day/Night Cycle**: Dynamic environment changes
- **Sound Effects**: Engaging audio feedback
- **Celebration Animations**: Confetti rewards for correct answers
- **Character Unlocks**: Meet the Math Wizard ๐ง, Block Robot ๐ค, and Rainbow Unicorn ๐ฆ
### ๐ **Progress Tracking**
- **Visual Progress Bar**: See your city grow
- **Achievement System**: Unlock characters as you advance
- **Block Economy**: Earn and spend blocks strategically
## ๐ฎ How to Play
1. **Solve Math Problems**: Answer equations to earn blocks
2. **Collect Blocks**: Different problems give different amounts of blocks
3. **Build Your City**: Drag blocks to the building area
4. **Unlock Characters**: Reach milestones to unlock helpful friends
5. **Level Up**: Progress through 5 difficulty levels
6. **Create & Explore**: Build your unique mathematical metropolis!
### ๐ฏ Game Progression
| Level | Operations | Max Numbers | Special Features |
|-------|------------|-------------|------------------|
| ๐ข Beginner | Addition | 1-5 | Basic blocks |
| ๐ต Easy | +, - | 1-10 | More special blocks |
| ๐ก Medium | +, - | 1-15 | Enhanced rewards |
| ๐ Hard | +, -, ร | 1-20 | Multiplication introduced |
| ๐ด Expert | +, -, ร, รท | 1-30 | All operations unlocked |
## ๐ Getting Started
### Option 1: Play Online
Simply open `index.html` in your web browser - no installation required!
### Option 2: Local Development
```bash
# Clone the repository
git clone https://github.com/llakterian/mathopolis.git
# Navigate to the project directory
cd mathopolis
# Open in your browser
# Simply double-click index.html or serve with a local server
```
### Option 3: Live Server (Recommended for Development)
```bash
# If you have Python installed
python -m http.server 8000
# Or with Node.js
npx serve .
```
Then visit `http://localhost:8000` in your browser.
## ๐ ๏ธ Technology Stack
- **Frontend**: Vanilla JavaScript, HTML5, CSS3
- **Graphics**: CSS animations and transitions
- **Audio**: HTML5 Audio API
- **Responsive Design**: Mobile-friendly interface
- **No Dependencies**: Pure web technologies for maximum compatibility
## ๐จ Game Screenshots
*Building your mathematical metropolis:*
- Colorful blocks representing different math achievements
- Interactive drag-and-drop city building
- Progressive difficulty with visual feedback
- Character unlocks and celebrations
## ๐ฏ Educational Benefits
- **Mental Math Skills**: Rapid calculation improvement
- **Problem Solving**: Strategic thinking for city planning
- **Visual Learning**: Spatial reasoning through building
- **Motivation**: Gamified learning keeps students engaged
- **Self-Paced**: Learn at your own comfortable speed
## ๐ค Contributing
We welcome contributions! Here's how you can help:
1. ๐ด Fork the repository
2. ๐ Create a feature branch (`git checkout -b feature/amazing-feature`)
3. ๐พ Commit your changes (`git commit -m 'Add amazing feature'`)
4. ๐ค Push to the branch (`git push origin feature/amazing-feature`)
5. ๐ Open a Pull Request
### Ideas for Contributions:
- New building templates
- Additional math operations
- More character unlocks
- Sound improvements
- Mobile optimizations
- Accessibility features
## ๐ License
This project is open source and available under the [MIT License](LICENSE).
## ๐จโ๐ป Creator
**Made with โค๏ธ by [@llakterian](https://github.com/llakterian)**
### ๐ง Contact & Support
- **Email**: llakterian@gmail.com
- **GitHub**: [@llakterian](https://github.com/llakterian)
- **Issues**: [Report bugs or request features](https://github.com/llakterian/mathopolis/issues)
---
<div align="center">
### ๐ If you enjoyed Mathopolis, please give it a star! โญ
**Happy Building! ๐๏ธโจ**
*Transform your math skills, one block at a time.*
</div>
```
## 4. Additional files you might want to create:
```bash
echo "node_modules/
*.log
.DS_Store
*.zip
.env" > .gitignore
```
## 5. Final steps:
After creating the README.md file, add it to your repository:
```bash
git add README.md .gitignore
```
```bash
git commit -m "Add comprehensive README.md and .gitignore"
```
```bash
git push origin main
Updated | 10 hours ago |
Published | 13 days ago |
Status | Released |
Platforms | HTML5 |
Release date | 13 days ago |
Author | Llakterian |
Genre | Educational |
Tags | 2D, browser, city-building, Family Friendly, genre-educational, html5, kids, learning, Math, puzzle-tags-educational |
Average session | A few seconds |
Languages | English |
Inputs | Keyboard, Mouse, Xbox controller, Gamepad (any), Touchscreen, Smartphone |
Accessibility | Interactive tutorial |