nxnative 요구 사항
nxnative를 쓰려면 플레이할 최신 Apple 기기, 앱을 만들 Mac, 그리고 내 게임 파일과 키가 필요합니다. 공식 README에 있는 전체 목록입니다.
플레이할 수 있는 기기
| 기기 | 요구 사항 |
|---|---|
| iPhone | iPhone 15 Pro 이상(A17 Pro 칩 이상), iOS 26 이상 |
| iPad | M1 칩 이상, iPadOS 26 이상 |
| Mac | Apple silicon, --platform mac-app으로 만든 앱 |
iPhone 제한의 이유는 텍스처 형식입니다. Switch 게임은 BC 압축 텍스처를 쓰는데 이전 iPhone은 이를 읽지 못합니다.
앱을 만들 때 필요한 것
- macOS 26.6 이상, Xcode 27.1, Homebrew가 있는 Mac. 셰이더는 Xcode 27.1의 Metal 컴파일러로 테스트되며, 다른 버전에서는 스크립트가 멈춥니다.
- README가 설치하는 도구: Xcode Metal 툴체인, xcodegen, zstd, glslang, .NET SDK, 몇 가지 Python 패키지. Python 3.12 이상.
- 게임 파일 크기의 약 두 배에 10GB를 더한 여유 디스크 공간.
- 시간: 첫 빌드는 30~60분 걸립니다. 이후 빌드는 입력이 바뀌지 않은 단계를 재사용하므로, 호스트만 바뀐 업데이트 후에는 1분 정도면 됩니다.
내 게임과 키
nxnative는 내가 가진 게임의 파일로만 동작합니다. 본편, 있다면 업데이트와 DLC, 그리고 내 prod.keys가 필요합니다. 저장소에는 어떤 게임의 데이터도 없고, 이 사이트는 게임 파일이나 키를 구하는 방법을 설명하지 않습니다. 어떤 게임 버전이든 동작하지만 게임마다 한 버전으로만 테스트되었고, 60fps 수정은 그 버전에만 적용됩니다.
iPhone이나 iPad에 설치할 때
- AltStore, Sideloadly, LiveContainer 같은 사이드로드 도구.
- 도구가 지원하면 Increased Memory Limit 권한으로 서명하세요. 없으면 iOS가 앱에 약 3.4GB만 주고 큰 게임을 종료합니다. 젤다 무쌍 대재앙의 시대와 Hades II는 더 필요하고, 브레스 오브 더 와일드와 Cuphead도 한계에 가깝습니다. 권한이 있으면 최신 iPhone에서 약 6GB를 씁니다.
- 아주 큰 게임의 IPA는 iOS가 압축을 풀지 못할 만큼 클 수 있습니다. 이때 스크립트는 게임 파일을 IPA에서 빼고, 별도 명령으로 한 번만 휴대폰에 복사하게 할 수 있습니다.
컨트롤러가 필요한가요?
필수는 아닙니다. 모든 앱에 2D·3D 터치 조작이 있습니다. 컨트롤러를 연결하면 터치 조작이 숨겨지고 모든 버튼을 쓸 수 있습니다. USB-C인 iPhone 15 Pro 이상에서는 GameSir G8 Plus MFi처럼 휴대폰에 끼우는 컨트롤러가 가장 편합니다(USB-C, GameSir 표기 기준 Apple 인증). 컨트롤러에 자이로가 없으면 iPhone 자체 자이로를 씁니다. Mac이나 손에 든 컨트롤러로 모션 조작을 하려면 DualSense 또는 DualShock 4가 맞습니다. 자세한 내용은 컨트롤러 가이드(영어)에 있습니다.
요구 사항 관련 질문
iPhone 14나 iPhone 15에서도 되나요?
nxnative README에 따르면 안 됩니다. iPhone 15 Pro 이후 모델(A17 Pro 칩 이상)이 필요합니다. 일반 iPhone 15와 이전 모델은 BC 압축 텍스처를 읽지 못합니다. 별도 프로젝트인 MacNativeGames는 자사 젤다 iOS 빌드가 iPhone 14 이상에서 실행된다고 밝힙니다.
iPad에서도 되나요?
네. M1 칩 이상의 iPad에 iPadOS 26 이상이면 됩니다.
Mac이 꼭 있어야 하나요?
네, 앱을 만들려면 필요합니다. 스크립트는 macOS 26.6 이상, Xcode 27.1, Homebrew가 있는 Mac에서 실행됩니다. Mac에서 플레이하려면 Apple silicon이 필요합니다.
스크립트가 Xcode 버전 때문에 멈춰요.
셰이더는 Xcode 27.1의 Metal 컴파일러로 테스트되었기 때문에, 다른 버전이면 스크립트가 멈추고 테스트된 툴체인 설치 방법을 안내합니다. 다른 컴파일러에서 보고된 그래픽 깨짐은 아직 조사 중입니다.
유료 Apple 개발자 계정이 필요한가요?
아니요. AltStore, Sideloadly, LiveContainer 같은 사이드로드 도구로 IPA를 설치할 수 있습니다. 개발자 계정이 있으면 Xcode에서 빌드해 설치할 수도 있습니다.
큰 게임이 iPhone에서 꺼져요.
Increased Memory Limit 권한이 없으면 iOS는 앱에 약 3.4GB 메모리만 줍니다. 도구가 지원하면 이 권한으로 IPA를 서명하세요. 최신 iPhone에서는 약 6GB까지 쓸 수 있습니다.
다음: nxnative 사용법.