Metaforce

Metaforce is a reverse-engineered reimplementation of the engine from Metroid Prime, which started development in June of 2015 by Cirrus and Antidote. It is a labor of love, built with deep respect for the incredible work of the original developers at Retro Studios in the late 90s and early 2000s.

We want to acknowledge the passing of two exceptionally talented developers, Mark Haigh-Hutchinson and Andy O'Neil, whose work helped shape this game. We'd also like to thank former Retro developers like Zoid Kirsch and Jack Matthews for their seemingly endless talent, friendliness, and encouragement.

Metaforce was recently rewritten on top of the Metroid Prime matching decompilation. Builds are currently unavailable as the project stabilizes.

Platform Support

• Windows 10+ (64-bit, D3D12 / Vulkan / D3D11)
• macOS 10.15+ (Metal)
• Linux (Vulkan)
• Android (Vulkan & OpenGL ES)
• iOS (Metal)

Usage

Windows:

• Open metaforce.exe

macOS:

• Open Metaforce.app

Linux:

• Ensure AppImage is marked as executable: chmod +x Metaforce-*.AppImage
• Open Metaforce-*.AppImage

CLI options (non-exhaustive)

• -l: Enable console logging
• --warp [worldid] [areaid]: Warp to a specific world/area. Example: --warp 2,2
• --load-save [1, 2, 3]: Loads numbered save in Memory Card A
• --lock-aspect: Lock Metaforce to original game 4:3 aspect ratio.

Build Prerequisites:

• CMake 3.25+
  • Windows: Install CMake Tools in Visual Studio
  • macOS: brew install cmake
• Python 3+
  • Windows: Microsoft Store
    • Verify it's added to %PATH% by typing python in cmd.
  • macOS: brew install python@3
• [Windows] Visual Studio 2019 Community
  • Select C++ Development and verify the following packages are included:
    • Windows 10 SDK
    • CMake Tools
    • C++ Clang Compiler
    • C++ Clang-cl
• [macOS] Xcode 11.5+
• [Linux] Actively tested on Ubuntu 20.04, Arch Linux & derivatives.
  • Ubuntu 20.04+ packages

    build-essential curl git ninja-build clang lld zlib1g-dev libcurl4-openssl-dev \
    libglu1-mesa-dev libdbus-1-dev libvulkan-dev libxi-dev libxrandr-dev libasound2-dev libpulse-dev \
    libudev-dev libpng-dev libncurses5-dev cmake libx11-xcb-dev python3 python-is-python3 \
    libclang-dev libfreetype-dev libxinerama-dev libxcursor-dev python3-markupsafe libgtk-3-dev
    

  • Arch Linux packages

    base-devel cmake ninja llvm vulkan-headers python python-markupsafe clang lld alsa-lib libpulse libxrandr freetype2
    

  • Fedora packages

    cmake vulkan-headers ninja-build clang-devel llvm-devel libpng-devel
    

    • It's also important that you install the developer tools and libraries

      sudo dnf groupinstall "Development Tools" "Development Libraries"
      

Prep Directions

git clone --recursive https://github.com/AxioDL/metaforce.git
cd metaforce

Update Directions

cd metaforce
git pull
git submodule update --init --recursive

Build Directions

For Windows, it's recommended to use CLion or Visual Studio. See below.

ninja (Windows/macOS/Linux)

You can either build Metaforce with the built in Build workflows in VSCode, CLion, etc; or use CLI.

cmake --preset relwithdebinfo
Cmake --build --preset relwithdebinfo

CLion (Windows/macOS/Linux)

(main development / debugging IDE)

Open the repository's CMakeLists.txt.

Optionally configure CMake options via File > Settings > Build, Execution, Deployment > CMake.

Qt Creator (Windows/macOS/Linux)

Open the repository's CMakeLists.txt via File > Open File or Project.

Configure the desired CMake targets to build in the Projects area of the IDE.

Visual Studio (Windows)

Verify all required VS packages are installed from the above Build Prerequisites section.

Open the metaforce directory in Visual Studio (imports CMake configuration).

MSVC and clang-cl configurations should import automatically.

Xcode (macOS)

cmake -G Xcode ../metaforce

Then open metaforce.xcodeproj