chocolate-doom/chocolate-doom
FreeChocolate Doom is a Doom source port that is minimalist and historically accurate.
FreeFree tier
About chocolate-doom/chocolate-doom
Chocolate Doom is a minimalist, historically accurate source port that recreates the original DOS versions of Doom, Heretic, Hexen, and Strife for modern computers. It prioritizes 100% free and open source software, wide portability, accurate reproduction (including original bugs), full compatibility with DOS demo, configuration, and savegame files, and an authentic retro feel. Features include a -merge option for playing Total Conversions without modifying IWADs.
Key Features
Accurate reproduction of original DOS Doom engine versions, including bugs
Compatibility with DOS demo, configuration, and savegame files
Portability to as many different operating systems as possible
Retro 'feel' preservation in display and input behavior
Includes ports of Heretic, Hexen, and Strife
Support for Total Conversions via -merge option
Configuration file (chocolate-doom.cfg) with extra settings, editable via chocolate-setup
Command line parameters compatible with DOS versions plus extras
Pros & Cons
Pros
- 100% free and open source software
- Historically accurate – reproduces original bugs and behavior
- Cross-platform portable (Windows, macOS, Linux, etc.)
- Does not require modification of original IWAD files for Total Conversions
- Maintains full compatibility with DOS game assets and settings
Cons
- Does not include modern enhancements (e.g., higher resolutions, improved graphics, advanced features)
- Limited to games using the Doom engine (original Doom, Heretic, Hexen, Strife)
- Retains original bugs by design – may not appeal to players wanting a polished experience
Best For
Playing classic Doom, Heretic, Hexen, and Strife on modern computersRunning original DOS demos and using existing DOS configuration/save filesExperiencing Total Conversions (e.g., Batman Doom) using -mergePreserving the exact original game behavior for archival or nostalgic purposes
FAQ
How does Chocolate Doom differ from other source ports?
It aims for historical accuracy including bugs, rather than adding modern features or enhancements.
Can I use my old DOS Doom configuration file?
Yes, Chocolate Doom is compatible with the DOS Doom configuration file (default.cfg). Existing files should work out of the box.
How do I play Total Conversions?
Use the -merge option: chocolate-doom -merge thetc.wad. This simulates merging the PWAD into the IWAD without modifying the original file.