Repolode
Submit
xFractals

xFractals/pokopia-native

Open-source tool that builds a native Mac and iPhone app from your own Pokémon Pokopia Switch 2 dump, with no game content included.

View on GitHub
Stars
379
Forks
35
Open issues
0
Last commit
17 hours ago

What is it?

This project is a build tool that turns your own dump of Pokémon Pokopia for Nintendo Switch 2 into a native macOS app and an iPhone app. It runs the game's own arm64 code on Apple silicon rather than through an emulator, and draws graphics through Metal. The tool uses nxnative as its host and adds Switch 2 specific support, including the newer SDK services, NVN2 entry points, the Switch 2 shader format and a shader translation chain.

All game-derived files are generated locally from your dump and stay in your build folder. The tool checks that the dump matches the required update version. It requires an Apple silicon Mac for building, Xcode and Python 3.12, and a paid Apple Developer team to sign the iPhone build with the extended memory entitlements. It also includes Windows instructions for building only the iPhone app, which the author notes is not yet drawing correctly.

The build pipeline translates about 4,000 shaders found in the game files. Shaders the game generates at run time are recorded during play and added with a refresh command. Mouse and touch camera control, performance settings and a Metal shader pipeline are included.

Key features

  • 01Builds a native macOS app and an iPhone IPA from a user-supplied game dump.
  • 02Runs game code on Apple silicon with graphics through Metal.
  • 03Translates the game's shaders ahead of time during the build.
  • 04Records run-time shaders and adds them through a refresh command.
  • 05Provides mouse look on Mac and drag-to-look on iPhone.
  • 06Includes a command-line interface and a graphical build window.

Use cases

  • Developers who own the game and want to study how Switch 2 shaders are translated to Metal.
  • Mac users with Apple silicon who want to play their own copy of the game as a native app.
  • Engineers researching native porting of Switch 2 titles using the nxnative host.

In collections

Open-source Mac apps

Topics

#native-port#apple-silicon#metal#macos#ios#shader-translation#game-porting#iphone#nintendo-switch-2#nxnative

FAQ

What is pokopia-native?
Open-source tool that builds a native Mac and iPhone app from your own Pokémon Pokopia Switch 2 dump, with no game content included. This project is a build tool that turns your own dump of Pokémon Pokopia for Nintendo Switch 2 into a native macOS app and an iPhone app. It runs the game's own arm64 code on Apple silicon rather than through an emulator, and draws graphics through Metal. The tool uses nxnative as its host and adds Switch 2 specific support, including the newer SDK services, NVN2 entry points, the Switch 2 shader format and a shader translation chain.
Is pokopia-native free to use? What license does it have?
pokopia-native is open source under the MIT license. Check the license terms before using it in commercial products.
Is pokopia-native still maintained?
Actively maintained. The last commit to pokopia-native was on Nov 6, 2026.
What can I use pokopia-native for?
Developers who own the game and want to study how Switch 2 shaders are translated to Metal. Mac users with Apple silicon who want to play their own copy of the game as a native app. Engineers researching native porting of Switch 2 titles using the nxnative host.
Where can I get pokopia-native?
The source code and installation instructions are on GitHub: https://github.com/xFractals/pokopia-native

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects