tetris/README.md

Tetris Game

A classic Tetris game implemented in Go using the Ebitengine game engine.

Features

• Classic Tetris gameplay
• Ghost piece preview
• Next piece preview
• Line clearing with scoring
• Progressive difficulty levels
• Smooth controls with wall kicks

Project Structure

tetris/
├── main.go                 # Application entry point
├── go.mod                  # Go module definition
├── go.sum                  # Go module checksums
├── assets/                 # Game assets (future use)
├── internal/               # Internal packages
│   ├── game/              # Core game logic
│   │   └── game.go        # Game state and rendering
│   ├── tetromino/         # Tetromino (falling pieces) logic
│   │   └── tetromino.go   # Piece shapes, rotation, movement
│   └── types/             # Shared type definitions
│       └── types.go       # Block types and colors
└── pkg/                   # Public packages
    └── config/            # Configuration constants
        └── config.go      # Game configuration and constants

Architecture

The project follows Go best practices with a clean package structure:

• main.go: Entry point that initializes the game
• pkg/config: Contains all game configuration constants
• internal/types: Defines core data types and enums
• internal/tetromino: Handles tetromino piece logic (shapes, rotation, movement)
• internal/game: Core game mechanics (board state, input handling, rendering)

Controls

• Left/Right Arrow: Move piece horizontally
• Up Arrow: Rotate piece clockwise
• Down Arrow: Soft drop (faster falling)
• Space: Hard drop (instant drop)
• Space (when game over): Restart game

Building and Running

# Run the game
go run .

# Build executable
go build -o tetris
./tetris

Dependencies

• Ebitengine v2.8.8 - 2D game engine for Go

License

This project is open source and available under the MIT License.