metaforce

메타포스

Metroid Prime을 리버스 엔지니어링하여 기본적으로 다시 구현한 것입니다.

이 프로젝트는 현재 알파 상태입니다.
프로젝트가 크게 변경되는 동안에는 현재 빌드를 사용할 수 없습니다.

이와 별도로 Metroid Prime의 일치하는 디컴파일이 현재 진행 중입니다. 기여를 환영합니다.
디컴파일의 진행은 버그 수정 및 새로운 구현을 통해 Metaforce에 도움이 됩니다.

플랫폼 지원

• Windows 10 이상(64비트, D3D12/Vulkan/OpenGL)
• macOS 10.15+(메탈)
• 리눅스(Vulkan/OpenGL)
  • 배포판에 Vulkan 및 적절한 드라이버를 설정하려면 이 가이드를 따르세요.

용법

윈도우:

• metaforce.exe 엽니다.

맥OS:

• Metaforce.app 열기

리눅스:

• AppImage가 실행 가능으로 표시되었는지 확인: chmod +x Metaforce-*.AppImage
• Metaforce-*.AppImage 열기

CLI 옵션(일부)

• -l : 콘솔 로깅 활성화
• --warp [worldid] [areaid] : 특정 세계/지역으로 워프합니다. 예: --warp 2 2
• +developer=1 : 개발자 UI 활성화

빌드 전제 조건:

• CMake 3.15+
  • Windows: Visual Studio에 CMake Tools 설치
  • macOS: brew install cmake
• 파이썬 3+
  • 윈도우: 마이크로소프트 스토어
    • cmd 에 python 입력하여 %PATH% 에 추가되었는지 확인하세요.
  • macOS: brew install python@3
• [윈도우] Visual Studio 2019 커뮤니티
  • C++ Development 선택하고 다음 패키지가 포함되어 있는지 확인합니다.
    • Windows 10 SDK
    • CMake Tools
    • C++ Clang Compiler
    • C++ Clang-cl
• [macOS] Xcode 11.5+
• [Linux] Ubuntu 20.04, Arch Linux 및 파생 제품에서 적극적으로 테스트되었습니다.
  • 우분투 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
    

  • 아치 리눅스 패키지

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

  • 페도라 패키지

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

    • 개발자 도구와 라이브러리를 설치하는 것도 중요합니다.

       sudo dnf groupinstall "Development Tools" "Development Libraries"
      

준비 방향

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

방향 업데이트

 cd metaforce
git pull
git submodule update --recursive

건축 방향

Windows의 경우 Visual Studio를 사용하는 것이 좋습니다. 아래를 참조하세요.

닌자 (Windows/macOS/Linux)

기본적으로 RelWithDebInfo 사용하여 빌드합니다.

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

CMake 구성 옵션

• 디버그 모드에서 빌드(런타임 속도는 느려지고 역추적은 향상됨): -DCMAKE_BUILD_TYPE=Debug
• clang+lld 사용(더 빠른 연결): -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++
• 현재 CPU에 맞게 최적화(결과 바이너리는 이식 가능하지 않음): -DMETAFORCE_VECTOR_ISA=native

CLion(Windows/macOS/Linux)

(주요 개발/디버깅 IDE)

저장소의 CMakeLists.txt 엽니다.

필요에 따라 File > Settings > Build, Execution, Deployment > CMake 통해 CMake 옵션을 구성합니다.

Qt 크리에이터(윈도우/맥OS/리눅스)

파일 > 파일 또는 프로젝트 열기를 통해 저장소의 CMakeLists.txt 엽니다.

IDE의 프로젝트 영역에서 빌드할 원하는 CMake 대상을 구성합니다.

비주얼 스튜디오(윈도우)

위의 빌드 필수 구성 요소 섹션에서 필요한 모든 VS 패키지가 설치되었는지 확인하세요.

Visual Studio에서 metaforce 디렉터리를 엽니다(CMake 구성 가져오기).

MSVC 및 clang-cl 구성을 자동으로 가져와야 합니다.

Xcode(맥OS)

cmake -G Xcode ../metaforce

그런 다음 metaforce.xcodeproj 엽니다.