metaforce

Metaforça

Uma reimplementação nativa de engenharia reversa de Metroid Prime.

Este projeto está atualmente em estado alfa .
As compilações estão indisponíveis no momento enquanto o projeto passa por grandes mudanças.

Separadamente, uma descompilação correspondente de Metroid Prime está em andamento. Contribuições são bem-vindas.
O progresso na descompilação beneficia o Metaforce com correções de bugs e novas implementações.

Suporte de plataforma

• Windows 10+ (64 bits, D3D12/Vulkan/OpenGL)
• macOS 10.15+ (metal)
• Linux (Vulkan/OpenGL)
  • Siga este guia para configurar o Vulkan e os drivers apropriados para sua distribuição.

Uso

Windows:

• Abra metaforce.exe

macOS:

• Abra Metaforce.app

Linux:

• Certifique-se de que AppImage esteja marcado como executável: chmod +x Metaforce-*.AppImage
• Abra Metaforce-*.AppImage

Opções CLI (não exaustivas)

• -l : Habilita o log do console
• --warp [worldid] [areaid] : Warp para um mundo/área específico. Exemplo: --warp 2 2
• +developer=1 : Habilitar UI do desenvolvedor

Pré-requisitos de construção:

• CMake 3.15+
  • Windows: instale CMake Tools no Visual Studio
  • macOS: brew install cmake
• Pitão 3+
  • Windows: Microsoft Store
    • Verifique se ele foi adicionado a %PATH% digitando python em cmd .
  • macOS: brew install python@3
• [Windows] Comunidade do Visual Studio 2019
  • Selecione C++ Development e verifique se os seguintes pacotes estão incluídos:
    • Windows 10 SDK
    • CMake Tools
    • C++ Clang Compiler
    • C++ Clang-cl
• [macOS] Xcode 11.5+
• [Linux] Testado ativamente no Ubuntu 20.04, Arch Linux e derivados.
  • Pacotes 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
    

  • Pacotes Arch Linux

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

  • Pacotes Fedora

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

    • Também é importante que você instale as ferramentas e bibliotecas do desenvolvedor

       sudo dnf groupinstall "Development Tools" "Development Libraries"
      

Instruções de preparação

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

Atualizar direções

 cd metaforce
git pull
git submodule update --recursive

Direções de construção

Para Windows, é recomendado usar o Visual Studio. Veja abaixo.

ninja (Windows/macOS/Linux)

Compila usando RelWithDebInfo por padrão.

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

Opções de configuração do CMake

• Compilar em modo de depuração (velocidade de execução mais lenta, melhores backtraces): -DCMAKE_BUILD_TYPE=Debug
• Use clang+lld (vinculação mais rápida): -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++
• Otimizar para CPU atual (os binários resultantes não são portáveis): -DMETAFORCE_VECTOR_ISA=native

CLion (Windows/macOS/Linux)

(IDE principal de desenvolvimento/depuração)

Abra o CMakeLists.txt do repositório.

Opcionalmente, configure as opções do CMake por meio de File > Settings > Build, Execution, Deployment > CMake .

Criador Qt (Windows/macOS/Linux)

Abra o CMakeLists.txt do repositório via Arquivo > Abrir Arquivo ou Projeto.

Configure os destinos CMake desejados para construir na área Projetos do IDE.

Visual Studio (Windows)

Verifique se todos os pacotes VS necessários estão instalados na seção Pré-requisitos de compilação acima.

Abra o diretório metaforce no Visual Studio (importa a configuração do CMake).

As configurações MSVC e clang-cl devem ser importadas automaticamente.

Xcode (macOS)

cmake -G Xcode ../metaforce

Em seguida, abra metaforce.xcodeproj