CGB3D Docs Examples Download

Real‑time 3D for the Game Boy and Game Boy Color.

CGB3D is a software 3D engine and a browser editor. The rasterizer is hand-written assembly. Your game is data you author in the editor and ship as a real ROM: one cart that plays on a Game Boy Color, a Game Boy or a Game Boy Pocket.

Play in the browser Read the docs

Development build a1d148b, 1 November 2026.

Running in your browser

Make the game in the editor. The engine plays it.

No engine code to write for a new game. Rooms, cameras, characters, title screens and the flow between them are all authored in the browser and exported as data the ROM reads.

1

Author

Lay out rooms and fixed cameras, import models and pre-rendered backgrounds, paint palettes.

2

Connect

Wire title, menus and scenes together in the screen graph. Or ask the Claude Assistant to do it with you.

3

Build and play

One click compiles the ROM and launches it in the emulator, in colour or as a Game Boy. The same file runs on real hardware.

The CGB3D editor: a room, its camera and its pickups

Built for the hardware.

Every cycle on the hot path is accounted for. The C layer only orchestrates.

Target
Game Boy Color in double-speed mode; the same cart on Game Boy, Pocket and Super Game Boy in four greys
Rasterizer
Span fill, vertex transform and triangle setup in RGBDS assembly
Game layer
C compiled with SDCC, banked, data-driven
Render window
128×96 for full 3D, or a software character over a pre-rendered room
Game systems
Doors, triggers, pause, items and inventory, music and sound effects, optional C callbacks
Tooling
Browser editor, screen graph, sound editor, Claude Assistant, pytest and PyBoy test suite

Examples

Play them here or download the ROM. Every example plays on any Game Boy. Dead Pixels also ships with the editor as a project you can open and change.

Spinning cube running on the engine

Spinning cube

Flat-shaded mesh, full 3D pipeline.

PlayDownload GBCDownload GB
Walkable room running on the engine

Walkable room

First-person movement through a 3D room.

PlayDownload GBCDownload GB
Dead Pixels running on the engine

Dead Pixels

Fixed cameras, doors, a key, an inventory and music.

PlayDownload GBCDownload GB

Learn

Getting started

Play the examples, then make your first room.

Editor guide

Workspaces, the screen graph, building a ROM.

Engine limits

What a game can hold: colours, models, rooms, ROM size.

Download CGB3D

The editor, the engine and the full toolchain in one package. Nothing else to install.

Windows

Windows 10 and 11, 64-bit

Coming soon

macOS

macOS 13 or later, Apple silicon and Intel

Coming soon

Linux

x86-64, AppImage or .deb

Coming soon

Free to use, all rights reserved. Example ROMs only (.zip)