metaforce

Métaforce

Une réimplémentation native par ingénierie inverse de Metroid Prime.

Ce projet est actuellement en état alpha .
Les builds sont actuellement indisponibles alors que le projet subit de grands changements.

Par ailleurs, une décompilation correspondante de Metroid Prime est actuellement en cours. Les contributions sont les bienvenues.
Les progrès sur la décompilation profitent à Metaforce avec des corrections de bugs et de nouvelles implémentations.

Prise en charge de la plateforme

• Windows 10+ (64 bits, D3D12/Vulkan/OpenGL)
• macOS 10.15+ (Métal)
• Linux (Vulkan/OpenGL)
  • Suivez ce guide pour configurer Vulkan et les pilotes appropriés pour votre distribution.

Usage

Fenêtres :

• Ouvrez metaforce.exe

macOS :

• Ouvrez Metaforce.app

Linux :

• Assurez-vous qu'AppImage est marqué comme exécutable : chmod +x Metaforce-*.AppImage
• Ouvrez Metaforce-*.AppImage

Options CLI (non exhaustives)

• -l : Activer la journalisation de la console
• --warp [worldid] [areaid] : Déformation vers un monde/une zone spécifique. Exemple : --warp 2 2
• +developer=1 : Activer l'interface utilisateur du développeur

Conditions préalables à la construction :

• CMake 3.15+
  • Windows : installez CMake Tools dans Visual Studio
  • macOS : brew install cmake
• Python 3+
  • Windows : Microsoft Store
    • Vérifiez qu'il est ajouté à %PATH% en tapant python dans cmd .
  • macOS : brew install python@3
• [Windows] Communauté Visual Studio 2019
  • Sélectionnez C++ Development et vérifiez que les packages suivants sont inclus :
    • Windows 10 SDK
    • CMake Tools
    • C++ Clang Compiler
    • C++ Clang-cl
• [macOS] Xcode 11.5+
• [Linux] Testé activement sur Ubuntu 20.04, Arch Linux et dérivés.
  • Forfaits 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
    

  • Paquets Arch Linux

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

  • Paquets Fedora

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

    • Il est également important que vous installiez les outils de développement et les bibliothèques

       sudo dnf groupinstall "Development Tools" "Development Libraries"
      

Instructions de préparation

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

Mettre à jour les instructions

 cd metaforce
git pull
git submodule update --recursive

Instructions de construction

Pour Windows, il est recommandé d'utiliser Visual Studio. Voir ci-dessous.

ninja (Windows/macOS/Linux)

Construit en utilisant RelWithDebInfo par défaut.

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

CMake configurer les options

• Construire en mode débogage (vitesse d'exécution plus lente, meilleures traces) : -DCMAKE_BUILD_TYPE=Debug
• Utilisez clang+lld (liaison plus rapide) : -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++
• Optimiser pour le processeur actuel (les binaires résultants ne sont pas portables) : -DMETAFORCE_VECTOR_ISA=native

CLion (Windows/macOS/Linux)

(EDI principal de développement/débogage)

Ouvrez le CMakeLists.txt du référentiel.

Configurez éventuellement les options CMake via File > Settings > Build, Execution, Deployment > CMake .

Créateur Qt (Windows/macOS/Linux)

Ouvrez le CMakeLists.txt du référentiel via Fichier > Ouvrir un fichier ou un projet.

Configurez les cibles CMake souhaitées à créer dans la zone Projets de l'EDI.

Visual Studio (Windows)

Vérifiez que tous les packages VS requis sont installés à partir de la section Conditions préalables à la construction ci-dessus.

Ouvrez le répertoire metaforce dans Visual Studio (importe la configuration CMake).

Les configurations MSVC et clang-cl devraient être importées automatiquement.

Xcode (macOS)

cmake -G Xcode ../metaforce

Ensuite, ouvrez metaforce.xcodeproj