# Mintris

A modern Tetris implementation for Android, featuring official Tetris rules, smooth animations, and responsive controls.

## Features

### Core Gameplay
- Official Tetris rules and mechanics
- 7-bag randomizer for piece distribution
- Hold piece functionality
- Ghost piece preview
- Hard drop and soft drop
- Wall kick system for rotations
- T-Spin detection and scoring

### Modern Android Features
- Optimized for Android 10+ (API 29+)
- Hardware-accelerated rendering
- High refresh rate support
- Haptic feedback
- Dark theme support
- Responsive touch controls

### Scoring System

The game features a comprehensive scoring system based on official Tetris rules:

#### Base Scores
- Single line: 40 points
- Double: 100 points
- Triple: 300 points
- Tetris (4 lines): 1200 points

#### Multipliers

1. **Level Multiplier**
   - Score is multiplied by current level
   - Level increases every 10 lines cleared

2. **Combo System**
   - Combo counter increases with each line clear
   - Resets if no lines are cleared
   - Multipliers:
     - 1 combo: 1.0x
     - 2 combos: 1.5x
     - 3 combos: 2.0x
     - 4 combos: 2.5x
     - 5+ combos: 3.0x

3. **Back-to-Back Tetris**
   - 50% bonus (1.5x) for consecutive Tetris clears
   - Resets if a non-Tetris clear is performed

4. **Perfect Clear**
   - 2x for single line
   - 3x for double
   - 4x for triple
   - 5x for Tetris
   - Awarded when clearing lines without leaving blocks

5. **All Clear**
   - 2x multiplier when clearing all blocks
   - Requires no blocks in grid and no pieces in play

6. **T-Spin Bonuses**
   - Single: 2x
   - Double: 4x
   - Triple: 6x

#### Example Score Calculation
A back-to-back T-Spin Tetris with a 3x combo at level 2:
```
Base Score: 1200
Level: 2
Combo: 3x
Back-to-Back: 1.5x
T-Spin: 6x
Final Score: 1200 * 2 * 3 * 1.5 * 6 = 64,800
```

### Controls
- Tap left/right to move piece
- Tap up to rotate
- Double tap to hard drop
- Long press to hold piece
- Swipe down for soft drop

## Technical Details

### Requirements
- Android 10 (API 29) or higher
- OpenGL ES 2.0 or higher
- 2GB RAM minimum

### Performance Optimizations
- Hardware-accelerated rendering
- Efficient collision detection
- Optimized grid operations
- Smooth animations at 60fps

### Architecture
- Written in Kotlin
- Uses Android Canvas for rendering
- Implements MVVM architecture
- Follows Material Design guidelines

## Building from Source

1. Clone the repository:
```bash
git clone https://github.com/yourusername/mintris.git
```

2. Open the project in Android Studio

3. Build and run on your device or emulator

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## License

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