Tetris Guide & Auto Solver

Introduction

Tetris is a classic tile-matching puzzle game. The goal is simple: guide the falling blocks (Tetrominoes) to create solid horizontal lines without gaps. When a line is completed, it disappears, and you earn points.

Basic Concepts

Tetromino: The seven distinct shapes composed of four squares (I, J, L, O, S, T, Z).
Ghost Piece: The translucent outline at the bottom of the board showing exactly where the current piece will land.
Hold (C / Shift): Swap the current falling piece with the one in your 'Hold' box. Useful for saving a good piece for later.
Hard Drop (Space): Instantly drops the piece to the bottom and locks it in place.
Soft Drop (Down Arrow): Accelerates the piece's fall speed but allows you to slide it before locking.

Advanced Terms

Wall Kick: The ability to rotate a piece even when it's against a wall or another block. The game 'kicks' the piece to an adjacent open space.
DAS (Delayed Auto Shift): The delay between pressing a key and the piece starting to move quickly sideways. It allows for precise single taps vs rapid movement.
Stack: The pile of blocks on the playfield that you are trying to keep low.

How the Auto Solver Works

The Auto Solver is built on a heuristic AI algorithm. Unlike deep learning AIs that 'learn' to play, this AI calculates the 'score' of every possible move based on a mathematical formula. It checks every rotation and position for the current piece (and the Hold piece) and picks the one that results in the best board state.

It tries to maximize the score using these four factors:

1. Aggregate Height (Weight: -0.51)

The sum of the height of all columns. The AI wants to keep the stack as low as possible to avoid topping out (Game Over).

2. Complete Lines (Weight: +0.76)

The number of lines that would be cleared by the move. This is the only positive weight, encouraging the AI to clear lines whenever possible.

3. Holes (Weight: -0.36)

Empty spaces buried under other blocks. Holes are bad because they require clearing the blocks above them to be filled. The AI strongly avoids creating them.

4. Bumpiness (Weight: -0.18)

The sum of the absolute height differences between adjacent columns. A 'bumpy' surface is hard to place pieces on efficiently. The AI strives for a flat surface.