This is a vanilla port of the DooM source code to C#, currently targeting .NET 8.

We currently support two platforms:

• Windows, via WPF and MAUI
• Android

• Make sure you have the .NET 8 SDK installed: https://dotnet.microsoft.com/en-us/download .

• Install Visual Studio 2022, there's a free community edition available, or use VS Code if you want a lightweight editor. You can also check out Rider from JetBrains if you're more familiar with IntelliJ.

• Fork or clone this repo (duh).

• Open the src/DoomSharp.sln file and set the DoomSharp.Windows project as your startup project.

• Before running, you need some WAD files. If you have an original copy of DooM, you can use these files. If not, you can freely download the shareware files here: https://www.doomworld.com/idgames/idstuff/doom/doom19s

• Once you have your WAD files in a directory - I prefer to use a directory called WAD in the repository's folder structure - , open the DoomSharp.Windows project properties and add a debug profile. In this debug profile, add an environment variable called DOOMWADDIR and set its value to the path that contains the WAD file(s). This should give you a file called launchSettings.json which looks like this:

{
  "profiles": {
    "DoomSharp.Windows": {
      "commandName": "Project",
      "environmentVariables": {
        "DOOMWADDIR": "Path\\To\\Wads"
      }
    }
  }
}

Loading the original WAD files should work, only the shareware and retail WADs have been tested.

The demo games are not running as they should yet, the commands seem to be out of sync somehow. You can start your own game, and probably play the entire first episode!

What does not yet work:

• Android: music (on Windows, music should work if you have the standard MIDI sound bank installed)
• Finishing an episode and going to the next one
• Returning from the secret level
• The automap
• Cheats (hah!)
• Messages when you pick up items
• Network support (not the focus of this port, but who knows, one day)