metaforce

Metakekuatan

Implementasi ulang asli Metroid Prime yang direkayasa balik.

Proyek ini saat ini dalam keadaan alfa .
Pembangunan saat ini tidak tersedia sementara proyek mengalami perubahan besar.

Secara terpisah, dekompilasi yang cocok dari Metroid Prime saat ini sedang berlangsung. Kontribusi dipersilahkan.
Kemajuan dalam dekompilasi menguntungkan Metaforce dengan perbaikan bug dan implementasi baru.

Dukungan Platform

• Windows 10+ (64-bit, D3D12/Vulkan/OpenGL)
• macOS 10.15+ (Logam)
• Linux (Vulkan / OpenGL)
  • Ikuti panduan ini untuk mengatur Vulkan & driver yang sesuai untuk distro Anda.

Penggunaan

jendela:

• Buka metaforce.exe

macOS:

• Buka Metaforce.app

Linux:

• Pastikan AppImage ditandai sebagai dapat dieksekusi: chmod +x Metaforce-*.AppImage
• Buka Metaforce-*.AppImage

Opsi CLI (tidak lengkap)

• -l : Aktifkan logging konsol
• --warp [worldid] [areaid] : Warp ke dunia/area tertentu. Contoh: --warp 2 2
• +developer=1 : Aktifkan UI pengembang

Membangun Prasyarat:

• CMake 3.15+
  • Windows: Instal CMake Tools di Visual Studio
  • macOS: brew install cmake
• ular piton 3+
  • Windows: Toko Microsoft
    • Verifikasikan itu ditambahkan ke %PATH% dengan mengetikkan python di cmd .
  • macOS: brew install python@3
• [Windows] Komunitas Visual Studio 2019
  • Pilih C++ Development dan verifikasi paket berikut disertakan:
    • Windows 10 SDK
    • CMake Tools
    • C++ Clang Compiler
    • C++ Clang-cl
• [macOS] Xkode 11.5+
• [Linux] Diuji secara aktif di Ubuntu 20.04, Arch Linux & turunannya.
  • Paket 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
    

  • Paket Arch Linux

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

  • Paket Fedora

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

    • Penting juga bagi Anda untuk menginstal alat dan pustaka pengembang

       sudo dnf groupinstall "Development Tools" "Development Libraries"
      

Petunjuk Persiapan

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

Perbarui Petunjuk Arah

 cd metaforce
git pull
git submodule update --recursive

Membangun Petunjuk Arah

Untuk Windows, disarankan menggunakan Visual Studio. Lihat di bawah.

ninja (Windows/macOS/Linux)

Dibangun menggunakan RelWithDebInfo secara default.

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

CMake opsi konfigurasi

• Bangun dalam mode debug (kecepatan runtime lebih lambat, penelusuran balik lebih baik): -DCMAKE_BUILD_TYPE=Debug
• Gunakan clang+lld (tautan lebih cepat): -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++
• Optimalkan untuk CPU saat ini (biner yang dihasilkan tidak portabel): -DMETAFORCE_VECTOR_ISA=native

CLion (Windows/macOS/Linux)

(IDE pengembangan/debug utama)

Buka CMakeLists.txt repositori.

Konfigurasikan opsi CMake secara opsional melalui File > Settings > Build, Execution, Deployment > CMake .

Pembuat Qt (Windows/macOS/Linux)

Buka CMakeLists.txt repositori melalui File > Buka File atau Proyek.

Konfigurasikan target CMake yang diinginkan untuk dibangun di area Proyek IDE.

Visual Studio (jendela)

Verifikasi semua paket VS yang diperlukan telah diinstal dari bagian Prasyarat Pembuatan di atas.

Buka direktori metaforce di Visual Studio (mengimpor konfigurasi CMake).

Konfigurasi MSVC dan clang-cl harus diimpor secara otomatis.

Kode X (macOS)

cmake -G Xcode ../metaforce

Kemudian buka metaforce.xcodeproj