git404hub

what is wolf3d-path-traced fr?

gingerbreadfork/wolf3d-path-traced — explained in plain English

Analysis updated 2026-05-18

7C++Audience · developerComplexity · 5/5Setup · hard

tl;dr

A source modification that adds real time hardware ray tracing to the original 1992 Wolfenstein 3D, while keeping the classic game logic untouched.

vibe map

mindmap
  root((wolf3d-path-traced))
    What it does
      Adds real time path tracing
      Keeps original 1992 game logic
      Switches renderer with one key
    Tech stack
      C++17
      Vulkan ray query
      SDL2
      CMake
    Use cases
      Compare classic vs path traced rendering
      Play the bundled shareware episode
      Record scripted demo runs
    Audience
      Graphics programmers
      Retro game enthusiasts
      Ray tracing hobbyists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Play the original Wolfenstein 3D shareware episode with real time ray traced graphics.

VIBE 2

Toggle instantly between the classic raycaster and the new path traced renderer.

VIBE 3

Compare classic and path traced rendering side by side in a split screen mode.

VIBE 4

Record scripted demo runs headlessly using the built in autopilot system.

what's the stack?

C++VulkanSDL2CMakeGLSL

how it stacks up fr

gingerbreadfork/wolf3d-path-traced0x-shadow/crewtrackjingmatrix/libxposed-example
Stars777
LanguageC++C++C++
Last pushed2025-11-08
MaintenanceQuiet
Setup difficultyhardmoderatemoderate
Complexity5/53/53/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Requires a C++17 compiler, CMake, SDL2, and Vulkan tooling, the path traced renderer needs a GPU with hardware ray tracing support.

No license information is given in the source material.

in plain english

This project takes the original 1992 game Wolfenstein 3D and adds real time ray traced graphics on top of it, purely for the fun and novelty of doing so. The original Wolfenstein 3D used a technique called raycasting to fake a 3D look on hardware from the early 1990s. This project keeps that entire original game, its movement, combat, enemies, doors, secrets, scoring, and save system, completely untouched and authoritative. What changes is how it is drawn: alongside the classic flat renderer, a modern Vulkan based path tracer draws the exact same game state with real light, real shadows, and reflective floors. It is built as a fork of an existing C++ modernization of Wolfenstein 3D called Chocolate Wolfenstein 3D, with the original game logic files kept recognizable. A modern SDL2 layer replaces the old DOS video, input, timing, and audio systems, and a hardware accelerated ray tracing path tracer is added next to the classic renderer using a graphics feature called ray query. The result is things like a flat 1992 sprite casting a genuine shadow, walls and doors reflecting in a polished floor, ambient occlusion, and filmic tone mapping, while the underlying game simulation never changes. You can freely switch between the original raycaster and the new path traced renderer with a single key press, or view them side by side in a split screen comparison mode. The freely distributable shareware episode of Wolfenstein 3D is bundled with the project, so it runs out of the box with nothing extra to download, though you can point it at your own copy of the full game or Spear of Destiny if you own that data. Cheats like invulnerability, infinite ammo, all weapons, or jumping straight to a level are available as command line flags. Building it requires a C++17 compiler, CMake, SDL2, the Vulkan loader and headers, and a shader compiler, with instructions given for Fedora and Ubuntu based systems. The path traced renderer itself needs a GPU that supports hardware ray tracing, such as a recent AMD, NVIDIA, or Intel graphics card, though the game still runs fine in classic mode without one. The project also ships a small scripted autopilot system for automated testing and demo recording without a display.

prompts (copy fr)

prompt 1
Help me build wolf3d-path-traced from source on Ubuntu with CMake and Vulkan.
prompt 2
Explain how the Vulkan ray query path tracer works alongside the original Wolfenstein 3D raycaster.
prompt 3
Walk me through the renderer hotkeys and cheat launch flags this project supports.
prompt 4
Show me how to point wolf3d-path-traced at my own full Wolfenstein 3D or Spear of Destiny data.

Frequently asked questions

what is wolf3d-path-traced fr?

A source modification that adds real time hardware ray tracing to the original 1992 Wolfenstein 3D, while keeping the classic game logic untouched.

What language is wolf3d-path-traced written in?

Mainly C++. The stack also includes C++, Vulkan, SDL2.

What license does wolf3d-path-traced use?

No license information is given in the source material.

How hard is wolf3d-path-traced to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is wolf3d-path-traced for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.