Repository navigation
Steam Deck
What helps on a Steam Deck, from two days of runs on a Steam Deck LCD (SteamOS 3, game 1.8.0, mkw-recomp 0.1.9 to 0.1.11, 13-14/11/2026) by the author of #351. The numbers are what those builds did; later versions may be faster.
mkw-recomp detects the Deck by itself and starts fullscreen at 1280x800 with VSync, and since 0.1.12 it renders the race at 720 lines (see Settings and mkw.ini).
Video memory in the BIOS: leave it at 1 GB. The Deck's 16 GB are shared, and the BIOS reserves part of them for
the GPU (Setup Utility → Advanced → UMA Frame Buffer Size). Emulator guides often say 4 GB: that leaves Linux 11.7 GB,
and in a race (4.2 GB of RAM plus 5.6 GB of video memory) the system swapped and frames took 200-330 ms for seconds at a
time. At 1 GB, Valve's default, Linux has 14.8 GB and the stalls are gone. The log says how much is reserved:
vk: integrated GPU, <n> MiB carved out of RAM by the firmware. To enter the BIOS: power off, hold Volume Up and
press Power.
Game folder on the microSD card. The setup needs about 30 GB, which the internal drive often does not have: Choose game folder on the start screen can put it on the card. Format the card as ext4. After a restart SteamOS sometimes did not mount the card again and the game could not find its folder; taking the card out and putting it back mounts it.
Setup time. The first setup took 51 minutes and an update 16. Plug the Deck in.
Gaming Mode. From 0.1.14 the start screen finds your copies by itself (Downloads, Desktop, Emulation, the SD card
and other drives), checks the free space before copying, and Add to Steam creates the shortcut with its library
art. Started from Steam, the game skips the start screen and opens fullscreen with the controller working, unless the
start screen has something to say (files not set up, an update to finish); hold View at start to open it anyway.
Settings → General → Start screen changes it, and --play in the launch options is no longer needed.
| Setting | On the Deck | Why |
|---|---|---|
| Graphics → Internal resolution | 720 (the default since 0.1.12) | Original renders at the console's docked 2560x1440 and scales it down: time trial 35.7 → 24.6 ms a frame |
| Graphics → Quality | Low | Quarter textures, detail distance 1, 1024 shadow map: less video memory, which on the Deck is RAM |
| Screen → Frame generation | Off | On 0.1.9 the base frame rate dropped from ~30 to ~24 fps, with a ~160 ms hitch every ~6 s |
| Steam overlay → Frame limit | Your choice | A 40 fps limit did not slow the game down |
| Steam overlay → Manual GPU clock | 1000 MHz or off | 1600 MHz uses up the shared 15 W and leaves the CPU less; 1000 MHz was as fast as 1300 MHz |
Docked on a large screen, choose a higher internal resolution in the menu: the 720 default only applies while
mkw.ini has no RESOLUTION line.
| Scene (0.1.11, 720 lines, Low) | Frame time | Limited by |
|---|---|---|
| Time trial, one kart | ~23 ms (~43 fps) | GPU |
| Grand Prix, 24 karts | ~36 ms (~27 fps) | CPU: the game's own code and the translation of its GPU commands |
The game picks a frame time of 1/60 or 1/30 s itself (Settings → Screen → Frame rate on Automatic). Above 30 fps the
race runs at full speed (game: speed 1.00x in the log); below 30 fps it runs in slow motion, ~0.9x in a Grand Prix.
If the CPU drops to 400 MHz and the GPU to 200 MHz again and again for 4-20 s at a time (the game then runs at 0.1-0.3x), on the charger and on battery, at any temperature, and with other programs too, check the fan's sensor. On the Deck these notes come from, the fan turned but the Deck read 0 rpm, reported a fan fault, and its firmware held the clocks down. In Desktop Mode's terminal:
cat /sys/class/hwmon/hwmon*/fan1_fault /sys/class/hwmon/hwmon*/fan1_input 2>/dev/null
1 and 0 is that fault; a healthy Deck reports 0 and a speed of some thousand rpm. The game cannot change it:
reseating the fan's cable did not help, it needs a new fan.
-
GPU resets (
amdgpu: ring gfx_0.0.0 timeout ... Process mkwinjournalctl -k; the game's log just stops): fixed in 0.1.11 (#281). -
Out of video memory (
physical pool chunk ... device-local allocation failed): 0.1.11 (#295) and 0.1.12 (#326) free memory first; 0-2 per run left on the Deck. - Gaming Mode closed the game with nothing said when the game files were gone (#486): 0.1.14 opens the start screen and says where they were and how to get them back.
- Hitches of 0.3-1.1 s mid-race from saving the pipeline cache (#533): 0.1.14 saves it in menus and loads only.
Something wrong or missing here? Say so in Discussions. mkw-recomp is not affiliated with Nintendo.