pixelmintdrop

A modern falling block puzzle game for Android, featuring smooth animations, responsive controls, and a beautiful minimalist design.

Features

Core Gameplay

• Familiar block-stacking gameplay
• 7-bag randomizer for piece distribution
• Ghost piece preview for precise placement
• Hard drop and soft drop controls
• Advanced move detection (e.g., T-Spins) and scoring
• Persistent high score system (Top 5)

Modern Android Features

• Optimized for Android 11+ (API 30+)
• Smooth hardware-accelerated rendering
• High refresh rate support for fluid visuals
• Haptic feedback for tactile interaction (piece movement, line clears)
• Automatic Dark theme support
• Intuitive and responsive touch controls
• Full edge-to-edge display utilization

Scoring System

Pixelmint Drop features a comprehensive scoring system designed to reward skillful play:

Base Scores

• Single line clear: 100 points
• Double line clear: 300 points
• Triple line clear: 500 points
• Quad line clear (4 lines): 1200 points

Multipliers & Bonuses

1. Level Multiplier

   • Score multiplied by the current level.
   • Level increases every 10 lines cleared (Max Level: 20).

2. Combo System

   • Consecutive line clears increase a combo multiplier.
   • Resets if a piece is placed without clearing lines.
   • Multipliers: 1x (1), 1.5x (2), 2.0x (3), 2.5x (4), 3.0x (5+ combos).

3. Back-to-Back Quad Bonus

   • 50% bonus (1.5x) for clearing 4 lines consecutively.
   • Resets on non-Quad clears.

4. Perfect Clear Bonus

   • Bonus multiplier for clearing lines leaving an empty board.
   • Multipliers: 2x (Single), 3x (Double), 4x (Triple), 5x (Quad).

5. All Clear Bonus

   • 2x multiplier for clearing the entire grid of blocks.

6. T-Spin Bonuses

   • Additional multipliers for executing T-Spin maneuvers.
   • Single: 2x, Double: 4x, Triple: 6x.

Controls

• Swipe left/right: Move piece horizontally.
• Swipe down quickly: Hard drop (instant placement).
• Swipe down slowly: Soft drop (faster downward movement).
• Single tap: Rotate piece.

Visual Effects

• Silky-smooth piece movement animations.
• Dynamic pulsing border glow during line clears.
• Clear ghost piece preview for accurate drops.
• Subtle block glow effects.
• Clean grid lines for better visibility.
• Engaging animated title screen featuring falling pieces.

Technical Details

Requirements

• Android 11 (API 30) or higher.
• Hardware acceleration support.
• Minimum 2GB RAM recommended.

Performance Optimizations

• Leverages hardware-accelerated rendering via Android Canvas.
• Efficient collision detection algorithms.
• Optimized grid data structures and operations.
• Targets smooth 60fps animations.
• Score calculations performed on a background thread to maintain UI responsiveness.

Architecture

• Developed entirely in Kotlin.
• Utilizes Android Canvas API for custom drawing.
• Adheres to Material Design principles for UI/UX.
• Persists high scores using SharedPreferences.

Building from Source

1. Clone the repository:

   git clone https://github.com/cmclark00/pixelmintdrop.git
   

2. Open the project in Android Studio.
3. Build and run on a compatible Android device or emulator (API 30+).

Contributing

Contributions are welcome! Please feel free to submit a Pull Request with improvements or bug fixes.

License

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