https://github.com/ornella-gigante/viperx
A fun, colorful, and educational twist on the classic Snake game. Kids collect numbers and solve simple math challenges to grow their snake while learning. Playable in English, with playful music and a simple, beautiful UX designed for children 🐍
https://github.com/ornella-gigante/viperx
android android-app classic edtech edtech-software education java mobile-app snake-game video-game videogames
Last synced: 11 days ago
JSON representation
A fun, colorful, and educational twist on the classic Snake game. Kids collect numbers and solve simple math challenges to grow their snake while learning. Playable in English, with playful music and a simple, beautiful UX designed for children 🐍
- Host: GitHub
- URL: https://github.com/ornella-gigante/viperx
- Owner: Ornella-Gigante
- License: mit
- Created: 2025-07-27T17:22:07.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-08-05T14:49:53.000Z (3 months ago)
- Last Synced: 2025-08-05T16:16:47.360Z (3 months ago)
- Topics: android, android-app, classic, edtech, edtech-software, education, java, mobile-app, snake-game, video-game, videogames
- Language: Java
- Homepage:
- Size: 5.5 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🐍 Maths Snake Adventure 🎲✨
Welcome to **Maths Snake Adventure** — a fun, colorful, and educational Android game that puts a fresh twist on the classic Snake! Guide your snake to collect the right numbers and solve simple math challenges on a bright, easy-to-use board. Perfect for kids learning addition and subtraction, with playful music and a safe, ad-free experience! 🎉🔢
---
## 🚀 Overview
In Maths Snake Adventure, kids navigate a growing snake across a vibrant board, munching numbers that solve math problems. Each correct answer stretches the snake longer and boosts math skills, while wrong moves mean game over! With simple swipe controls and cheerful sounds, learning math has never been this fun.
---
## 🎮 Game Structure
| Screen | Description |
| ------------- | ---------------------------------------------------------- |
| **Main Menu** | Start a new game, view progress, or adjust settings |
| **Gameplay** | Swipe to move your snake, solve math problems, grow longer |
| **Game Over** | See your score and learning progress |
---
## ✨ Core Features
* 🎨 Colorful, child-friendly UI with smooth animations
* 👆 Intuitive swipe controls designed for kids
* ➕ Engaging math challenges (addition & subtraction)
* 🎵 Original music and fun sound effects to keep kids motivated
* 🚫 Completely free from ads and in-app purchases — safe for children
---
## 🎮 How to Play
1. Swipe your finger to guide the snake on the board.
2. Eat the number that correctly answers the math question displayed on top.
3. Avoid incorrect numbers and don’t run into your own tail!
4. The longer your snake grows, the better your score! 🐍✨
---
## 📚 Educational Benefits
* Practice basic addition and subtraction through interactive gameplay.
* Immediate feedback encourages learning and retention.
* Safe, distraction-free environment perfect for young learners.
---
## 🎥 Demo
---
## 🛠️ Technologies Used
* Android Studio (Java/Kotlin)
* Custom `SurfaceView` for smooth game rendering
* Sound and music assets managed via native Android audio APIs
* Lightweight, kid-friendly UX design principles
---
## 🛠️ Getting Started
### Prerequisites
* Android Studio (Electric Eel or newer)
* Minimum SDK 21 (Android 5.0 Lollipop)
### Installation
```bash
git clone https://github.com/yourusername/mathssnakeadventure.git
```
1. Open the project in Android Studio.
2. Click **Run** to build and play on your device or emulator.
---
## 🤝 Contributing
Pull requests are welcome! For major changes, please open an issue first to discuss your ideas.
---
## 📝 License
This project is based on the public domain Snake game mechanic and is released under the MIT License.
---
## 📝 Development Roadmap & Commit History
| Step | Commit Name | Description |
| ---- | --------------------------------- | -------------------------------------------------- |
| 1 | feat: initial project setup | Created project base structure |
| 2 | feat: snake movement logic | Implemented snake movement and rendering |
| 3 | feat: math question system | Added math questions (addition/subtraction) |
| 4 | feat: answer-based food spawning | Only correct answers increase snake length |
| 5 | feat: UI/UX enhancements | Added colors, animations, and kid-friendly buttons |
| 6 | feat: sound and music integration | Added playful music and sound effects |
| 7 | feat: game over & scoring system | Added game over screen and scoring |
| 8 | fix: bug fixes and performance | Optimized performance and fixed bugs |
| 9 | docs: README and license | Added documentation and licensing info |
| 10 | chore: keyword updates | Improved repo discoverability |
---
## 🧩 Main Components Overview
* **MainActivity**
Entry point, manages lifecycle and music playback.
* **GameView**
Custom `SurfaceView` handling rendering, input, logic, and audio.
* **GameThread**
Runs the game loop for smooth animation and updates.
* **Resources**
Background music, sound effects, graphics assets.
* **XML Files**
Configurations, permissions, and string resources.
---
## 🎵 Music & Audio Credits
All background music and sound effects have been properly audited for copyright and licensing compliance:
* **Music by** [u_z8apfbwc3d](https://pixabay.com/users/u_z8apfbwc3d-43565405/?utm_source=link-attribution&utm_medium=referral&utm_campaign=music&utm_content=204327) from [Pixabay](https://pixabay.com/music//?utm_source=link-attribution&utm_medium=referral&utm_campaign=music&utm_content=204327)
* Audio assets are released under a license that allows free use in personal and commercial projects without attribution (attribution added voluntarily).
---
## 📩 Contact & Support
Questions or ideas? Feel free to reach out via GitHub issues or pull requests!
---
Enjoy growing your snake and mastering math with **Maths Snake Adventure**! 🐍🎉✨
---