Welcome to Memo Battle, an engaging and fun memory matching game designed to test and improve your cognitive skills! Challenge yourself or a friend in a battle of wits as you flip cards to find matching pairs. With different difficulty levels and a two-player mode, Memo Battle offers endless hours of entertainment.

Goal:

The goal of Memo Battle is to find all matching pairs of cards on the grid. In two-player mode, the player with the most matched pairs at the end of the game wins!

• Classic Memory Matching Gameplay: Simple and intuitive mechanics: flip two cards, and if they match, they stay revealed.
• Multiple Difficulty Levels:
  • Easy: A smaller grid (4x3) for beginners or a quick game.
  • Medium: A balanced grid size (4x4) for a moderate challenge.
  • Hard: A larger grid (6x4) for a true test of memory.
• Two-Player Mode: Compete head-to-head with a friend on the same device.
• Score Tracking: Keep track of each player's score in two-player mode.
• Turn-Based Gameplay: Players take turns flipping cards in the two-player mode.
• Audio Feedback: Satisfying sounds for matched pairs, errors, and game outcomes.
• Clean and Intuitive UI: A user-friendly interface built with modern Android UI toolkit.
• Ad Supported: The game is supported by ads, allowing you to enjoy it for free.
• Kotlin and Jetpack Compose: Built using modern Android development technologies for a smooth and efficient user experience.

1. Start the Game: Launch the Memo Battle app.
2. Select Difficulty: Choose your desired challenge level (Easy, Medium, or Hard).
3. Single Player vs. Two Player:
   • For a single-player game, simply start playing.
   • For a two-player game, the game automatically starts in two-player mode with turn-based gameplay.
4. Flip Cards: Tap on any two cards to flip them over.
5. Find Matches: If the two flipped cards have the same icon, they are a match and will remain face up.
6. Mismatches: If the cards do not match, they will automatically flip back over after a short delay.
7. Two-Player Turns: In two-player mode, after a mismatch, the turn switches to the other player. If a match is found, the current player gets another turn.
8. Game End: The game ends when all pairs have been matched.
9. Winning: In two-player mode, the player with the highest score (most matched pairs) wins. In case of a tie, it's a draw!

• Kotlin: The modern, concise, and safe programming language for Android.
• Jetpack Compose: Android's modern toolkit for building native UI declaratively, providing a reactive and efficient development experience.
• AdMob: For integrating advertisements.
• Gson: For JSON parsing (potentially used for saving/loading game state or settings, though not explicitly shown in the provided snippets, it's a common dependency).
• Kotlin Coroutines: For asynchronous operations and managing game delays.

• Android Studio: The official IDE for Android development.
• Gradle: Build system for Android projects.

1. Clone the Repository:
2. Open in Android Studio: Import the project into Android Studio.
3. Build and Run: Build the project and run it on an Android emulator or a physical device.

Contributions to Memo Battle are welcome! Here's how you can get involved:

1. Fork the Repository: Create your own copy of the project.
2. Create a Branch: Make your changes in a new branch.
3. Implement Your Changes: Add your new features, bug fixes, or improvements.
4. Commit Your Changes:
5. Push Your Changes:
6. Submit a Pull Request: Open a pull request to merge your changes into the main branch.

This project is licensed under the Apache License version 2.0.

If you have any questions or suggestions, feel free to reach out to [email protected]!

Enjoy challenging your memory!