Guide: Running Switch games natively on Mac with nxnative
AppleGamingWiki · Fonte em inglês
Abrir recurso →Apple Silicon Mac · iPhone · iPad
Seus jogos de Switch, nativos na Apple
Crie apps para Mac com Apple Silicon, iPhone e iPad com seus próprios jogos e chaves. O código do jogo roda no chip Apple e os gráficos são renderizados com Metal.
128jogos jogáveis
25elevados para 60 fps
MITCódigo no GitHub
Escolha onde jogar
As duas opções começam no Mac: abra o app para Mac ou instale o IPA não assinado no iPhone ou iPad por sideloading.
Apple Silicon Mac
Compile com --platform mac-app e abra o app gerado pelo Finder.
iPhone & iPad
Crie um IPA no Mac e instale por sideloading. A versão upstream exige iOS / iPadOS 26+ e A17 Pro / M1 ou mais recente.
Seus arquivos e chaves
Prepare o jogo base, atualizações e DLCs opcionais e prod.keys. Jogos e chaves não estão incluídos.
Confira seu jogo primeiro
O catálogo registra testes de jogo no Mac ou iPhone. Cada página informa a versão testada, notas e limitações conhecidas.
Construído sobre d2r-mobile, o tradutor de shaders do Ryujinx, Atmosphère, yuzu, LibHac, SPIRV-Cross e mais. Veja os agradecimentos.
Encontre seu jogo
Estes jogos passaram por testes no Mac ou iPhone, mas não necessariamente em todos os dispositivos. Veja os detalhes de cada título.
Donkey Kong Bananza
Splatoon Raiders
Fire Emblem Fortune's Weave60 fps
Pokémon Pokopia
Mario Kart 8 Deluxe
Mario vs. Donkey Kong
Paper Mario: The Thousand-Year Door60 fps
Super Mario 3D World + Bowser's Fury3D layout
Super Mario Bros. Wonder2D layout
Super Mario Galaxy3D layout
Super Mario Galaxy 23D layout
Super Mario Odyssey3D layout
Ver catálogo completo (128)
The Legend of Zelda: Breath of the Wild3D layout60 fps
The Legend of Zelda: Link's Awakening2D layout
The Legend of Zelda: Tears of the Kingdom3D layout60 fps
13 Sentinels: Aegis Rim2D layout
Absolum2D layout
Ace Attorney Investigations Collection2D layout
Advance Wars 1+2: Re-Boot Camp
AI: THE SOMNIUM FILES
AI: THE SOMNIUM FILES - nirvanA Initiative
Animal Crossing: New Horizons
ANIMAL WELL
ASTRAL CHAIN60 fps
Balatro
BALL x PIT
Bayonetta
Bayonetta 2
Bayonetta 3
Big Brain Academy: Brain vs. Brain2D layout
Brain Memory Training Academy2D layout
Captain Toad: Treasure Tracker3D layout
Catherine: Full Body
Celeste2D layout
Cuphead2D layout
DARK SOULS: REMASTERED60 fps
Digimon Story Cyber Sleuth: Complete Edition
Donkey Kong Country: Tropical Freeze
DRAGON QUEST VII Reimagined60 fps
DRAGON QUEST XI S: Echoes of an Elusive Age – Definitive Edition3D layout60 fps
FINAL FANTASY RESONANCE60 fps
FINAL FANTASY TACTICS - The Ivalice Chronicles3D layout
Fire Emblem Engage2D layout60 fps
Fire Emblem: Three Houses3D layout60 fps
Ghost Trick: Phantom Detective
The Great Ace Attorney Chronicles2D layout
Hades3D layout
Hades II3D layout
Hollow Knight: Silksong
Hyrule Warriors: Age of Calamity3D layout60 fps
Kirby and the Forgotten Land
Luigi's Mansion 360 fps
Metroid Dread2D layout
Monster Hunter Rise3D layout60 fps
Monster Train 22D layout60 fps
OCTOPATH TRAVELER
Octopath Traveler 02D layout60 fps
Octopath Traveler II60 fps
Patrick's Parabox2D layout
Persona 5 Royal
Pikmin 4
Pokémon Brilliant Diamond60 fps
Pokémon Legends: Z-A2D layout
Pokémon Scarlet
Pokémon Violet
Pokémon Sword
Pokémon Shield
Portal
Raging Loop
Rhythm Heaven Groove2D layout
ROMANCE OF THE THREE KINGDOMS 8 REMAKE
Sea of Stars
SHIN MEGAMI TENSEI V: Vengeance60 fps
Stardew Valley
STEINS;GATE RE:BOOT2D layout
Super Smash Bros. Ultimate
Taiko Risshiden V DX
Unicorn Overlord2D layout
Yoshi's Crafted World
NieR:Automata The End of YoRHa Edition60 fps
The Legend of Zelda: Echoes of Wisdom
Donkey Kong Country Returns HD
Mario + Rabbids Sparks of Hope
Xenoblade Chronicles 2
Xenoblade Chronicles 3
FINAL FANTASY CRYSTAL CHRONICLES Remastered Edition
Return of the Obra Dinn
Blasphemous 2
Silver Pines
Blasphemous
FINAL FANTASY X/X-2 HD Remaster
Mario + Rabbids Kingdom Battle
Persona 4 Golden
Xenoblade Chronicles: Definitive Edition
Pokémon Legends: Arceus
Super Mario Party Jamboree
Cult of the Lamb
Paper Mario: The Origami King
Batman: Arkham Knight
Bastion
Baba Is You
SteamWorld Heist II
SteamWorld Heist: Ultimate Edition
Subnautica: Below Zero
SteamWorld Dig 2
Streets of Rage 4
Mario Party Superstars
Subnautica
SteamWorld Dig
Team Sonic Racing
Well Dweller
Need for Speed: Hot Pursuit Remastered60 fps
EA SPORTS FC 2760 fps
Portal 2
Super Monkey Ball Banana Rumble
Atelier Ryza: Ever Darkness & the Secret Hideout DX
DRAGON QUEST III HD-2D Remake60 fps
Hyrule Warriors: Definitive Edition
Metroid Prime Remastered
DRAGON QUEST I & II HD-2D Remake
Dead Cells
Hollow Knight
TRIANGLE STRATEGY60 fps
Castlevania: Belmont's Curse
SUPER ROBOT WARS Y
Super Mario RPG
The Legend of Zelda: Skyward Sword HD
Princess Peach: Showtime!60 fps
Dos arquivos a um app jogável
A primeira compilação leva cerca de 30–60 minutos; as próximas reutilizam o trabalho concluído. O resultado é um app para Mac ou um IPA não assinado.
Para compilar: macOS 26.6+, Xcode 27.1, Homebrew e Python ARM64 3.12+. Para iPhone, instale também a plataforma iOS do Xcode. Reserve o dobro do tamanho do jogo mais 10 GB.
Prefere uma janela a um terminal? NX2Apple, um projeto da comunidade, reúne esses passos em um app para macOS.
Baixe o nxnative e as ferramentas
Uma vez, no Mac.
xcodebuild -downloadComponent MetalToolchain
git clone https://github.com/seedds/nxnative.git && cd nxnative
brew install xcodegen zstd glslang
brew install --cask dotnet-sdk
python3 -m pip install lz4 "capstone>=5,<6" fonttools nsz zbic "backports.zstd; python_version < '3.14'"Coloque os NSPs de um jogo em uma pasta
Coloque o jogo base, as atualizações e os DLCs na mesma pasta. NSP, XCI, NSZ e XCZ são aceitos.
~/Games/MarioWonder/
Super Mario Bros. Wonder [010015100B514000][v0].nsp
Super Mario Bros. Wonder [010015100B514800][v327680].nspExecute o script
O resultado fica na pasta do jogo. Para Mac, adicione --platform mac-app.
python3 scripts/build_ipa_from_nsp.py ~/Games/MarioWonder -k ~/keys/prod.keys
# Mac app instead of an iPhone IPA:
python3 scripts/build_ipa_from_nsp.py ~/Games/MarioWonder -k ~/keys/prod.keys --platform mac-appAbrir ou instalar
No Mac, abra o app pelo Finder. No iPhone / iPad, instale o IPA com AltStore, Sideloadly ou LiveContainer. Para jogos grandes, ative Increased Memory Limit quando disponível.
Jogue
Toque em 2D / 3D no alto para trocar o layout de toque. Um controle conectado esconde os controles na tela. Em 3D, deslize no terço direito da tela para mover a câmera. Sacuda o celular para sacudir o controle.
Se o IPA for grande demais, recompile com --romfs separate e execute o comando de cópia indicado. A compatibilidade com iOS antigo pertence a uma ramificação da comunidade. Jogue.
Tutoriais e vídeos
Selecionados nos resultados do Google em 30 de outubro de 2026. A ordem varia. Priorize a documentação atual; títulos de vídeos não garantem suporte a todos os jogos.
nxnative — Development guide
seedds / nxnative · Fonte em inglês
Abrir recurso →How to Build Any Switch Game As Native Mac App (nxnative)
Andrew Tsai’s Tips · 11:59 · Fonte em inglês
Abrir recurso →NXnative - Native Switch Games on iPhone 17 Pro Max
blackheart909 · 8:41 · Fonte em inglês
Abrir recurso →FAQ e dicas
Idioma
Inglês por padrão. Escolha outro ao empacotar com -l (por exemplo -l ja) ou adicione DM_LANG=zh-Hans a Documents/env.txt.
Saves e logs
No app Arquivos, com o nome do app: save/ e log.txt. Envie o log.txt quando algo der errado.
Travadas
Pequenas travadas na primeira vez que uma cena aparece são normais: os gráficos são compilados uma vez e guardados.
Reinstalar
Alguns instaladores por sideload criam uma nova pasta de dados. Copie save/ e pso_user.tsv da antiga.
Ajustes
Linhas em Documents/env.txt: DM_OPMODE=0 para o modo portátil, DM_FPS_TARGET=30 para economizar bateria, DM_SHOW_FPS=1 para um contador de FPS.
Sem suporte
Sem amiibo, sem recursos online. Outros jogos recebem um relatório de análise e um IPA de melhor esforço que pode não iniciar.
Ferramentas e compatibilidade da comunidade
Explore interfaces gráficas, bibliotecas de jogos e suporte a versões antigas do iOS. Os projetos são mantidos de forma independente; suas páginas incluem requisitos e links para o código-fonte.
NX2Apple De terceiros
Um launcher e biblioteca para macOS que compila e gerencia jogos de Mac, iPhone e iPad. Desde a v1.0, iPhone e iPad usam um shell comum com biblioteca, Cover Flow, navegação por controle e teclado e ajustes por jogo; o motor acompanha as versões e segue o upstream diariamente.
Ver projeto →NX Play De terceiros
Uma biblioteca para extrair, jogar, empacotar e gerenciar jogos, agora com NX Play para iPhone e iPad. O launcher móvel lista jogos do Mac, pede instalação pela rede local, abre jogos instalados com controle e lembra da renovação da assinatura.
Ver projeto →LumaNX De terceiros
O LumaNX, antes LumaDock, une nxnative, biblioteca gráfica, fila de builds e conversão. A versão 0.3.0 adiciona no Mac a importação experimental de pastas desencriptadas de Switch 2 e reutiliza etapas de preparação inalteradas.
Ver projeto →iOS 16.1/17 compatibility fork De terceiros
Ramo experimental de compatibilidade para iOS antigo com Metal tradicional, restrições de shader por aparelho e adaptadores por build. O ramo mantido agora se chama ios16-ios17-compat.
Ver projeto →nx2android De terceiros
nx2android leva a execução direta do nxnative ao Android. O código ARM64 do jogo roda no aparelho, as chamadas NVN são traduzidas para Vulkan e o construtor gera um APK com os dados do jogo.
Ver projeto →MacNativeGames De terceiros
MacNativeGames é um projeto nativo independente voltado a Breath of the Wild e Tears of the Kingdom. Funciona em Mac, iPhone, iPad e tem suporte inicial a Vision Pro.
Ver projeto →xbunax nxnative De terceiros
xbunax/nxnative é um fork com estúdio WebUI local. Adiciona importação e tarefas no navegador, conversão XCI e caminhos documentados para IPA no Windows e macOS.
Ver projeto →CA-NINAPPLE De terceiros
CA-NINAPPLE é um fork para Windows derivado do NXNativeWindows. GUI e PowerShell criam um IPA a partir do jogo e das chaves sem Mac.
Ver projeto →NX OS De terceiros
NX OS é um launcher macOS estilo console construído sobre nxnative. Ele encontra jogos compilados, abre em tela cheia, mede tempo de jogo e inicia builds para Mac ou iPhone.
Ver projeto →nxnative-gui De terceiros
nxnative-gui é um frontend macOS leve, não outro runtime. Ele clona ou atualiza o nxnative, verifica ferramentas e reúne em um formulário as escolhas normalmente feitas no terminal.
Ver projeto →ns2ios-shell De terceiros
ns2ios-shell separa um shell iOS reutilizável do empacotamento local por jogo. A CI cria o shell; o packer combina os dados em Windows, Linux ou macOS sem Xcode.
Ver projeto →