All paths

MicroPython games on a tiny screen

Build space games in MicroPython on a Pico with an OLED: drawing, a game loop, buttons, a score, random asteroids, sound, and a space snake.

Raspberry Pi PicoFree7 lessons5 h4 chapters1,495 XPCoding · Beginner+100 XP

0 of 7 done

Start the course freeDrawing on an OLEDBuild it as a kitRetails for about $8.60, free on Mokxi.Lesson plan for teachers
What you will build

3 projects, built step by step

7 lessons in 4 chapters, about 5 hours on a simulated Raspberry Pi Pico. Free, in your browser, every step checked by the simulator.

Chapter 1 project

Moving a dot

The game loop every game runs: clear, draw, show, move. Bounce a ship off the walls and measure your frame rate.

Open it in the simulator
Chapter 2 project

A score

Catch stars with box collisions, keep score, draw it with % formatting, and end the game after three misses.

Open it in the simulator
Chapter 3 project

Sound

Make a piezo sing with PWM: a start jingle, a crash sound, the lowest note the Pico can make, and a tune stored as a list.

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 screen

Draw pixels, boxes and text on a 128 by 64 OLED, then make a ship move with a game loop.

  1. Open150 XP

    Drawing on an OLED

    Light pixels, lines, boxes and text on a 128 by 64 OLED, and learn why nothing shows until show().

    0 of 5 steps

  2. ProjectLocked330 XP

    Moving a dot

    The game loop every game runs: clear, draw, show, move. Bounce a ship off the walls and measure your frame rate.

    0 of 5 steps

5 questions, graded as you go.
Chapter 2

Play

Steer with two buttons, catch stars with box collisions, and keep score.

  1. Locked140 XP

    Reading buttons

    Steer the ship with two buttons: pull-ups, why pressed reads 0, held versus tapped, and the bounce you never see.

    0 of 4 steps

  2. ProjectLocked280 XP

    A score

    Catch stars with box collisions, keep score, draw it with % formatting, and end the game after three misses.

    0 of 4 steps

5 questions, graded as you go.
Chapter 3

Danger and noise

A random asteroid field with lives and levels, and sound from a piezo.

  1. Locked140 XP

    Random enemies

    An asteroid field from random numbers and a list: spawn, move, clear away, crash. Then lives and levels.

    0 of 4 steps

  2. ProjectLocked280 XP

    Sound

    Make a piezo sing with PWM: a start jingle, a crash sound, the lowest note the Pico can make, and a tune stored as a list.

    0 of 4 steps

5 questions, graded as you go.
Chapter 4

Project: snake

Everything at once: a space snake with steering, food, growth, sound and warp edges.

  1. Locked175 XP

    Project: snake

    Build space snake: a grid, a list of cells for a body, two-button steering, food, growth, sound, speed-ups and warp edges.

    0 of 6 steps

4 questions, graded as you go.
Syllabus

Every lesson in the course

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

Chapter 1

The screen

  1. Drawing on an OLEDLight pixels, lines, boxes and text on a 128 by 64 OLED, and learn why nothing shows until show().
  2. Moving a dotThe game loop every game runs: clear, draw, show, move. Bounce a ship off the walls and measure your frame rate.
Chapter 2

Play

  1. Reading buttonsSteer the ship with two buttons: pull-ups, why pressed reads 0, held versus tapped, and the bounce you never see.
  2. A scoreCatch stars with box collisions, keep score, draw it with % formatting, and end the game after three misses.
Chapter 3

Danger and noise

  1. Random enemiesAn asteroid field from random numbers and a list: spawn, move, clear away, crash. Then lives and levels.
  2. SoundMake a piezo sing with PWM: a start jingle, a crash sound, the lowest note the Pico can make, and a tune stored as a list.
Chapter 4

Project: snake

  1. Project: snakeBuild space snake: a grid, a list of cells for a body, two-button steering, food, growth, sound, speed-ups and warp edges.
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

Pico Screen Games Kit

A Pico, an OLED display (128x64), a pushbutton and a piezo speaker: play games 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 MicroPython games on a tiny screen

Is MicroPython games on a tiny screen free?

Yes. All 7 lessons of MicroPython games on a tiny screen are free and run in your browser, with nothing to install and no parts to buy before you start.

Do I need a real Raspberry Pi Pico?

No. Every lesson runs on a simulated Raspberry Pi Pico 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 MicroPython games on a tiny screen take?

About 5 hours: 7 lessons in 4 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: Moving a dot, A score and Sound.

Where do I start?

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