Skip to content

ByconStudio/Block_Puzzle

Repository files navigation

🧩 Block Puzzle

A Tetris-like puzzle game built with Kotlin for Android. Features Google authentication, real-time leaderboard system, and smooth gameplay mechanics.

Kotlin Android License


✨ Features

  • 🎮 Tetris-style Gameplay - Classic puzzle mechanics with smooth block placement
  • 🔐 Google Authentication - Secure user login with Google Sign-In
  • 🏆 Real-time Leaderboard - Compete with other players and track high scores
  • 📊 Score Tracking - Persistent score storage and statistics
  • 🎯 Smooth UI - Intuitive and responsive user interface
  • Optimized Performance - Built with native Kotlin for smooth gameplay

🚀 Getting Started

Prerequisites

  • Android Studio (latest version recommended)
  • JDK 11 or higher
  • Android SDK 24+ (API Level 24 or higher)
  • Google Play Services configured in your Firebase project

Installation

  1. Clone the repository

    git clone https://github.com/ByconStudio/Block_Puzzle.git
    cd Block_Puzzle
  2. Open in Android Studio

    • Open Android Studio
    • Select "File" → "Open"
    • Navigate to the cloned repository folder
    • Click "Open"
  3. Configure Firebase/Google Auth

    • Create a Firebase project at Firebase Console
    • Download google-services.json
    • Place it in the app/ directory
    • Enable Google Sign-In in Firebase Authentication
  4. Build & Run

    • Connect an Android device or use an emulator
    • Click "Run" or press Shift + F10

🎮 How to Play

  1. Login - Sign in with your Google account
  2. Gameplay - Place falling blocks to complete rows/columns
  3. Score Points - Clear lines to earn points
  4. Climb the Leaderboard - Beat high scores and rank up globally
  5. Challenge Friends - Share your score and compete

📱 Project Structure

Block_Puzzle/
├── app/
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/
│   │   │   ├── res/
│   │   │   └── AndroidManifest.xml
│   │   └── ...
│   ├── build.gradle
│   └── google-services.json
├── gradle/
├── build.gradle
└── settings.gradle

🛠️ Tech Stack

  • Language: Kotlin
  • Framework: Android SDK
  • Authentication: Google Sign-In / Firebase Auth
  • Backend: Firebase Realtime Database / Firestore
  • UI: Android Material Design

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

This means:

  • ✅ You can use this code for commercial projects
  • ✅ You can modify and distribute the code
  • ✅ You must include the original license in your project
  • ✅ No liability - use at your own risk

🤝 Contributing

Contributions are welcome! If you'd like to contribute:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

🐛 Issues & Feedback

Found a bug or have a suggestion? Please open an issue with:

  • Detailed description
  • Steps to reproduce (if it's a bug)
  • Screenshots/screen recordings (if applicable)

👨‍💻 Author

ByconStudio


📚 Resources


🎯 Future Enhancements

  • Multiplayer mode
  • Sound effects and music
  • Different game modes
  • Power-ups and special blocks
  • Offline gameplay
  • Achievement system

Enjoy the game and happy coding! 🚀

About

ready to publish

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors