AngheloAlf / drmario64_recomp

drmario64_recomp

Important

This is just a repository for testing the recompilation technology. I won't make a release for this recompiled game. Don't ask for feature requests

Known issues

• The pills do not get drawn correctly when falling during the game. Meaning that the game is mostly unplayable for most humans (the CPU bot doesn't care and will play anyways).
• There's no multiple controller support. So just 1 player at a time.

Dependencies

• git

• C (c17) and C++ (c++20) compilers

• SDL2

  • This has to be installed from source under Linux.

  • For example:

    wget https://www.libsdl.org/release/SDL2-2.26.1.tar.gz
    tar -xzf SDL2-2.26.1.tar.gz
    cd SDL2-2.26.1
    ./configure
    make -j $(nproc)
    sudo make install

• libgtk-3-dev

Build

The listed commits are known to be able to build this repository.

• Clone with submodules (git clone --recurse-submodules or git submodule update --init --recursive).
• Build the decomp repo (https://github.com/AngheloAlf/drmario64, commit 1258578aea8053cf818cd1dda3e70829747b9ab7)
  • Once it is built successfully, grab build/us/drmario64.us.elf and build/us/drmario64_uncompressed.us.z64 and put them in the root of this project.
• Build the N64Recomp repo (https://github.com/Mr-Wiseguy/N64Recomp, commit 6eb7d5bd3ee7f0b79f3fd7adbe931dccbacf7e1b).
• Run path/to/N64Recomp/build/N64Recomp drmario64.us.toml on the root of this project.
• Run path/to/N64Recomp/build/RSPRecomp aspMain.us.toml on the root of this project.
• Build this repo by running cmake -B build/ and then cmake --build build --parallel $(nproc).

This game expects a vanilla US ROM to run, don't use the uncompressed one from the decomp.

Libraries Used and Projects Referenced

• Zelda64Recomp (commit 452d2af06767d82be960e027dd14b9c4f0e8bf31) most files were copied from here.
• Dr. Mario 64 decompilation
• RT64 for the project's rendering engine
• moodycamel::ConcurrentQueue for semaphores and fast, lock-free MPMC queues
• Gamepad Motion Helpers for sensor fusion and calibration algorithms to implement gyro aiming