Recompia
Recompia is a static recompilation tool for Windows, native Linux and Apple Silicon Macs, with local builds, save imports, mods and Link Play.
The overview
The launcher checks the supplied data, translates code to C++ and prepares shaders before building locally. Windows and Linux use Vulkan; the Mac package uses MoltenVK. Solo and Co-op have distinct launcher entries, so match the release channel and requirements before updating.
Introduction sources checked
· README 5fe4164
- github.com/Dittobyte/Recompia/blob/5fe4164613402749b2c3aab711d8e445054fafd1/README.md
- github.com/Dittobyte/Recompia/releases
- github.com/Dittobyte/Recompia/blob/5fe4164613402749b2c3aab711d8e445054fafd1/docs/macos-port.md
- github.com/Dittobyte/Recompia/blob/5fe4164613402749b2c3aab711d8e445054fafd1/launcher/README.md
System and game requirements
- The reviewed README requires your own extracted Pokémon Pokopia 2.0.1a, including its update. Use a folder containing base/ and updates/ with ExeFS/RomFS, or a .nup or .nx package made from extracted files. NSP/XCI are not accepted directly. Link Play documentation refers to game 2.0.1; keep the setup requirement 2.0.1a and match peers’ releases.
- Windows 10/11 x64 or native Linux with Vulkan 1.3 and a compatible GPU driver. The Linux launcher guide specifies glibc 2.35. Releases provide separate Linux x64 and experimental Arm64 archives; choose the CPU architecture you actually use.
- Apple Silicon M1 or newer, macOS 13+ for the Mac package. It contains MoltenVK and uses Apple clang for local compilation. Follow the macOS package notes; an Intel Mac build is not supplied.
- Setup checks Vulkan, memory and free space: about 14 GB with packed shader files or 31 GB with loose files, in addition to the game dump. Loose translated shaders can occupy about 26 GB. These are setup space checks, not a total storage or RAM guarantee; initial translation may take a long time and can be paused.
Features described by the developer
- Link Play on the same network or via a project relay, with documented pokopia-native cross-play. Story-area interaction and seamless co-op are experimental and off by default. Nintendo’s online service is not implemented.
- Save import from Eden/Ryujinx or a folder containing B00, G00 and S00, with backups. PokoHex is integrated in the launcher’s Save Editor; edit only with the game closed and keep a backup.
- F1 settings, remappable keyboard/controller input, mouse mode, resolution and render scale, HDR and ultrawide options. FSR 1 and NVIDIA Image Scaling are described as working; the README advises leaving FSR 3 and DLSS/DLAA off while they need rework.
- RomFS replacement mods and translations without changing the dump; mods replacing files containing shaders are unsupported. Launcher updates can rebuild only changed work. Version 0.13.9’s Online events switch simulates connectivity for timed events; it does not enable other Nintendo online services.
Getting started
Choose your OS/CPU package from Dittobyte/Recompia releases and extract it completely. Windows uses PokopiaLauncher.exe, Linux uses PokopiaLauncher.AppImage, and Mac uses PokopiaLauncher.app. Keep the tools beside the launcher.
Select your own 2.0.1a dump in Game files and press Set up. Let local game compilation and shader translation finish; Pause/Continue setup preserves completed work. “Use fewer cores” reduces build load. An incompatible or damaged dump must be corrected before continuing.
Press Play after setup. Linux runs natively without Proton/Wine; if FUSE is unavailable, use --appimage-extract-and-run. On Steam Deck, add the AppImage as a non-Steam game in Desktop Mode and use --play. Mac users should follow the package’s own startup notes.
Back up save/ before updates or editing. For v0.13.9, the notes say Update then Set up again; shaders and saves are kept. Settings are pkp.ini and controls.ini, game diagnostics pkp.log, setup diagnostics setup.log. Report logs and hardware without attaching game data, build output or shader caches.
Recompia — Downloads
Find maintainer-hosted files, package selection advice and recent releases on the dedicated download page.
Choose a package and check releasesPlatform packages and limits
| Platform | Package and documented status |
|---|---|
| Windows x64 | PokopiaRecomp-<version>-win64.zip; local compilation and Vulkan graphics. |
| Linux / Steam Deck | linux-x64.tar.gz contains the native AppImage and tools; no Proton/Wine. linux-arm64.tar.gz is an experimental separate build. |
| Apple Silicon Mac | Recompia-<version>-macos-arm64.zip, M1+, macOS 13+, bundled MoltenVK. Mac notes leave movies, peer Link Play and a physical controller unverified. |
Link Play requirements and online limits
Each player needs their own save, matching game/release versions, mods and experimental co-op switches. Set Link Play to Same network or Internet in the launcher, restart the game, then use Local connection at the first house’s PC once unlocked. The project relay does not encrypt game traffic. Nintendo’s Online connection is not available, and the Mac port has not verified peer multiplayer.
View sourceRecompilation questions
Where can I download Recompia?
Use the upstream release links on this page. Dittobyte provides the files; Switch2Fan does not host binaries or game data.
Which Recompia package should I use?
Choose a package for Windows, Linux (x64 / Arm64), macOS (Apple Silicon) that matches your CPU architecture. Read the package-selection table and the upstream requirements before installing. A launcher, development dependency and runtime may be separate files.
Is the newest listed release guaranteed to be stable?
No. Check the prerelease label and the upstream notes. Releases marked with a developer caution do not expose direct file downloads. An hourly metadata check is not a game compatibility test.
Sources & review
Reviewed · README 2fdda31
- github.com/Dittobyte/Recompia
- github.com/Dittobyte/Recompia/blob/2fdda31288427d5a3ebcaefc26c5d90c543df23c/README.md
- github.com/Dittobyte/Recompia/releases
- github.com/Dittobyte/Recompia/releases/tag/v0.13.9
- github.com/Dittobyte/Recompia/blob/2fdda31288427d5a3ebcaefc26c5d90c543df23c/launcher/README.md
- github.com/Dittobyte/Recompia/blob/2fdda31288427d5a3ebcaefc26c5d90c543df23c/docs/link-play.md
- github.com/Dittobyte/Recompia/blob/2fdda31288427d5a3ebcaefc26c5d90c543df23c/docs/multiplayer/README.md
- github.com/Dittobyte/Recompia/blob/2fdda31288427d5a3ebcaefc26c5d90c543df23c/game-build/release_b/README.macos.txt
- github.com/Dittobyte/Recompia/blob/2fdda31288427d5a3ebcaefc26c5d90c543df23c/docs/macos-port.md
- github.com/Dittobyte/Recompia/blob/2fdda31288427d5a3ebcaefc26c5d90c543df23c/LEGAL.md
- github.com/Dittobyte/Recompia/blob/2fdda31288427d5a3ebcaefc26c5d90c543df23c/CREDITS.md
- github.com/Dittobyte/Recompia/blob/2fdda31288427d5a3ebcaefc26c5d90c543df23c/LICENSE