cmclark00/tetris-3d
1
0
Fork 0
mirror of https://github.com/cmclark00/tetris-3d.git synced 2025-05-17 23:25:21 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions
tetris-3d/android-app
History
Corey f7f79f2b91 Fix gameplay issues: 1. Reduced movement sensitivity and speed 2. Fixed double-tap rotation issue 3. Added clearer rotation instructions
2025-03-26 00:44:20 -04:00
..
.gradle Implement Android app with improved features: 1. Enhanced swipe controls for smoother movement 2. Improved 3D rotation with visual effects 3. Updated UI to match web app style 2025-03-26 00:38:43 -04:00
.idea Implement Android app with improved features: 1. Enhanced swipe controls for smoother movement 2. Improved 3D rotation with visual effects 3. Updated UI to match web app style 2025-03-26 00:38:43 -04:00
app Fix gameplay issues: 1. Reduced movement sensitivity and speed 2. Fixed double-tap rotation issue 3. Added clearer rotation instructions 2025-03-26 00:44:20 -04:00
build/reports/problems Implement Android app with improved features: 1. Enhanced swipe controls for smoother movement 2. Improved 3D rotation with visual effects 3. Updated UI to match web app style 2025-03-26 00:38:43 -04:00
gradle/wrapper Implement Android app with improved features: 1. Enhanced swipe controls for smoother movement 2. Improved 3D rotation with visual effects 3. Updated UI to match web app style 2025-03-26 00:38:43 -04:00
build.gradle Implement Android app with improved features: 1. Enhanced swipe controls for smoother movement 2. Improved 3D rotation with visual effects 3. Updated UI to match web app style 2025-03-26 00:38:43 -04:00
gradle.properties Implement Android app with improved features: 1. Enhanced swipe controls for smoother movement 2. Improved 3D rotation with visual effects 3. Updated UI to match web app style 2025-03-26 00:38:43 -04:00
gradlew Implement Android app with improved features: 1. Enhanced swipe controls for smoother movement 2. Improved 3D rotation with visual effects 3. Updated UI to match web app style 2025-03-26 00:38:43 -04:00
gradlew.bat Implement Android app with improved features: 1. Enhanced swipe controls for smoother movement 2. Improved 3D rotation with visual effects 3. Updated UI to match web app style 2025-03-26 00:38:43 -04:00
local.properties Implement Android app with improved features: 1. Enhanced swipe controls for smoother movement 2. Improved 3D rotation with visual effects 3. Updated UI to match web app style 2025-03-26 00:38:43 -04:00
README.md Implement Android app with improved features: 1. Enhanced swipe controls for smoother movement 2. Improved 3D rotation with visual effects 3. Updated UI to match web app style 2025-03-26 00:38:43 -04:00
settings.gradle Implement Android app with improved features: 1. Enhanced swipe controls for smoother movement 2. Improved 3D rotation with visual effects 3. Updated UI to match web app style 2025-03-26 00:38:43 -04:00

README.md

3D Tetris - Android App

This is the native Android implementation of the 3D Tetris game. The mobile-specific optimizations from the web app have been removed, and instead, this native app has been created to provide a better experience on Android devices.

Project Structure

  • app/src/main/java/com/tetris3d/ - Contains all Java/Kotlin source files

    • MainActivity.kt - Main activity that hosts the game
    • game/ - Game logic implementation
    • views/ - Custom views for rendering game elements

  • app/src/main/res/ - Contains all resources

    • layout/ - XML layouts for the UI
    • values/ - String resources, colors, and themes
    • drawable/ - Icon and image resources

Features

  • 3D Tetris gameplay with modern graphics
  • Customizable options for 3D effects and animations
  • Physical button controls optimized for touch
  • Score tracking and level progression
  • Game state persistence

Required Implementation

The following components still need to be implemented to complete the Android app:

  1. TetrisGame class - Core game logic ported from JavaScript
  2. TetrisGameView - Custom view for rendering the game
  3. NextPieceView - Custom view for rendering the next piece preview
  4. Tetromino classes - Classes for different tetromino pieces
  5. Game renderer - OpenGL ES or Canvas-based renderer for the 3D effects

Dependencies

  • AndroidX libraries for UI components
  • Kotlin coroutines for game loop threading

Building and Running

  1. Open the project in Android Studio
  2. Build the project using Gradle
  3. Deploy to an Android device or emulator

Development Process

The Android app was created by:

  1. Analyzing the web implementation of the game
  2. Removing mobile-specific optimizations from the web code
  3. Creating a native Android app structure
  4. Implementing the UI layouts and resources
  5. Porting the core game logic from JavaScript to Kotlin
  6. Adding Android-specific features and optimizations

The core game mechanics are kept identical to the web version, ensuring a consistent experience across platforms.