pinkwah / ImDoom64

ImDoom 64 is a reverse-engineering project aimed to recreate Doom 64 as close as possible with additional modding features. (Fork of Doom64EX)

ImDoom 64

ImDoom 64 is a reverse-engineering project aimed to recreate Doom 64 as close as possible with additional modding features. This project is a fork of Doom64EX.

Usage

Unlike Doom64EX, ImDoom 64 uses an original, unmodified N64 ROM. As a result, there is no Wadgen utility. To use, rename your legally obtained ROM to doom64.rom and place it in one of ImDoom 64's search paths.

Compiling

Linux

Dependencies

• git
• C++17-compliant compiler (gcc 8).
• Meson 0.47 or newer
• ninja 1.5 or newer.
• SDL2
• SDL2_net
• libpng 1.6 or newer
• zlib
• fluidsynth (optional)
• fmt 5.2.1 or newer (optional)

The optional dependencies will be downloaded and compiled automatically by meson if missing.

Ubuntu 14.04, 16.04

$ # Install required dependencies
$ sudo add-apt-repository ppa:ubuntu-toolchain-r/test
$ sudo apt-get update
$ sudo apt-get install -y g++-8 git libsdl2-net-dev libpng-dev python3.5 python3-pip
$ python3.5 -m pip3 install --user meson

$ # Install optional dependencies (GTK+3)
$ sudo apt-get install -y valac libgtk-3-dev

$ # Set up environment (NOTE: Repeat these steps if you close your shell)
$ export PATH=$HOME/.local/bin:$PATH CC=gcc-8 CXX=g++-8

#### Ubuntu 18.04

```bash
$ # Install required dependencies
$ sudo apt-get install -y g++-8 git libsdl2-net-dev libpng-dev ninja-build python3-pip
$ pip3 install meson

$ # Install optional dependencies (GTK+3)
$ sudo apt-get install -y valac libgtk-3-dev

$ # Set up environment (NOTE: Repeat these steps if you close your shell)
$ export PATH=$HOME/.local/bin:$PATH CC=gcc-8 CXX=g++-8

Ubuntu 18.10, Debian Testing/Unstable

$ # Install required dependencies
$ sudo apt-get install -y g++-8 meson git libsdl2-net-dev libpng-dev

$ # Install optional dependencies (GTK+3)
$ sudo apt-get install -y valac libgtk-3-dev

$ # Set up environment (NOTE: Repeat these steps if you close your shell)
$ export CC=gcc-8 CXX=g++-8

Unsupported Distributions

The following distributions are unsupported at the moment. If you manage to get this program to work, please submit a pull-request with updated documentation.

• Red Hat Enterprise Linux
• SUSE Enterprise Linux
• CentOS
• Debian Stable
• Any distribution whose maintainers have stopped supporting. (Ie. old LTS distros)

Common Compilation Steps

Once everything is installed, do:

$ # Get the sources
$ git clone https://github.com/Doom64/ImDoom64.git --recursive

$ # Enter build directory
$ mkdir -p ImDoom64/build
$ cd ImDoom64/build

$ # Build
$ CC=gcc-8 CXX=g++-8 meson --default-library=static --buildtype=release -Denable_gtk3=false ..
$ ninja
$ sudo ninja install

ImDoom 64 is now usable using the imdoom64 command or through the ImDoom 64 icon in your system menus.

Search Paths

Linux

The game will look for files in your $XDG_DATA_DIR/imdoom64 directory. This is normally ~/.local/share/imdoom64.

Additionally, it will look in the following system directories:

• /usr/local/share/games/imdoom64
• /usr/local/share/imdoom64
• /usr/local/share/doom
• /usr/share/games/imdoom64
• /usr/share/imdoom64
• /usr/share/doom
• /opt/imdoom64
• /app/imdoom64

Linux Flatpak

When running the flatpak version, the program's filesystem access is limited. The only directory that is accessible is ~/.var/app/com.dotfloat.ImDoom64/data/imdoom64.

Windows

The game will look for files in the same location the Doom64.exe.

Community

Discord