DOOM 32X: Resurrection

Description

The goal of the project is to have a code base from which a playable version of DOOM for the Sega 32X platform could be compiled. It is primarily focused on preservation and education but also on fixing the original game's idiosyncrasies and improving performance.

The project is based on the original Jaguar Doom source code release with a bulk of code taken from the Calico DOOM port. I can't thank them enough for taking up the task of translating the original assembler code to C. Without this, the project would have taken me much longer.

To compile the rom you're going to need several things:

Chilly Willy's Sega Devkit
Dump the IWAD file from the Doom 32X Resurrection ROM
Run make

Features

VGM music playback support
Support for monster rotations and in-fighting
Partially invisible spectres as in the origina game
Uses both SH-2 CPUs for threaded rendering to improve performance
Support for larger levels: runs MAP20 from the 24 Level Expansion ROM hack
Stereo sound panning
Support for multiple screen resolutions: from 128x144 (double width) and up to 252x144 (native)
Save checkpoints and global options to SRAM
Distance lighting effect as in the original game
"Potato" mode that renders floors and ceilings in solid color
New title screen reminiscent of PSX and Saturn versions
Sega Mouse support
Statusbar assets are no longer limited to 16 colors
DMAPINFO lump support for naming and sequencing levels

Building

Prerequisites

A posix system and Chilly Willy's Sega MD/CD/32X devkit is requred to build this demo.

VSCode + Remote Dev Container

Unless you already have the devkit built, using VSCode with Docker is one of the faster ways to get started. VSCode will offer to set up a Development Container the first time the project folder is opened.

More information on Developing with VSCode inside a Container

If you're using Windows 10/11, you must also install WSL 2 and Linux distribution before attempting to build from VSCode.

VSCode settings

We recommend using the following VSCode settings.json for the project:

{
    "C_Cpp.default.includePath": [
        "/opt/toolchains/sega/sh-elf/include/",
        "/opt/toolchains/sega/m68k-elf/include/"
    ],
    "C_Cpp.default.compilerPath": "/opt/toolchains/sega/sh-elf/bin/sh-elf-gcc",
    "C_Cpp.default.configurationProvider": "ms-vscode.makefile-tools",

    "makefile.configurations": [
        {
            "name": "release",
            "makeArgs": ["-j", "release"]
        },
        {
            "name": "debug",
            "makeArgs": ["-j", "debug"]
        },
        {
            "name": "clean",
            "makeArgs": ["clean"]
        }
    ]
}