This project lets you run a game you own natively on your own Mac, iPhone or Windows PC, and, in open betas, on Linux (the Steam Deck included) and Android. It ships tools only. It does not contain, and must never be made to contain, any part of the game.
Never in this repository, never in a release
- The game's executable (
main,sdk, the other ExeFS modules), in original, rewritten or recompiled form (the Windows build'sgame.dll, its objects and itsprogram.dbincluded). - The game's data (
RomFS,romfs.img, any file extracted from it). - The game's DLC (add-on content) in any form. A build only ever uses the player's own dump of DLC they bought.
- The game's shaders in any form: the shader containers from the game files, runtime shader dumps, lowered (Maxwell) programs, translated Metal source, compiled Metal libraries, Vulkan SPIR-V, pipeline caches, or shader packages built from them.
- Console firmware files such as the system fonts.
- Keys, tickets, certificates, saves, screenshots of other people's content, or logs that name your files.
Every one of those is produced on your machine, from your own dump, at build time, and stays in your
build folder (<dump folder>_native). The build takes only a dump you provide yourself, checks it is the version
the recipe is for, and refuses any other. Never share a build folder: it holds the game.
What is in the repository
- The native host and the iOS app sources (the
nxnativeproject, MIT, with the Switch 2 changes made for this port), as a fork or as a patch set. ampere-lower: a standalone build of the Switch 2 → Maxwell shader lowering from the Eden-NS2 emulator (GPL-3.0-or-later; its ownLICENSEandNOTICE.mdare in that folder).- The build scripts and the per-game recipe: tables that describe where to patch and how to treat each shader (hashes, slot kinds, formats). They contain no game code.
windows/: the Windows port's source (our own recompiler and runtime, MIT; its third-party code keeps its own licence, listed inwindows/docs/PROVENANCE.md), where it is published.- Documentation.
What the downloads contain
Each release has one download per computer, made by tools/package_release.py from this repository's files:
- for Macs: the repository's tools for a Mac.
- for Windows PCs: the repository's tools for Windows, plus
windows/bin: the Windows game's tools built fromwindows/(nxanalyze,nxliftwith LLVM,nxrt, SDL3), LLVM'slld-link, SPIRV-Tools from the Vulkan SDK and the Visual C++ runtime files those two need.windows/bin/MANIFEST.txtlists every file with its checksum and origin,windows/bin/THIRD-PARTY-NOTICES.txttheir licences.
The open betas have downloads of their own, released from the linux-beta and android-beta branches: for Linux
(and the Steam Deck), whose tools are in linux/bin (linux/bin/MANIFEST.txt lists them, THIRD-PARTY-NOTICES.txt
beside it their licences), and for Android, which makes the Android app on a Windows PC.
None of them contains anything of the game. On Windows the game's code is recompiled, and its shaders translated, on your PC from your own dump, into your build folder, as the Mac and iPhone builds do.
What the tool does not do
It decrypts nothing and bypasses nothing. It takes a dump that is already plain files, made by you from your own console with your own tools, and needs no keys, tickets or certificates. If your dump is encrypted or packaged, this tool cannot read it and will not try.
It never makes, downloads or unlocks DLC (add-on content). The game sees DLC only when you give the builder your own dump of DLC you bought; without it, the game has none.
What it connects to
- The update check. At most once a day, the builder and the game's launchers ask, at the same time, the project's website
(
pokopia-native.vercel.app/latest.json) and GitHub's public API (api.github.com/repos/xFractals/pokopia-native/releases/latest) for this project's latest release, to tell you when a new version is out; the newer answer counts, so one of them being down doesn't matter. The requests carry only what any web request carries: your internet address reaching the website and GitHub, and a line naming Pokopia Native and its version. Nothing about you, your game, your save or your computer is sent. Turn it off in the builder (Advanced → Check for updates once a day), in the launcher's settings, or withnxs2.py update --off; the choice is kept inupdates.jsonin your settings folder. - The Android app (beta) asks, at most once a day when it starts, for the list of releases
(
api.github.com/repos/xFractals/pokopia-native/releases?per_page=30) to find the newest Android beta. Again, only what any web request carries is sent. Turn it off in the app's settings (Back → Check for updates); the choice is kept inupdates.jsonamong the app's own files. The app has Android's internet permission for this, and for Link Play on Android later. - The live player count. While the Pokopia Native app is open, it tells the project's download server
(
downloads.pokopia-native.workers.dev/_live) so the website can show how many players are online now: when it opens, when the game starts or stops, every 5 minutes, and when it closes. It sends a random number made new each time the app starts (never saved, so two starts can't be linked), whether the game is running, the kind of computer (Windows, Linux, Steam Deck or Mac) and the app's version. Nothing else: not your name, your game, your save or anything on your computer. The server keeps no internet addresses (its rate limit is Cloudflare's own count, kept by no one), forgets a number an hour after its last word, and keeps only each day's highest count. The counts are public: anyone can read them there. Turn it off in the app (Settings → App → Players online on the website); the choice is kept inapp.jsonin your settings folder. - Download and update. Only when you press it, the builder downloads the new release's file for your computer from where that answer names (the website's download server or GitHub), checks its SHA-256 against the release's, and unpacks it beside the old download. Nothing is installed or run without that click.
- Link Play connects only to the players you choose to play with (or a relay you set up yourself), and automatic port forwarding talks only to your own router. There is no Pokopia Native game server.
- Online rooms (play with a short code, Windows, only when you host or join one) add two servers.
- The room service (
rooms.pokopia-native.workers.dev, ours) turns a code into a room. It sees a scrambled form of the code and a sealed note only someone with the code can open. For a room you put in the room list, it also sees a made-up name and the player count. A room is gone a minute after its host stops. It keeps internet addresses only as a keyed hash, for its rate limits. - The relay that carries the game between players is run by Recompia, who let us use it. The relay sees players' internet (IP) addresses and keeps them in its logs; the game traffic itself is encrypted, so it sees only how much is sent and when.
- Cross-play (only when you open Open rooms, or host with In the room list and Cross-play on; Cross-play is on unless you turn it off): the game asks Recompia's relay for the rooms in its own list, sending this game's version and mods fingerprint; a cross-play room you host goes in that list with its room code, game version, mods fingerprint and the game's own network details (the player count and the players' in-game names among them), where anyone can read them. Cross-play rooms are not encrypted, so the relay could read their game traffic.
Free, forever
Pokopia Native is free of charge, and will stay free forever. The project never charges players for anything related to it: not the downloads, not the builds or the apps they make, not features, early access, support or help, and nothing else.
Anyone who charges for Pokopia Native, or for anything made with it, is not associated with Pokopia Native and should not be trusted: nobody sells anything on the project's behalf. Please don't pay them or run their files, and tell us on the Discord or in a GitHub issue. The only official downloads are this site's download buttons.
Licences
ampere-lower/: GPL-3.0-or-later (Eden-NS2 code; itsLICENSEandNOTICE.mdare in that folder).host/: the changes are MIT; the nxnative and Ryujinx code they modify or build is MIT under their own notices, reproduced inhost/NOTICE.md. The Switch 2 texture layout innxnative-switch2.patch(dm/gfx/tex/s2tex.c,dm/gfx/tex/s2tex.h,dm/gfx/msl/s2tex.metal) is this project's own MIT code, written clean-room from a functional specification of the layout and verified bit for bit against the game's textures. It replaces the earlier code, which followed Eden-NS2's GPL-3.0-or-later code; none of that remains in the patch.windows/: MIT; the components it builds in or ships beside it are listed with their licences inwindows/bin/THIRD-PARTY-NOTICES.txtof the Windows download (LLVM: Apache-2.0 with LLVM exception; SDL3 and SDL_GameControllerDB: zlib; astc-encoder and SPIRV-Tools: Apache-2.0; bc7enc_rdo: MIT; Monocypher 4.0.2 (online rooms): BSD-2-Clause or CC0-1.0; libvpx 1.17.0 (movies): BSD-3-Clause; nxnative: MIT).nupread.py: this project's own MIT code, written from the NUP format specification (github.com/a55uka/nup,SPEC.md, MIT). It only reads containers of already-decrypted dumps; no keys are involved.- Everything else here: MIT (
LICENSE), the same licence as nxnative.
Trademarks and affiliation
Pokémon and Pokémon Pokopia are trademarks of Nintendo, Creatures Inc. and GAME FREAK inc. / The Pokémon Company; Nintendo Switch is a trademark of Nintendo; the game is published by Nintendo and developed by Koei Tecmo. This project is an independent, non-commercial fan project. It is not affiliated with, endorsed by or supported by any of them, and the names are used only to say which game it is for.
The screenshots in the README show the game only to document the result. They are not game assets for reuse.
Rights holders
If you hold rights in anything in this repository or its releases and want it changed or removed, message a moderator on the project's Discord and say which files. It will be taken care of promptly, without a formal notice needed.
If you fork this project, keep these rules: they are what makes it publishable.