finds.dev

ssloy/tinyraycaster

486 lines of C++: old-school FPS in a weekend

View on GitHubHomepage ↗

★ 2,085C++WTFPLupdated Feb 2019

// the take

A deliberately minimal raycasting engine (Wolfenstein 3D style, not true 3D) written in under 500 lines of C++ and SDL2. It's a teaching project meant to be read and extended in a weekend, part of ssloy's series of small graphics projects (tinyrenderer, tinyraytracer, etc.), aimed at people who want to understand how old-school FPS rendering works by building it themselves.

The entire codebase fits in your head in one sitting — you can read every line and know exactly what's happening, which is rare and valuable for a graphics project. The accompanying wiki walks through the raycasting math (DDA, texture mapping, sprite billboarding) step by step rather than just dumping code. It's a genuinely good jumping-off point: the author explicitly built it to be forked and extended, and there's a real example (thanksgiving-party) of students turning it into an actual game.

No commits since 2019 — this is a frozen snapshot, not a maintained project, so don't expect fixes if SDL2 or your toolchain moves on. The author is upfront that it's 'full of bugs' and 'not even a 3d engine,' so treat it as a reference implementation to learn from and rewrite, not code to build on directly. There's no collision handling beyond the basics, no proper game loop abstractions, and no tests — anything beyond the tutorial scope (multiplayer, level editor, real physics) means you're on your own from scratch.

We read the README, the directory tree and a key source file in October 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
2,085
Forks
148
Language
C++
License
WTFPL
Last commit
20 Feb 2019

// nearby

If tinyraycaster isn't quite it.

All repos →