Recompia

[!IMPORTANT] No game files are included. You need your own extracted copy of the game, version 2.0.1a. This project provides no game files, keys or dumping tools. Not affiliated with Nintendo, The Pokémon Company or Koei Tecmo; Pokémon is a trademark of Nintendo, Creatures Inc. and GAME FREAK inc. (see LEGAL.md).

[!NOTE] Built with AI, supervised by humans. This project is developed primarily with AI, with Dittobyte developers as the supervisors. Note on Josh - They say they have a handful of years of development experience, so it's not all slop. Every commit is reviewed, verified and tested by before it lands.

Screenshots

Features

Play together (Link Play)

• Visit a friend's island, or invite them to yours, on the same Wi-Fi or over the internet.
• Cross-play with pokopia-native players.
• Set it up in the launcher's Link Play page. No files to edit.
• Step-by-step guide: Playing together.

Import your saves

• Already playing on Eden or Ryujinx? One button in Settings finds your save and brings it over. Your emulator's copy isn't touched.
• Got a save somewhere else? Pick its folder (the one with B00, G00 and S00 inside).
• Your current save is never deleted. It's kept as a backup folder first.
• If a save can't be written (a full disk, OneDrive or antivirus holding the file), your last good save is kept and the game tells you.

Easy setup

• Use your dump as it comes: a folder (with base and updates) or a single .nup or .nx file.
• Clear messages if something is wrong with your dump: the wrong game version, a missing update, or files damaged while copying. The launcher tells you what to do.
• Checks before it starts: enough disk space, a working graphics driver, enough memory.
• Use fewer cores keeps your PC usable while it builds. You can pause and carry on later.
• Updates are quick: only the parts that changed are rebuilt.
• The launcher tells you when a new version is out.

Controls

• Any controller: Xbox, PlayStation, Switch Pro and more, with rumble and motion. Buttons follow the Switch layout by default.
• Keyboard and mouse. The mouse also works in menus: click to confirm the highlighted item; scroll or use the arrow keys to move the highlight.
• Change any button on the F1 Controls page.
• On-screen button icons match what you're holding: keyboard, Xbox, PlayStation, Steam Controller or Switch.
• Typing your name works with a controller, mouse or keyboard.
• Quit without Alt+F4: hold Select and Start (View and Menu on an Xbox pad), or use Quit game in F1.
• Open the F1 menu from a controller: click both sticks (L3 + R3); change or turn it off with [overlay] pad in controls.ini (none = off). It cannot be the quit combination.

Steam Deck and handhelds

• Steam Deck, Legion Go S and other handhelds are recognised: controller icons stay on screen and the picture size suits the screen.
• 16:10 screens are filled edge to edge, with no black bars.
• Runs natively on SteamOS, with handheld speed-ups (about 26 to 53 fps on a Steam Deck and 55 to 75 fps on a Legion Go S, measured by players).
• The launcher runs on Linux and SteamOS too: see Linux, SteamOS and the Steam Deck.

Graphics

• Play at any resolution, 4K and above. Lower Render scale if it runs slowly.
• Quality presets (Switch 2, High, Ultra) set how far you can see and how sharp textures are.
• HDR on HDR screens.
• Window, borderless or full screen. Choose the monitor, cap the frame rate, show an FPS counter. Alt+Enter switches modes while playing.
• Upscalers: FSR 1 and NVIDIA Image Scaling work.
• FSR 3 and DLSS / DLAA are there but don't look good yet and need rework. Leave them off for now.

In-game settings

Press F1 in the game to change graphics, controls and sound (volume, output device, mute when the window is in the background). Most changes apply straight away.

Quick start

1. Download the zip from the latest release and extract it anywhere.
2. Run PokopiaLauncher.exe. If SmartScreen warns, choose More info → Run anyway. Pick your dump folder and press Set up: it compiles the game on your PC (about 7 minutes), then builds the shader cache (1 to 2 hours, you can pause and continue later).
3. Press Play.

F1 opens the settings in game. Middle mouse toggles Joy-Con 2 mouse mode (point and click to place and break blocks).

Linux, SteamOS and the Steam Deck

1. Download PokopiaRecomp-<version>-linux-x64.tar.gz from the latest release and extract it anywhere (for example your home folder).
2. Run PokopiaLauncher.AppImage in that folder (double-click it, or ./PokopiaLauncher.AppImage in a terminal). Pick your dump folder and press Set up: the first time it downloads its build tools (Python and Zig, about 100 MB), compiles the game, then builds the shader cache. You can pause and continue later.
3. Press Play.

Nothing runs through Proton or Wine: the launcher, the game, the shader translator and the build tools are all native Linux programs.

If PokopiaLauncher.AppImage does not start on a system without FUSE, run ./PokopiaLauncher.AppImage --appimage-extract-and-run.

To start the game from Steam (Game Mode on the Deck): in Desktop Mode, Add a Non-Steam Game, pick PokopiaLauncher.AppImage, and set its launch options to --play. More detail, and what was tested, in launcher/README.md.

This is the beginning of the README. Read the rest at the original. Read the full README ↗