gminustwo/primerecomp

选用指南

AI 根据 README 整理 · 2026/10/26 11:56:26

目标用户

面向拥有该游戏正版文件、希望在 Windows、Linux 或 Steam Deck 上原生游玩并享受高分辨率、高帧率等增强功能的玩家。

查看 README 依据

# PrimeRecomp [](https://buymeacoffee.com/rengar) **PrimeRecomp** runs *Metroid Prime Remastered* (Nintendo Switch, 2023) natively on Windows and Linux, including the Steam Deck. The game's code is statically recompiled - translated ahead of time from the Switch's ARM64 code into C and compiled for your PC - and the Switch's system services and NVN graphics are reimplemented on the PC, with Vulkan for the graphics. No emulator runs. > [!IMPORTANT]

- Ultrawide and any aspect ratio (the HUD stays in the 16:9 middle), adjustable field of view - 60 or 120 frames per second - Gyro aiming with controllers that have one, rumble - Any cutscene skippable ## Support PrimeRecomp If you enjoy PrimeRecomp, you can support its development by [buying me a coffee](https://buymeacoffee.com/rengar). Bug reports and a star for this repository and for [LAS Recomp](https://github.com/peiikai/LASRecomp) help too. ## Building from source

使用方式

Windows 解压后运行 primerecomp.exe，Linux 运行 AppImage；首次启动时选择游戏文件文件夹进行设置，之后按 Play 即可游玩。支持键盘鼠标和多种手柄。

查看 README 依据

extract it somewhere you can write to (e.g. Documents or a games folder - not Program Files). 2. Run `primerecomp.exe`. The start screen asks for your game files: choose the folder that holds `exefs` and `romfs`, then **Set up**. It copies what it needs and recompiles the game on your PC. This happens once and takes several minutes. 3. Press **Play**. Everything PrimeRecomp writes - game files, saves, settings (`primerecomp.ini`), logs - stays in its own folder. ### Linux 1. Download `PrimeRecomp-v0.0.2-linux-x86_64.AppImage` from

[Releases](https://github.com/gminustwo/primerecomp/releases) and make it executable (`chmod +x`, or in your file manager: Properties -> Permissions -> executable). 2. Run it. The start screen works as on Windows: choose the folder that holds `exefs` and `romfs`, **Set up**, then **Play**. Everything it writes goes to `~/.local/share/primerecomp`. If the AppImage won't start with a FUSE error, install your distribution's `fuse3` package. More in [docs/linux.md](docs/linux.md). ### Steam Deck

PrimeRecomp's menu -> Controls -> Face buttons to Xbox (A at the bottom). With a controller that has a gyro you can use the game's Pointer / Hybrid motion aiming (pause, Options -> Controls -> Control Scheme). Keyboard and mouse play like a PC shooter: | | | |---|---| | Move | WASD | | Aim / turn | Mouse (sensitivity and invert in PrimeRecomp's menu, Controls tab) | | Shoot (hold: charge) | Left click | | Lock on / scan (hold) | Right click | | Jump | Space | | Missile | F | | Morph Ball | Left Ctrl | | Visors: Combat / Scan / Thermal / X-Ray | Q / E / R / T |

部署要求

需要 Windows 10/11 64位或 Linux 64位 x86 系统（glibc 2.35+），CPU 支持 AVX2，GPU 支持 Vulkan 1.3，约 15GB 磁盘空间，并需自备《密特罗德 究极 复刻版》v1.0.0 游戏文件（包含 exefs 和 romfs 的文件夹）。

查看 README 依据

always holds the latest run, and `primerecomp.previous.log` the run before. For a graphics problem, press **F9** at the spot: it saves a capture of that frame in `build/f9_<frame>/` in that same folder (zip it up), and **F8** notes your position in `positions.txt`. ## Requirements - **Windows:** Windows 10 or 11, 64-bit - **Linux:** a 64-bit x86 distribution with glibc 2.35 or newer (Ubuntu 22.04, Debian 12, Fedora 36, Arch, SteamOS on the Steam Deck, ...) - A CPU with AVX2 (Intel Haswell / 2013 or newer, AMD Zen or newer)

- A GPU with a Vulkan 1.3 driver (any current NVIDIA, AMD or Intel driver; on Linux, Mesa's RADV / ANV or NVIDIA's) - About 15 GB of free disk space (the game files are copied in, about 7 GB, plus the recompiled game) - Your own Metroid Prime Remastered v1.0.0 game files, **extracted**: a folder holding `exefs` and `romfs` (extract both from your own dump with your usual Switch tools) ## Getting started ### Windows 1. Download `PrimeRecomp-v0.0.2-windows.zip` from [Releases](https://github.com/gminustwo/primerecomp/releases) and

已知限制

当前为早期测试版（v0.0.2），图形缺陷（部分光照错误、雨滴等特效缺失）仍存在；尚未测试区域可能崩溃或卡死。Linux 版本仅通过软件渲染运行过，尚未在真实 GPU 或 Steam Deck 上测试；macOS 和 Android 版本尚未完成。

查看 README 依据

 ## Status: v0.0.2 (early beta) The game boots, the Frigate Orpheon plays through, and Tallon IV is playable (the Landing Site, Chozo Ruins and Magmoor Caverns have been played so far), with saving and loading. Graphics bugs remain: some lighting is wrong, and visor effects such as rain drops are missing at times. Areas nobody has reached yet may still crash or freeze. **New in v0.0.2: Linux and the Steam Deck.** The Linux version is experimental: so far it has run on a software

renderer only, not yet on real Linux GPUs or a Steam Deck, so reports of how it goes are very welcome. ### Still to do - Fixing the remaining graphics bugs - Testing the Linux version on real hardware, the Steam Deck first - A macOS version (LAS Recomp already runs on macOS, so much of the groundwork is there) - An Android version If something goes wrong, please open an [issue](https://github.com/gminustwo/primerecomp/issues) and attach `primerecomp.log` (Windows: in the PrimeRecomp folder; Linux and Steam Deck: in `~/.local/share/primerecomp`). It