go-doom

go-doom

A pure Go DOOM engine that runs DOOM via WebAssembly with all game data embedded.

Features

• All-in-one binary with embedded WADs, WASM engine and SoundFont
• Runs DOOM WASM module using wazero (no CGO)
• Graphics rendering with Ebitengine
• Sound effects and MIDI music via go-soundfont
• Cross-platform: Windows, macOS, Linux

Installation

go install github.com/danielgatis/go-doom@latest

Or download pre-built binaries from the Releases page.

Usage

doom [game] [flags]

Games

Examples

doom                              # Play Doom Shareware
doom doom2                        # Play Doom II
doom -s 2                         # Play with 2x scale
doom doom2 -s 3                   # Play Doom II with 3x scale
doom -w ~/wads/mywad.wad          # Play custom WAD file
doom -f ~/soundfonts/gm.sf2       # Use custom SoundFont

Flags

Controls

Building from Source

git clone https://github.com/danielgatis/go-doom.git
cd go-doom

# Build all game variants
make all

# Or build a specific game
make doom1      # Doom Shareware (18MB)
make doom2      # Doom II (28MB)

# Build default (doom1)
make build

Available Binaries

Binaries are placed in the bin/ directory.

Buy me a coffee

If you find this project useful, consider buying me a coffee!

License

MIT License - see LICENSE file.

Author

Daniel Gatis