본문으로 건너뛰기
오픈소스 전체 목록

nxnative

  • 추천0
  • GitHub 별16K
  • 게임라이선스MIT

내가 가진 스위치 게임을 에뮬레이터 없이 아이폰·아이패드·맥 앱으로 바꿔 줘요. 직접 가진 게임만 쓰세요(MIT)

원본:seedds/nxnative

요약

내가 가진 스위치 게임을 에뮬레이터 없이 아이폰·아이패드·맥 앱으로 바꿔 줘요. 직접 가진 게임만 쓰세요(MIT)

설명

nxnative

내가 가진 닌텐도 스위치 · 스위치 2 게임을 애플 실리콘 Mac, 아이폰, 아이패드에서 네이티브로 즐기세요. 스크립트 하나가 게임을 Mac 앱이나 사이드로딩할 서명 없는 IPA로 묶어 줍니다.

에뮬레이터가 아닙니다. 게임의 코드가 애플 칩에서 그대로 돌아가고, 스위치 그래픽은 Metal 위에 다시 만들었습니다. 이 저장소에는 어떤 게임의 데이터도 들어 있지 않고, 이 프로젝트는 닌텐도나 게임 퍼블리셔와 관련이 없습니다.

게임 · 커뮤니티 프런트엔드 · 요구 사항 · 플레이 방법 · 토론 · 개발자용

게임

전체 시험한 게임 표에는 원래 스위치 게임, 시험한 빌드, 엔진, 그래픽 API가 들어 있습니다. 각 게임의 노트에는 시험한 플랫폼, 진행 상황, 알려진 문제가 적혀 있습니다.

아래 스위치 2 게임은 Mac에서 게임플레이 시험을 통과했습니다. .nup 파일이나 덤프 폴더로 빌드하세요.

커뮤니티 프런트엔드

커뮤니티 프로젝트들이 nxnative 위에서, 명령줄 없이 내 게임을 아이폰 · 아이패드 · Mac용 앱으로 바꾸는 도구와 앱을 정리하고 실행하는 라이브러리를 만들고 있습니다. 별개의 프로젝트이므로, 그 도구의 질문과 버그는 각자의 페이지로 보내세요.

  • NX2Apple — 아이폰/아이패드 게임 라이브러리를 함께 쓰는 Mac 빌더.
  • NX Play — 기기 설치와 저장 데이터 동기화를 지원하는 Mac 라이브러리.
  • NxNative Launcher — 단계별 빌드 안내와 컨트롤러 매핑이 있는 Mac 런처.
  • LumaNX — IPA 내보내기를 지원하는 Mac 게임 빌더.
  • GameCase — LiveContainer 기반의 iOS 게임 라이브러리.

요구 사항

  • Mac: 애플 실리콘, macOS 26.6 이상. 게임을 빌드하려면 Xcode 27.2가 필요합니다.
  • 아이폰: A17 Pro 칩 이상, iOS 26 이상.
  • 아이패드: M1 칩 이상, iPadOS 26 이상.

게임의 텍스처는 BC 압축이라 오래된 아이폰은 읽지 못합니다. 스위치 2 빌드는 Mac에서 시험했으니, 기기별 확인 결과는 각 게임의 노트를 보세요.

프로파일이 없는 게임은 스크립트가 조사 결과를 쓰고 추측한 설정으로 임시 빌드를 시도합니다. 그 빌드는 시작되지 않을 수도 있습니다. 다른 게임 이식하기를 보세요.

플레이 방법

스위치 2 게임은 NSP가 아니라 .nup 파일 하나나 게임 파일 폴더로 빌드하며 Mac에서만 시험했습니다. 스위치 2 게임을 보세요.

명령줄로 빌드하기

macOS 26.6 이상의 Mac, Xcode 27.2, Homebrew, Python 3.12 이상(Intel Homebrew가 아닌 arm64 버전)이 필요합니다. 아이폰용 빌드에는 Xcode의 iOS 플랫폼도 필요합니다(Xcode → Settings → Components).

셰이더는 Xcode 27.2의 Metal 컴파일러로 빌드합니다. 1단계 전에 그 Xcode를 선택하세요: sudo xcode-select -s /Applications/Xcode.app. Xcode 버전이 여러 개 설치돼 있으면 이것의 이름을 Xcode-27.2.app으로 바꾸고 sudo xcode-select -s /Applications/Xcode-27.2.app으로 선택하세요.

1. 도구 설치 (처음 한 번만), 터미널에서:

xcodebuild -downloadComponent MetalToolchain
git clone https://github.com/seedds/nxnative.git && cd nxnative
brew install xcodegen zstd glslang
python3 -m pip install lz4 "capstone>=5,<6" fonttools nsz zbic "backports.zstd; python_version < '3.14'"

2. 게임을 폴더에 넣기: 게임, 그리고 있다면 업데이트와 DLC(.nsp, .xci, .nsz, .xcz):

~/Games/MarioWonder/
  Super Mario Bros. Wonder [010015100B514000][v0].nsp
  Super Mario Bros. Wonder [010015100B514800][v327680].nsp

3. 빌드, 게임 폴더와 prod.keys를 넣어서:

python3 scripts/build_ipa_from_nsp.py ~/Games/MarioWonder -k ~/keys/prod.keys

IPA는 게임 폴더에 생깁니다. 첫 빌드는 30~60분이 걸리고 게임 크기의 약 2배 + 10GB의 여유 디스크 공간이 필요합니다. 다시 빌드하면 훨씬 빠릅니다.

Mac에서 하려면 --platform mac-app을 붙이세요. Finder에서 열 수 있는 게임 Mac 앱이 만들어집니다. 모든 옵션: 패킹 스크립트 자세히.

설치

AltStore, Sideloadly, LiveContainer 같은 사이드로딩 도구로 IPA를 아이폰이나 아이패드에 설치하세요. 도구에 Increased Memory Limit이 있으면 켜세요. 큰 게임에는 필요합니다.

게임이 너무 커서 설치가 안 되나요? --romfs separate로 다시 빌드하고, 스크립트가 출력하는 명령을 한 번 실행해 게임 파일을 폰에 복사하세요(빠른 재설치). AltServer를 쓰면 --shader-files도 붙이세요. 2GiB 이상의 파일은 설치하지 못합니다.

조작, 저장, 설정: Playing.

스위치 2 게임

스위치 2 게임은 NSP가 아니라 하나의 NUP 컨테이너(.nup 파일)나 그 파일들의 폴더로 빌드합니다. 둘 다 prod.keys는 필요 없습니다. 이 프로젝트에 프로파일이 없는 게임은 NSP처럼 조사한 뒤 임시 프로파일을 받으며(다른 게임 이식하기), 부팅되지 않을 수도 있습니다. 결과물은 Mac 앱이고 아이폰과 아이패드는 아직 시험하지 않았습니다.

.nup 파일로: 기본 게임, 업데이트, DLC가 파일 하나에 들어 있습니다. 파일이나 그 파일이 든 폴더를 주세요.

python3 scripts/build_ipa_from_nsp.py ~/Games/DonkeyKongBananza.nup --platform mac-app

Hyrule Warriors: Age of Imprisonment가 이 방식으로 플레이됩니다. 47GB NUP이 5분 안에 풀립니다. NUP에 게임의 제어 데이터(NACP)와 아이콘이 들어 있으면 앱이 게임의 이름과 아이콘을 받습니다. 그렇지 않으면 이름은 게임 프로파일에서 오고, --icon <image>(Spyder에서는 ICON, 크기 상관없는 JPEG 또는 PNG)로 주지 않는 한 앱에는 아이콘이 없습니다.

스위치 1 게임의 닌텐도 스위치 2 에디션은 두 프로그램을 NUP 하나에 담을 수 있습니다. 게임 데이터가 있는 스위치 1 프로그램과, 그 데이터를 스위치 1 프로그램에서 읽고 스위치 2 파일은 업그레이드 애드온에서 읽는 스위치 2 프로그램입니다. 스크립트는 스위치 2 프로그램을 패킹하고, 스위치 1 프로그램의 게임 파일을 그 옆에, 애드온을 DLC로 함께 넣습니다. --program 0은 스위치 1 프로그램을 패킹합니다.

기본 게임이 없는 NUP도 됩니다. 기본 패키지가 비어 있거나 없고 업데이트가 standalone_update로 표시돼 있으면, 그 업데이트를 게임 전체로 보고 스크립트가 그렇게 알려 줍니다. 그러다 게임이 파일 누락으로 멈추면, 그 업데이트에는 바뀐 부분만 들어 있는 것입니다. 기본 게임이 든 NUP으로 패킹하세요. 가장 새 업데이트가 기본으로 선택되고, --package v<N>으로 컨테이너의 다른 버전을 고릅니다. 이런 컨테이너에는 선택할 v0(기본 게임)이 없습니다.

게임 파일 폴더로. 스크립트는 이 구성을 기대합니다(updates와 dlc는 선택).

~/Games/DonkeyKongBananza/
  base/exefs/                     main, main.npdm, sdk, rtld
  base/romfs/
  updates/458752/exefs/           업데이트 버전, 10진수 숫자로
  updates/458752/romfs/           패치가 아니라 패치가 적용된 RomFS
  dlc/040074a01bf13001/0/romfs/   DLC의 타이틀 ID
python3 scripts/build_ipa_from_nsp.py ~/Games/DonkeyKongBananza --platform mac-app

업데이트 폴더만 있어도 되고(base/ 없이), nup extract가 쓰는 대로 폴더에 exefs/와 romfs/가 바로 있어도 됩니다. 이것들은 base/로 칩니다. 폴더에는 아이콘이 없어서 앱에도 아이콘이 없습니다. --icon <image>(Spyder에서는 ICON)로 줄 수 있습니다. 이런 폴더를 NUP으로 만들려면: nup pack ~/Games/DonkeyKongBananza game.nup.

토론

질문, 내 Mac이나 아이폰에서 게임이 어떻게 도는지, 아이디어는 Discussions에 올리세요. Issues는 로그와 함께 버그를 올리는 곳입니다. 오카리나 오브 타임의 성능(프레임, 해상도, 60fps를 유지하는 Mac)은 Ocarina of Time: state on main에서 추적합니다.

개발자용

작동 방식 · 게임 노트 · 부팅과 디버깅 · 프런트엔드 · 기여하기

감사의 말

이 프로젝트는 다른 사람들의 작업 위에 지어졌습니다(라이선스).

  • d2r-mobile(MIT)이 디아블로 II: 레저렉션을 위해 이 네이티브 실행 방식을 개발했습니다. nxnative는 그 범용 부분의 복사본에서 시작했습니다. NSO 재작성기, Horizon을 대신하는 호스트, Metal 위의 NVN 계층, iOS 앱 껍데기입니다. 수정은 양쪽으로 오갑니다.
  • Ryujinx(MIT): 셰이더 변환기(Ryujinx.Graphics.Shader, Ryujinx.Common, Spv.Generator 1.3.2는 dm/third_party/ryujinx에 있고 몇 가지 수정은 그 README에 적혀 있습니다)가 게임의 셰이더를 SPIR-V로 바꿉니다. 커널과 시스템 서비스의 에뮬레이션도 호스트의 동작이 의심스러울 때 참고합니다.
  • Atmosphère: 그 커널 mesosphère는 Horizon의 동기화 의미(주소 중재자, 조건 변수)의 기준입니다.
  • LibHac: dm/tools/nx_extract에서 NSP를 읽고 업데이트를 기본 게임 위에 겹칩니다.
  • SPIRV-Cross: SPIR-V를 Metal Shading Language로.
  • **glslang**이 OpenGL 게임의 GLSL을 그것을 위해 SPIR-V로 컴파일합니다.
  • MacNativeGames(MIT): dm/gfx/nvn/nvn_mtl.m의 8비트 인덱스 GPU 확장과 패스 내 클리어, 셰이더 변환기의 가시성 카운터 낮추기.

라이선스

MIT(LICENSE). 서드파티 코드는 각자의 라이선스를 따릅니다(dm/third_party).

💡 안내: 이 프로젝트는 내가 가진 게임을 직접 추출해 쓰는 용도입니다. 게임 파일이나 완성된 앱을 공유하면 게임 배포가 되므로 하지 마세요.

저장소: https://github.com/seedds/nxnative

평점

–평가 0개 기준
5점
0
4점
0
3점
0
2점
0
1점
0