TotK Recomp troubleshooting
Most problems are GPU-driver specific. Update to the latest release first: every version so far has fixed AMD and Intel rendering bugs.
Before reporting a bug, read the pinned known-issues post on the issue tracker. If your problem is there, comment on that issue with your version, GPU, driver and logs\totk.log. Never paste your keys into a log or an issue.
Common problems and fixes
Game closes a few seconds after the Nintendo logo (AMD RX 5000/6000)
The log ends with FATAL: vk: upload submit failed (-4) or vk: device fault. Update to the latest release first. If it still crashes, open totk.ini next to totk.exe and set astc = cpu (remove the # at the start of the line). Tracked in #5, #154 and #160.
Game does not start at all on an older CPU
TotK Recomp needs AVX2. Intel 2nd/3rd gen (Sandy Bridge, Ivy Bridge) and older are not supported, and there is no workaround (#11).
Black world, broken textures or green flashes on RX 470/480/570/580
Known issue with no workaround yet (#67).
Garbage at the top of the screen, pink glow, blocks in the grass (RX 6000 above 1080p)
Fixed in 0.2.1. Update by running the new setup on your install folder.
Black characters on AMD RX 400 to RX 6000
Fixed in 0.2.1. If your card still shows them, toggle the new “Dynamic alpha to coverage” switch on the Advanced tab.
Sound stops after a while and does not come back
Known issue, no workaround yet (#131). A separate bug where sound delay built up over long sessions was fixed in 0.1.9.
Slowdown to about 16 fps on a 4 GB GPU
Fixed in 0.1.6 (tex_vram_pressure). Also try astc_bc = 1 and a lower game resolution.
Game froze after I alt-tabbed during a load
Before 0.2.1 the game paused when it lost focus, and a load interrupted that way could stop for good. 0.2.1 keeps it running by default (assume_focus = 1).
Chinese or Japanese IME steals Shift or shows a candidate window
Fixed in 0.2.1.
Blurry picture with Windows display scaling above 100%
Fixed in 0.1.6; the game now renders at full resolution in fullscreen and windowed mode.
Setup runs out of memory on a many-core PC
Fixed in 0.1.6: the code generator sizes its threads to free memory. If it still fails, close other programs and run the setup again; it resumes.
Setup fails with a damaged input file
The check check.input_damaged names the file whose data fails its hash or ends early. Copy that file again from your own source.
Windows SmartScreen warns about TotK-Setup.exe
The installer is unsigned. Choose More info, then Run anyway, for the file from the official Releases page only.
Android / DroidDeck / other mobile Vulkan drivers
Not supported: the port needs VK_EXT_external_memory_host (#161).
Where the logs are
logs\totk.log in the install folder holds the last run; totk.1.log to totk.4.log hold the four before it. On a GPU crash the log records the driver’s crash report, and on a fatal error it records memory use.