metaforce

metafuerza

Una reimplementación nativa de Metroid Prime mediante ingeniería inversa.

Este proyecto se encuentra actualmente en estado alfa .
Actualmente, las compilaciones no están disponibles mientras el proyecto sufre grandes cambios.

Por otra parte, actualmente se está llevando a cabo una descompilación correspondiente de Metroid Prime. Las contribuciones son bienvenidas.
El progreso en la descompilación beneficia a Metaforce con correcciones de errores y nuevas implementaciones.

Soporte de plataforma

• Windows 10+ (64 bits, D3D12/Vulkan/OpenGL)
• macOS 10.15+ (metal)
• Linux (Vulkan/OpenGL)
  • Siga esta guía para configurar Vulkan y los controladores adecuados para su distribución.

Uso

Ventanas:

• Abrir metaforce.exe

MacOS:

• Abra Metaforce.app

Linux:

• Asegúrese de que AppImage esté marcado como ejecutable: chmod +x Metaforce-*.AppImage
• Abra Metaforce-*.AppImage

Opciones CLI (no exhaustivas)

• -l : habilitar el registro de la consola
• --warp [worldid] [areaid] : Deformar a un mundo/área específica. Ejemplo: --warp 2 2
• +developer=1 : Habilitar la interfaz de usuario del desarrollador

Requisitos previos de construcción:

• CMake 3.15+
  • Windows: instale CMake Tools en Visual Studio
  • macOS: brew install cmake
• Pitón 3+
  • Windows: Tienda Microsoft
    • Verifique que esté agregado a %PATH% escribiendo python en cmd .
  • macOS: brew install python@3
• [Windows] Comunidad de Visual Studio 2019
  • Seleccione C++ Development y verifique que se incluyan los siguientes paquetes:
    • Windows 10 SDK
    • CMake Tools
    • C++ Clang Compiler
    • C++ Clang-cl
• [macOS] Xcode 11.5+
• [Linux] Probado activamente en Ubuntu 20.04, Arch Linux y derivados.
  • Paquetes de 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
    

  • Paquetes ArchLinux

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

  • Paquetes Fedora

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

    • También es importante que instales las herramientas y bibliotecas de desarrollador.

       sudo dnf groupinstall "Development Tools" "Development Libraries"
      

Instrucciones de preparación

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

Actualizar direcciones

 cd metaforce
git pull
git submodule update --recursive

Instrucciones de construcción

Para Windows, se recomienda utilizar Visual Studio. Vea abajo.

ninja (Windows/macOS/Linux)

Se compila utilizando RelWithDebInfo de forma predeterminada.

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

Opciones de configuración de CMake

• Construir en modo de depuración (velocidad de ejecución más lenta, mejores rastreos): -DCMAKE_BUILD_TYPE=Debug
• Utilice clang+lld (enlace más rápido): -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++
• Optimizar para la CPU actual (los archivos binarios resultantes no son portátiles): -DMETAFORCE_VECTOR_ISA=native

CLion (Windows/macOS/Linux)

(IDE principal de desarrollo/depuración)

Abra CMakeLists.txt del repositorio.

Opcionalmente, configure las opciones de CMake a través de File > Settings > Build, Execution, Deployment > CMake .

Creador de Qt (Windows/macOS/Linux)

Abra CMakeLists.txt del repositorio a través de Archivo > Abrir archivo o proyecto.

Configure los objetivos de CMake que desee para compilar en el área Proyectos del IDE.

Estudio Visual (Windows)

Verifique que todos los paquetes VS requeridos estén instalados desde la sección Requisitos previos de compilación anterior.

Abra el directorio metaforce en Visual Studio (importa la configuración de CMake).

Las configuraciones de MSVC y clang-cl deberían importarse automáticamente.

Xcode (macOS)

cmake -G Xcode ../metaforce

Luego abra metaforce.xcodeproj