Source: https://mokxi.com/learn/path/build-tetris-matrix
Updated: 2026-11-20

All paths

# Build Tetris on an LED matrix

Build a complete falling-blocks game on two 8x8 LED matrices: a field of sixteen bytes, seven pieces, quarter turns, line clears and levels.

Arduino Uno R3 Free 6 lessons 5 h 3 chapters 1,839 XP Maker · Intermediate +150 XP

0 of 6 done

Start the course free The board grid Build it as a kit Retails for about $34, free on Mokxi. Lesson plan for teachers

What you will build

## 2 projects, built step by step

6 lessons in 3 chapters, about 5 hours on a simulated Arduino Uno R3. Free, in your browser, every step checked by the simulator.

Chapter 1 project

### Pieces

The seven shapes four squares can make, each a list of cells in a box. Make them fall, steer them, and stop them on the floor and on each other.
Open it in the simulator

Chapter 2 project

### Speed levels

A level every 4 lines, each 15 percent faster, timed with millis() so the stick never feels sticky. Then the moment every game needs: game over.
Open it in the simulator

The map

## Chapter by chapter

Each lesson opens when the one before it is done, and each chapter ends in a project.

Chapter 1

## The field and the pieces

Sixteen bytes on two matrices, and seven shapes that fall.

Open 205 XP

### The board grid

Two 8x8 LED matrices make one field 8 wide and 16 tall. Keep it as sixteen bytes, drive it over three wires, and draw on it with the joystick.

0 of 5 steps

Start What is in it

Project Locked 472 XP

### Pieces

The seven shapes four squares can make, each a list of cells in a box. Make them fall, steer them, and stop them on the floor and on each other.

0 of 6 steps

5 questions, graded as you go.

Chapter 2

## The rules of the game

Turn the pieces, clear the lines and speed it up.

Locked 236 XP

### Rotation

A quarter turn is a swap and a flip: (x, y) becomes (n - 1 - y, x). Turn every piece, find the one that never changes, and kick off the walls.

0 of 6 steps

Locked 205 XP

### Line clears

Find full rows with one comparison, pull everything above them down, and score more for more rows at once. Two puzzles, then free play.

0 of 5 steps

Project Locked 472 XP

### Speed levels

A level every 4 lines, each 15 percent faster, timed with millis() so the stick never feels sticky. Then the moment every game needs: game over.

0 of 6 steps

5 questions, graded as you go.

Chapter 3

## A pocket game

Put it all together into a game worth sharing.

Locked 249 XP

### Project: a pocket falling-blocks game

The whole game: a title screen, pieces from a shuffled bag, a lock click, pause, a best score, and it is yours to change and share.

0 of 7 steps

3 questions, graded as you go.

Syllabus

## Every lesson in the course

All 6 lessons, in order, each with what it covers. Any of them opens in the editor right away.

Chapter 1

### The field and the pieces

- The board grid Two 8x8 LED matrices make one field 8 wide and 16 tall. Keep it as sixteen bytes, drive it over three wires, and draw on it with the joystick.
- Pieces The seven shapes four squares can make, each a list of cells in a box. Make them fall, steer them, and stop them on the floor and on each other.

Chapter 2

### The rules of the game

- Rotation A quarter turn is a swap and a flip: (x, y) becomes (n - 1 - y, x). Turn every piece, find the one that never changes, and kick off the walls.
- Line clears Find full rows with one comparison, pull everything above them down, and score more for more rows at once. Two puzzles, then free play.
- Speed levels A level every 4 lines, each 15 percent faster, timed with millis() so the stick never feels sticky. Then the moment every game needs: game over.

Chapter 3

### A pocket game

- Project: a pocket falling-blocks game The whole game: a title screen, pieces from a shuffled bag, a lock click, pause, a best score, and it is yours to change and share.

Keep going

## The next course on your track

Build Tetris on an LED matrix is part of the maker track, a ladder of courses from zero to expert.

Next course

### Build your own bench tools

A frequency counter, a capacitance meter, a resistor tester, a battery tester and a DAC signal generator, then all five in one LCD box.
Open the next course

Track

### Maker track

Follow the starter kit you already own, then build a claw machine, a balance bot, a handheld console or an LED cube, each a short course checked by the simulator.
See every course on the track

Kits

## Build it on your bench too

Every lesson runs in the simulator with nothing to buy. When you want the real thing, these kits have the parts.

The kit for this course

### Falling Blocks Kit

An Uno, an LED matrix (8x8), a thumb stick and a buzzer: a falling-blocks game you build yourself.
Open the kit

Have a kit already?

### Find your kit

Pick the starter kit you own and run every lesson in its manual with the same parts on the same pins.
See every kit

Questions

## About Build Tetris on an LED matrix

Is Build Tetris on an LED matrix free?

Yes. All 6 lessons of Build Tetris on an LED matrix are free and run in your browser, with nothing to install and no parts to buy before you start.

Do I need a real Arduino Uno R3?

No. Every lesson runs on a simulated Arduino Uno R3 with its parts on the canvas, and the simulator checks each step as you go. When you want to build it for real, the same wiring and code work on a real board.

How long does Build Tetris on an LED matrix take?

About 5 hours: 6 lessons in 3 chapters, each one a few short steps. Your progress is kept, so you can stop after any lesson and pick up where you left off.

What will I build?

Each chapter ends in a project that puts it together: Pieces and Speed levels.

Where do I start?

With "The board grid", and each lesson builds on the one before it. New to circuits? Electronics basics is the course that starts from zero.
