Cpp-Tetris-Game-with-raylib

KO | EN

gitlite — search

#javascript #react #ai #llm #go #linux #docker #macos #java #awesome #cli #vue #pytorch #security

Cpp-Tetris-Game-with-raylib

(★ 114)

C++ Tetris Game with raylib with a video tutorial explaining each line.

Cpp-Tetris-Game-with-raylib Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# C++ Tetris Game using raylib

![Language](https://img.shields.io/badge/language-C%2B%2B-brightgreen)
![Library](https://img.shields.io/badge/library-raylib-00d4aa)
![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-blue)
![License](https://img.shields.io/badge/license-MIT-orange)

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](https://youtu.be/wVYKG_ch4yM)
&nbsp;&nbsp;|&nbsp;&nbsp;
📺 [My YouTube Channel](https://www.youtube.com/channel/UC3ivOTE5EgpmF2DHLBmWIWg)

Cpp-Tetris-Game-with-raylib

Cpp-Tetris-Game-with-raylib Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Cpp-Tetris-Game-with-raylib

Cpp-Tetris-Game-with-raylib Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README