Match Mania

A modern match-3 puzzle game, featuring smooth animations and engaging gameplay mechanics.

## Game Description

Match Mania is a time-based puzzle game where players match colored balls or cubes to score points. The game combines classic match-3 mechanics with modern design and features.

## Core Features

### Gameplay
- Match 3 or more same-colored pieces to score points
- Time-based gameplay (180 seconds per session)
- Drag and drop mechanics for piece movement
- Automatic piece falling and board refilling
- Random shape selection between balls and cubes

### Visual Elements
- Smooth animations for piece movement and matching
- Gradient-based color schemes
- Modern UI with Material Design 3
- Responsive layout that adapts to different screen sizes
- Dynamic piece highlighting during gameplay

### Audio
- Sound effects for:
- Piece dropping
- Matches/disappearing pieces
- Level-up events
- Toggleable sound system
- Multiple audio players for concurrent sound effects

### Scoring System
- Points awarded based on match combinations
- High score tracking with persistent storage
- Score multipliers for larger matches
- Real-time score updates

### User Interface
- Clean, modern design with gradient backgrounds
- Status bar showing:
- Current score
- Time remaining
- Sound controls
- Game over screen with final score display
- High score celebrations
- Responsive home screen with animated elements

### Technical Features
- Persistent data storage for high scores and settings
- Sound preference management
- Mobile-optimized performance
- Cross-platform compatibility
- Google Mobile Ads integration

## Game Mechanics

The game features a grid-based board where players can:
- Drag and swap adjacent pieces
- Create matches of 3 or more same-colored pieces
- Score points within the time limit
- Track and beat high scores
- Toggle sound effects

The game automatically handles:
- Piece falling mechanics
- Board refilling
- Match detection
- Score calculation
- Time management