개요
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 없음 등을 꼽는다.
사용 흐름
- 환경: macOS 26.6 이상, Xcode 27.1, Homebrew, arm64 Python 3.12+. iPhone용 빌드는 Xcode의 iOS 플랫폼도 필요하다.
xcodegen·zstd·glslang·dotnet-sdk와 Python 패키지(lz4,capstone,fonttools,nsz등)를 설치한다. - 게임 폴더: 본편과 업데이트·DLC(
.nsp·.xci·.nsz·.xcz)를 한 폴더에 둔다. - 빌드:
python3 scripts/build_ipa_from_nsp.py <게임 폴더> -k <prod.keys>. 첫 빌드는 30~60분이 걸리고 게임 크기의 약 2배 + 10GB의 여유 공간이 필요하다.--platform mac-app이면 Mac 앱이 나온다. - 설치: AltStore·Sideloadly·LiveContainer 같은 사이드로드 도구로 IPA를 깐다. “Increased Memory Limit”을 켜야 큰 게임이 돈다. 너무 커서 안 깔리면
--romfs separate로 다시 빌드해 게임 파일만 따로 복사한다. - 실행: 세이브와 로그는 파일 앱의 게임 이름 폴더(
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)은 금방 달라질 수 있다.