metaforce

元力

银河战士 Prime 的逆向工程、原生重新实现。

该项目目前处于alpha状态。
当项目发生较大变化时，当前无法进行构建。

另外，Metroid Prime 的反编译工作目前正在进行中。欢迎贡献。
反编译的进展通过错误修复和新的实现使 Metaforce 受益。

平台支持

• Windows 10+（64 位、D3D12/Vulkan/OpenGL）
• macOS 10.15+（金属）
• Linux（Vulkan/OpenGL）
  • 按照本指南为您的发行版设置 Vulkan 和适当的驱动程序。

用法

视窗：

• 打开metaforce.exe

苹果系统：

• 打开Metaforce.app

Linux：

• 确保 AppImage 标记为可执行文件： chmod +x Metaforce-*.AppImage
• 打开Metaforce-*.AppImage

CLI 选项（非详尽）

• -l ：启用控制台日志记录
• --warp [worldid] [areaid] ：扭曲到特定的世界/区域。示例： --warp 2 2
• +developer=1 ：启用开发者 UI

构建先决条件：

• CMake 3.15+
  • Windows：在 Visual Studio 中安装CMake Tools
  • macOS： brew install cmake
• Python 3+
  • Windows：微软商店
    • 通过在cmd中输入python来验证它是否已添加到%PATH%中。
  • macOS： brew install python@3
• [Windows] Visual Studio 2019 社区
  • 选择C++ Development并验证是否包含以下软件包：
    • Windows 10 SDK
    • CMake Tools
    • C++ Clang Compiler
    • C++ Clang-cl
• [macOS] Xcode 11.5+
• [Linux]在 Ubuntu 20.04、Arch Linux 及衍生版本上进行了积极测试。
  • Ubuntu 20.04+ 软件包

     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 软件包

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

  • Fedora 软件包

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

    • 安装开发人员工具和库也很重要

       sudo dnf groupinstall "Development Tools" "Development Libraries"
      

准备方向

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

更新路线

 cd metaforce
git pull
git submodule update --recursive

构建方向

对于 Windows，建议使用 Visual Studio。见下文。

忍者（Windows/macOS/Linux）

默认情况下使用RelWithDebInfo进行构建。

cmake -B out -G Ninja # add extra options here
cmake --build out --target metaforce hecl visigen

CMake 配置选项

• 在调试模式下构建（运行速度较慢，回溯更好）： -DCMAKE_BUILD_TYPE=Debug
• 使用 clang+lld （更快的链接）： -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++
• 针对当前 CPU 进行优化（生成的二进制文件不可移植）： -DMETAFORCE_VECTOR_ISA=native

CLion（Windows/macOS/Linux）

（主要开发/调试IDE）

打开存储库的CMakeLists.txt 。

（可选）通过File > Settings > Build, Execution, Deployment > CMake配置 CMake 选项。

Qt 创建者（Windows/macOS/Linux）

通过“文件”>“打开文件或项目”打开存储库的CMakeLists.txt 。

配置所需的 CMake 目标以在 IDE 的“项目”区域中构建。

视觉工作室（Windows）

验证所有必需的 VS 软件包均已从上述“构建先决条件”部分安装。

在 Visual Studio 中打开metaforce目录（导入 CMake 配置）。

MSVC 和 clang-cl 配置应自动导入。

Xcode（macOS）

cmake -G Xcode ../metaforce

然后打开metaforce.xcodeproj