C++ Tetris Game using raylib

A fully functional Tetris game built with C++ and raylib — featuring all 7 tetrominoes, rotation, collision detection, row clearing, scoring, a next-block preview, background music, and sound effects. The code is well-structured and class-based, making it a great resource for aspiring game developers.

---

What you'll learn

The tutorial walks through the entire game from scratch in 12 steps, explaining every line of code along the way.

	Topic	Details
🪟	Game loop & window setup	Create the game window, configure the frame rate, and structure the update/draw loop
🟦	Grid class	Represent the 20×10 board as a 2D array, draw cells with colour-coded values
🧩	Block & tetromino classes	Model all 7 tetrominoes using a bounding-grid approach across 4 rotation states
🔄	Inheritance	Use a base Block class with 7 child classes (LBlock, IBlock, TBlock, etc.)
➡️	Movement & rotation	Move blocks left, right, and down; rotate with state cycling and undo on invalid moves
💥	Collision detection	Boundary checking and cell-occupancy checks to prevent overlapping or out-of-bounds moves
🔒	Block locking	Lock a block into the grid when it can no longer move down and spawn the next block
🧹	Row clearing	Detect full rows, clear them, and shift all rows above downward
🏆	Scoring	Award 100 / 300 / 500 points for 1 / 2 / 3 line clears, plus 1 point per manual drop
🖥️	UI	Score display, next-block preview panel, and a Game Over message
🔊	Audio	Background music with looping, plus sound effects for rotation and row clears
🔁	Game reset	Restart the game on any key press after Game Over

---

How the game works

• The board is a 20-row × 10-column grid, represented as a 2D integer array. Empty cells hold 0; locked cells hold the block's colour ID (1–7).
• Each of the 7 tetrominoes stores its occupied cell positions for all 4 rotation states. Rotation is handled by cycling a rotationState index — no transform math required.
• A Game class ties everything together, holding the grid, the current block, and the next block, and exposing HandleInput() and Draw() methods called from the main loop.
• Blocks are selected randomly, but each of the 7 appears once before any repeats — matching the behaviour of the original game.
• The game ends when a newly spawned block overlaps an already-locked cell. Press any key to restart.

---

Prerequisites

• Basic knowledge of C++ — loops, conditionals, functions, and classes
• A working C++ development environment (the tutorial uses Visual Studio Code)
• The raylib library installed and configured

New to raylib on Windows? Watch the raylib setup tutorial linked in the video description first. If you're new to game development with raylib in general, the Pong and Snake tutorials (also linked in the description) are a good warm-up before tackling this project.

---

Resources

🎥 Video Tutorial on YouTube   |   📺 My YouTube Channel