cmclark00/mintris
1
0
Fork 0
mirror of https://github.com/cmclark00/mintris.git synced 2025-05-18 15:05:21 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

Update README with accurate Android version requirements and features

Browse source
This commit is contained in:
cmclark00 2025-03-27 02:12:06 -04:00
parent 2683d7b156
commit db93b70741
1 changed files with 24 additions and 24 deletions
Download patch file Download diff file Expand all files Collapse all files

48
README.md
View file

@ -1,29 +1,30 @@
# Mintris # Mintris
A modern Tetris implementation for Android, featuring official Tetris rules, smooth animations, and responsive controls. A modern Tetris implementation for Android, featuring smooth animations, responsive controls, and a beautiful minimalist design.
## Features ## Features
### Core Gameplay ### Core Gameplay
- Official Tetris rules and mechanics - Classic Tetris mechanics
- 7-bag randomizer for piece distribution - 7-bag randomizer for piece distribution
- Hold piece functionality - Hold piece functionality
- Ghost piece preview - Ghost piece preview
- Hard drop and soft drop - Hard drop and soft drop
- Wall kick system for rotations
- T-Spin detection and scoring - T-Spin detection and scoring
- High score system with top 5 scores
### Modern Android Features ### Modern Android Features
- Optimized for Android 10+ (API 29+) - Optimized for Android 11+ (API 30+)
- Hardware-accelerated rendering - Hardware-accelerated rendering
- High refresh rate support - High refresh rate support
- Haptic feedback - Haptic feedback for piece movement and line clears
- Dark theme support - Dark theme support
- Responsive touch controls - Responsive touch controls
- Edge-to-edge display support
### Scoring System ### Scoring System
The game features a comprehensive scoring system based on official Tetris rules: The game features a comprehensive scoring system:
#### Base Scores #### Base Scores
- Single line: 40 points - Single line: 40 points
@ -36,6 +37,7 @@ The game features a comprehensive scoring system based on official Tetris rules:
1. **Level Multiplier** 1. **Level Multiplier**
- Score is multiplied by current level - Score is multiplied by current level
- Level increases every 10 lines cleared - Level increases every 10 lines cleared
- Maximum level is 20
2. **Combo System** 2. **Combo System**
- Combo counter increases with each line clear - Combo counter increases with each line clear
@ -67,29 +69,26 @@ The game features a comprehensive scoring system based on official Tetris rules:
- Double: 4x - Double: 4x
- Triple: 6x - 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 ### Controls
- Tap left/right to move piece - Tap left/right to move piece
- Tap up to rotate - Tap up or double tap to rotate
- Double tap to hard drop
- Long press to hold piece
- Swipe down for soft drop - Swipe down for soft drop
- Fast swipe down for hard drop
- Long press to hold piece
### Visual Effects
- Smooth piece movement animations
- Pulsing border glow during line clears
- Ghost piece preview
- Block glow effects
- Subtle grid lines
- Animated title screen with falling pieces
## Technical Details ## Technical Details
### Requirements ### Requirements
- Android 10 (API 29) or higher - Android 11 (API 30) or higher
- OpenGL ES 2.0 or higher - Hardware acceleration support
- 2GB RAM minimum - 2GB RAM minimum
### Performance Optimizations ### Performance Optimizations
@ -97,18 +96,19 @@ Final Score: 1200 * 2 * 3 * 1.5 * 6 = 64,800
- Efficient collision detection - Efficient collision detection
- Optimized grid operations - Optimized grid operations
- Smooth animations at 60fps - Smooth animations at 60fps
- Background thread for score calculations
### Architecture ### Architecture
- Written in Kotlin - Written in Kotlin
- Uses Android Canvas for rendering - Uses Android Canvas for rendering
- Implements MVVM architecture
- Follows Material Design guidelines - Follows Material Design guidelines
- Implements high score persistence using SharedPreferences
## Building from Source ## Building from Source
1. Clone the repository: 1. Clone the repository:
```bash ```bash
git clone https://github.com/yourusername/mintris.git git clone https://github.com/cmclark00/mintris.git
``` ```
2. Open the project in Android Studio 2. Open the project in Android Studio