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