Tetris as a C++ Template Metaprogram
Switch branches/tags
Nothing to show
Clone or download
Latest commit baad8ee Jul 1, 2015
Type Name Latest commit message Commit time
Failed to load latest commit information.
documentation Remove block type. Jun 25, 2015
stt tetris.xcodeproj Factor or generic escape code logic Jun 24, 2015
tetris Small cleanups for post Jun 30, 2015
.gitignore Remove binary Jun 22, 2015
LICENSE Fork from snake. Jun 10, 2015
README.md Added post link Jul 1, 2015


Super Template Tetris

Implementation of Tetris as a C++ template metaprogram. All game logic is implemented at compile time. The runtime program is only needed to print out the game world and serialize it for next play.

Post discussing implementation.


Plays one step of the game every time the game is recompiled.

Start a new game:

$ ./reset.sh

Use compiler flags to control input:

$ clang++ main.cpp -std=c++1z -Wno-gnu-string-literal-operator-template -D COMMAND -o tetris ; ./tetris

Valid commands are:

  • LEFT - Move piece left by one.
  • RIGHT - Move piece right by one.
  • LROT - Rotate piece left (counter clockwise).
  • RROT - Rotate piece right (clockwise).
  • HARD - Hard drop the current piece. This drops the piece all the way down and places it.
  • SOFT - Drop the piece all the way down but don't place it.
  • DOWN - Move the piece down by 4.
  • NONE / anything else - Do nothing, advance game by one.

Pieces will continue to fall for all commands. Movement takes place before the piece is moved down. Pieces have a one step delay before being auto placed (that is, when a piece collides with a block, it but will only be placed on the next step if no further movement is performed).


  • -std=c++1z since the program uses a few C++17 features.
  • -Wgnu-string-literal-operator-template is used for generating compile time strings.


A few screenshots:

Initial game

Clearing a row

Clearing 3 rows

Game over