SFML Tetris Game

A small C++/SFML implementation of classic Tetris. This repository is intentionally compact and is a good base for incremental gameplay improvements.

Image

Features

• Falling tetrominoes with left/right movement
• Piece rotation (Up arrow)
• Soft drop (Down arrow)
• Line clearing
• Lightweight sprite-based rendering (images/ assets)

Dependencies

• C++17-compatible compiler (GCC/Clang/MSVC)
• CMake 3.16+
• SFML 2.5+ (graphics, window, system)

Linux (example)

sudo apt update
sudo apt install -y build-essential cmake libsfml-dev

Windows (PowerShell + vcpkg)

git clone https://github.com/microsoft/vcpkg $env:USERPROFILE\vcpkg
& $env:USERPROFILE\vcpkg\bootstrap-vcpkg.bat

cmake -S . -B build `
  -DCMAKE_TOOLCHAIN_FILE=$env:USERPROFILE\vcpkg\scripts\buildsystems\vcpkg.cmake `
  -DVCPKG_TARGET_TRIPLET=x64-windows
cmake --build build --config Release

Clone

git clone https://github.com/<your-username>/Tetris.git
cd Tetris

Build

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release

Continuous Integration

GitHub Actions builds on Ubuntu using cmake, g++, and libsfml-dev from apt to keep CI simple and reliable.

Run

./build/tetris

The game expects images/ to be beside the executable. The CMake build copies this folder automatically after build.

Controls

• ↑ Rotate piece
• ← Move left
• → Move right
• ↓ Soft drop (faster fall while held)
• Close window to quit

Known Limitations

• No score or level progression yet
• No next-piece preview or hold mechanic
• No hard drop
• No game-over screen/reset flow
• No pause/restart hotkeys
• Random piece generation is purely rand() based (not 7-bag)

License

This project is licensed under the MIT License. See LICENSE.