개요

nxnative는 사용자가 가진 닌텐도 스위치 게임을 iPhone·iPad(와 Mac)에서 네이티브로 돌리는 도구다. 에뮬레이터가 아니다. 게임 자체의 ARM64 코드를 고쳐 쓴 채 Apple 칩에서 곧장 실행하고, 스위치 그래픽(NVN)만 Metal 위에 다시 만들었다. 게임 파일(NSP 폴더)과 prod.keys를 스크립트 하나에 넣으면 사이드로드용 IPA가 나온다. 저장소에는 게임 데이터가 없고 닌텐도·게임사와 무관하다고 README가 밝힌다.

2026-10-28 기준 스타 8,569개, 포크 1,364개, 라이선스 MIT, 언어 Objective-C다. 저장소는 2026-10-13에 만들어졌고 같은 날 마지막 push가 있었다(기여자 20명, GitHub 릴리스 없음). 이 위키는 이미 X 게시물 쪽에서 이 프로젝트의 확산과 파생 앱을 다뤘다. 이 노트는 저장소 README와 docs/ 두 문서를 읽은 결과다.

작동 방식

docs/development.md의 “How it works” 표를 줄이면 이렇다.

부분하는 일
리라이터 (dm/tools/patch_nso.py)지원 게임의 모든 NSO 모듈에 같은 도구를 돌린다. 모듈 빌드 ID를 키로 게임별 패치를 적용한다. 검증된 패치는 업데이트 사이에 함수 매칭으로 옮길 수도 있다
호스트 (dm/host)Horizon 커널과 시스템 서비스를 대신한다. 스레드·동기화·메모리, 트랜잭션 방식 세이브가 있는 파일 시스템, 입력(HID), 오디오, 동영상(VP9는 libvpx, 소리는 stb_vorbis), 소프트웨어 키보드
그래픽 (dm/gfx)NVN을 Metal로 옮긴다. 닌텐도 컨테이너와 Unity Shader 객체에서 셰이더를 뽑아 오프라인 번역한다. 마리오 계열 16,268개 중 16,266개, 파이어 엠블렘 인게이지 9,269개 중 9,268개가 컴파일된다. Vulkan·OpenGL로 그리는 게임(Hades 등)은 Metal 위에 별도 계층을 쓴다
오디오·입력Core Audio 출력. iOS는 터치 게임패드와 외장 컨트롤러, 폰을 흔들면 컨트롤러가 흔들린다. Mac은 컨트롤러별 플레이어 최대 8명
iOS 앱iPhone·iPad 공용 서명 없는 IPA 하나. 고쳐 쓴 코드는 실행 파일 안에, 셰이더·RomFS·아이콘은 앱 안에 들어간다. 게임 전에 프레임레이트·해상도·독/휴대 모드 설정 화면이 뜬다

알려진 한계로 docs/development.md는 조건부 렌더 항상 그리기, 지오메트리 셰이더 번역 불가, amiibo 없음 등을 꼽는다.

사용 흐름

  1. 환경: macOS 26.6 이상, Xcode 27.1, Homebrew, arm64 Python 3.12+. iPhone용 빌드는 Xcode의 iOS 플랫폼도 필요하다. xcodegen·zstd·glslang·dotnet-sdk와 Python 패키지(lz4, capstone, fonttools, nsz 등)를 설치한다.
  2. 게임 폴더: 본편과 업데이트·DLC(.nsp·.xci·.nsz·.xcz)를 한 폴더에 둔다.
  3. 빌드: python3 scripts/build_ipa_from_nsp.py <게임 폴더> -k <prod.keys>. 첫 빌드는 30~60분이 걸리고 게임 크기의 약 2배 + 10GB의 여유 공간이 필요하다. --platform mac-app이면 Mac 앱이 나온다.
  4. 설치: AltStore·Sideloadly·LiveContainer 같은 사이드로드 도구로 IPA를 깐다. “Increased Memory Limit”을 켜야 큰 게임이 돈다. 너무 커서 안 깔리면 --romfs separate로 다시 빌드해 게임 파일만 따로 복사한다.
  5. 실행: 세이브와 로그는 파일 앱의 게임 이름 폴더(save/, log.txt)에 있다. 2D/3D 터치 레이아웃을 전환하고, DualSense·DualShock 4의 자이로나 폰 자이로를 모션 조작에 쓴다. Documents/env.txt의 DM_* 변수로 설정 화면을 덮어쓴다(예: DM_FPS_TARGET=30으로 원래 30fps 유지해 배터리 절약).

요구 기기는 iOS·iPadOS 26 이상, A17 Pro 이후 iPhone 15 Pro 이상 또는 M1 이후 iPad다. 게임 텍스처가 BC 압축이라 더 오래된 iPhone은 그 포맷을 읽지 못하기 때문이다.

지원 게임

README 갤러리에는 약 80종이 올라 있다. 마리오 카트 8 디럭스·슈퍼 마리오 오디세이·원더·갤럭시 1/2, 젤다 야생의 숨결·왕국의 눈물·꿈꾸는 섬, 파이어 엠블렘 인게이지·세 개의 학급, 포켓몬 소드/실드·스칼렛·레전즈 Z-A, 페르소나 5 로열, 몬스터 헌터 라이즈, 스매시브라더스 얼티밋(오프라인), Hades 1·2, 할로우 나이트: 실크송, 셀레스트 등이다. 게임마다 IPA 크기가 표시되고, 일부는 “60 fps with 업데이트 버전”으로 Switch의 30fps를 넘는다(BotW 1.9.0, TotK 1.4.3 등). 게임별 상태는 dm/games/README.md에 따로 있다. 목록에 없는 게임은 조사(survey) 결과만 쓰고 추측 설정으로 IPA를 만들지만 안 켜질 수 있다. 위 수치는 저장소의 주장이며 직접 실행해 확인하지 않았다.

파생 프로젝트와 계보

  • Mac 앱 3종: README는 명령줄 없이 쓰는 커뮤니티 앱으로 NX2Apple, NX Play, NxNative Launcher를 소개한다. 별도 프로젝트라 문의도 각자 저장소로 보내라고 한다. NX2Apple은 2026-10-20-x-totk-native-mac-ios-ports에서 다룬 @LNPANDY의 macOS 앱과 같은 계열로 보인다.
  • 계보: nxnative는 Diablo II: Resurrected용으로 이 접근을 개발한 d2r-mobile(MIT)에서 출발했다. NSO 리라이터·Horizon 호스트·NVN-on-Metal·iOS 앱 껍데기가 거기서 왔고 수정은 양방향으로 오간다(2026-10-16-x-roundtablespace-d2r-mobile). 그 밖에 Ryujinx(셰이더 번역기, 시스템 서비스 참고)·Atmosphère·yuzu·LibHac·hactool·SPIRV-Cross·glslang·deko3d 등을 쓴다.

해석과 메모

  • 같은 흐름의 다른 시도로 Switch 게임 IPA 패키징 2026-10-20-x-touchable-switch-games-iphone, AI 보조 디컴파일·포트 물결과 업계 반응 2026-10-18-x-pirat-nation-ai-decompile-port-wave가 있다.
  • 이 위키의 X 노트는 사용자 측 증언(60fps, 메모리 한도 해제)이었고, 이 노트는 저장소의 구조와 공식 사용법이다. 둘을 맞추면 “게임 파일 분리 설치”는 --romfs separate, 메모리 한도 해제 요령은 사이드로드 도구의 Increased Memory Limit과 이어진다.
  • 법적 위험이 큰 영역이다. 이 도구는 본인 덤프와 키가 필요하다고 못 박지만, 닌텐도가 가만히 있을지, 저장소가 유지될지는 불확실하다.

한계와 확인 못 한 것

  • 직접 빌드하거나 실행하지 않았다. 지원 게임 수·60fps·셰이더 컴파일 수치는 README와 개발 문서의 주장이다.
  • docs/development.md는 약 125KB라 “How it works” 표와 메모리 SVC·CI 서술 앞부분만 읽었다. docs/agents/와 게임별 노트는 읽지 않았다.
  • 저장소가 만들어진 지 15일 된 빠르게 바뀌는 프로젝트라 지원 목록과 요구 버전(Xcode 27.1, macOS 26.6)은 금방 달라질 수 있다.