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 R3Free6 lessons5 h3 chapters1,839 XPMaker · Intermediate+150 XP

0 of 6 done

Start the course freeThe board gridBuild it as a kitRetails 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.

  1. Open205 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

  2. ProjectLocked472 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.

  1. Locked236 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

  2. Locked205 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

  3. ProjectLocked472 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.

  1. Locked249 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

  1. The board gridTwo 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.
  2. PiecesThe 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

  1. RotationA 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.
  2. Line clearsFind full rows with one comparison, pull everything above them down, and score more for more rows at once. Two puzzles, then free play.
  3. Speed levelsA 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

  1. Project: a pocket falling-blocks gameThe 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.