metaforce

Metaforce

Eine rückentwickelte, native Neuimplementierung von Metroid Prime.

Dieses Projekt befindet sich derzeit im Alpha- Status.
Builds sind derzeit nicht verfügbar, da am Projekt große Änderungen vorgenommen werden.

Unabhängig davon ist derzeit eine entsprechende Dekompilierung von Metroid Prime im Gange. Beiträge sind willkommen.
Fortschritte bei der Dekompilierung kommen Metaforce durch Fehlerbehebungen und neue Implementierungen zugute.

Plattformunterstützung

• Windows 10+ (64-Bit, D3D12 / Vulkan / OpenGL)
• macOS 10.15+ (Metal)
• Linux (Vulkan / OpenGL)
  • Befolgen Sie diese Anleitung, um Vulkan und geeignete Treiber für Ihre Distribution einzurichten.

Verwendung

Windows:

• Öffnen Sie metaforce.exe

macOS:

• Öffnen Sie Metaforce.app

Linux:

• Stellen Sie sicher, dass AppImage als ausführbare Datei markiert ist: chmod +x Metaforce-*.AppImage
• Öffnen Sie Metaforce-*.AppImage

CLI-Optionen (nicht erschöpfend)

• -l : Konsolenprotokollierung aktivieren
• --warp [worldid] [areaid] : Warp zu einer bestimmten Welt/einem bestimmten Bereich. Beispiel: --warp 2 2
• +developer=1 : Entwickler-Benutzeroberfläche aktivieren

Build-Voraussetzungen:

• CMake 3.15+
  • Windows: Installieren Sie CMake Tools in Visual Studio
  • macOS: brew install cmake
• Python 3+
  • Windows: Microsoft Store
    • Überprüfen Sie, ob es zu %PATH% hinzugefügt wurde, indem Sie python in cmd eingeben.
  • macOS: brew install python@3
• [Windows] Visual Studio 2019-Community
  • Wählen Sie C++ Development aus und überprüfen Sie, ob die folgenden Pakete enthalten sind:
    • Windows 10 SDK
    • CMake Tools
    • C++ Clang Compiler
    • C++ Clang-cl
• [macOS] Xcode 11.5+
• [Linux] Aktiv getestet auf Ubuntu 20.04, Arch Linux und Derivaten.
  • Ubuntu 20.04+ Pakete

     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-Pakete

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

  • Fedora-Pakete

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

    • Es ist auch wichtig, dass Sie die Entwicklertools und -bibliotheken installieren

       sudo dnf groupinstall "Development Tools" "Development Libraries"
      

Vorbereitungsanweisungen

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

Wegbeschreibung aktualisieren

 cd metaforce
git pull
git submodule update --recursive

Bauanweisungen

Für Windows wird die Verwendung von Visual Studio empfohlen. Siehe unten.

Ninja (Windows/macOS/Linux)

Builds verwenden standardmäßig RelWithDebInfo .

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

CMake-Konfigurationsoptionen

• Im Debug-Modus erstellen (langsamere Laufzeitgeschwindigkeit, bessere Backtraces): -DCMAKE_BUILD_TYPE=Debug
• Verwenden Sie clang+lld (schnellere Verknüpfung): -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++
• Für die aktuelle CPU optimieren (resultierende Binärdateien sind nicht portierbar): -DMETAFORCE_VECTOR_ISA=native

CLion (Windows/macOS/Linux)

(Hauptentwicklungs-/Debugging-IDE)

Öffnen Sie die CMakeLists.txt des Repositorys.

Konfigurieren Sie optional CMake-Optionen über File > Settings > Build, Execution, Deployment > CMake .

Qt Creator (Windows/macOS/Linux)

Öffnen Sie die CMakeLists.txt des Repositorys über Datei > Datei oder Projekt öffnen.

Konfigurieren Sie die gewünschten CMake-Ziele für die Erstellung im Projektbereich der IDE.

Visual Studio (Windows)

Überprüfen Sie im obigen Abschnitt „Build-Voraussetzungen“, ob alle erforderlichen VS-Pakete installiert sind.

Öffnen Sie das metaforce Verzeichnis in Visual Studio (importiert die CMake-Konfiguration).

MSVC- und clang-cl-Konfigurationen sollten automatisch importiert werden.

Xcode (macOS)

cmake -G Xcode ../metaforce

Öffnen Sie dann metaforce.xcodeproj