No build required — a pre-built binary is included.

1. Clone this repository:

   git clone https://github.com/moonwho101/DungeonStompDX12UltimateDXR.git
   

2. Run bin/DungeonStomp.exe
3. Stomp some dungeons! Breeyark!

Requirements: Windows 10/11 with a DirectX 12-capable GPU. A DXR-capable GPU (NVIDIA RTX / AMD RX 6000+) is recommended for ray tracing features.

DirectX 12 Ultimate Pipeline:

• DXR Ray Tracing — inline ray tracing for realistic shadow rays and global illumination
• Variable Rate Shading (VRS) — adaptive shading rate for performance optimization
• Physically Based Rendering — full PBR material pipeline (diffuse albedo, Fresnel, roughness, metallicness)
• ACES Tone Mapping — HDR to SDR with cinematic tone curve

Lighting & Shadows:

• Shadow Maps (2048x2048) with dynamic shadow casting
• Screen Space Ambient Occlusion (SSAO) for depth-based occlusion
• Up to 32 dynamic point/spot lights per scene
• Atmospheric fog with density-based effects

Textures & Materials:

• 130+ textures with DDS mipmap chains
• Normal maps with specular in alpha channel
• Cube maps for dynamic skybox reflections
• 28+ PBR materials with tuned roughness and metallic values
• Alpha transparency & alpha testing

Engine:

• BMFont GPU text rendering — fast bitmap font system (AngelCode Hiero format)
• Camera head bob — dual sine-wave movement simulation
• 3-frame buffered rendering with frame resource management
• Bounding box culling and spatial cell partitioning

• 15 hand-crafted dungeon levels with campaign progression
• 25+ enemy types — werewolves, demons, goblins, orcs, hydras, phantoms, and more
• 30+ weapons & spells with ammunition/magic point tracking
• Projectile system — up to 100 simultaneous active missiles
• Interactive doors & keys — swing mechanics, locked doors
• Treasure & loot — gold drops from defeated enemies
• Experience & leveling — XP-based progression system
• Save/Load — persistent game state (F5/F6)
• XBOX controller support (enable in DirectInput.cpp)

Prerequisites:

• Visual Studio 2022 Community (or higher)
• Windows SDK with DirectX 12 support
• C++ Desktop Development workload

Build:

git clone https://github.com/moonwho101/DungeonStompDX12UltimateDXR.git
cd DungeonStompDX12UltimateDXR
msbuild src\DungeonStomp.sln /p:Configuration=Release /p:Platform=x64

Or open src/DungeonStomp.sln in Visual Studio and build in Release | x64 for best results.

The compiled binary is output to the bin/ directory.

├── bin/            # Pre-built game binary & data files (levels, sounds, config)
├── Common/         # D3D12 framework (d3dApp, GameTimer, GeometryGenerator, MathHelper)
├── Models/         # 3DS & MD2 model assets
├── Shaders/        # HLSL shaders (Raytracing, PBR, Shadows, SSAO, NormalMap, Sky)
├── Sounds/         # Ambient loops & sound effects
├── src/            # Game source code (40+ C++ files)
├── Textures/       # 130+ textures (DDS, BMP) with normal maps
└── Installer/      # Inno Setup installer script

Key source files:

• "Introduction to 3D Game Programming with DirectX 12" by Frank Luna

Dungeon Stomp would not have been possible without the amazing MD2 models made by the following authors:

This project is open source. See the LICENSE file for details.