55 lines
1.6 KiB
Markdown
55 lines
1.6 KiB
Markdown
# Match 3 Game - Flutter/Flame
|
|
|
|
A cross-platform Match 3 puzzle game built with Flutter and Flame game engine.
|
|
|
|
## Technology Stack
|
|
- **Framework**: Flutter
|
|
- **Game Engine**: Flame
|
|
- **State Management**: Bloc/Cubit
|
|
- **Platforms**: iOS, Android, Web, Desktop
|
|
|
|
## Features
|
|
- Classic match-3 gameplay (8x8 grid)
|
|
- Smooth animations and particle effects
|
|
- Multiple game modes (Classic, Timed, Moves-limited)
|
|
- Power-ups and special gems
|
|
- Progressive difficulty levels
|
|
- Score tracking and achievements
|
|
- Cross-platform compatibility
|
|
|
|
## Project Structure
|
|
```
|
|
lib/
|
|
├── main.dart
|
|
├── game/
|
|
│ ├── match_three_game.dart # Main game class
|
|
│ ├── components/ # Game components
|
|
│ │ ├── grid_component.dart
|
|
│ │ ├── gem_component.dart
|
|
│ │ └── ui_overlay.dart
|
|
│ ├── systems/ # Game systems
|
|
│ │ ├── match_detector.dart
|
|
│ │ ├── gravity_system.dart
|
|
│ │ └── score_system.dart
|
|
│ └── models/ # Data models
|
|
│ ├── gem.dart
|
|
│ ├── grid.dart
|
|
│ └── game_state.dart
|
|
├── screens/ # UI screens
|
|
│ ├── menu_screen.dart
|
|
│ ├── game_screen.dart
|
|
│ └── settings_screen.dart
|
|
├── bloc/ # State management
|
|
│ ├── game_bloc.dart
|
|
│ └── menu_bloc.dart
|
|
└── utils/
|
|
├── constants.dart
|
|
└── helpers.dart
|
|
```
|
|
|
|
## Getting Started
|
|
1. Install Flutter SDK
|
|
2. Add Flame dependency
|
|
3. Run `flutter pub get`
|
|
4. Launch with `flutter run`
|