To update, run the new installer on your existing install folder. It keeps your game files, saves and totk.ini, and rebuilds totk.exe and the shaders.
Warning
I have not tested the Linux build myself. DLSS is tested by the community only: I don't have the hardware for it.
Note
Experimental, off by default. They can help on some PCs and harm on others.
- Linux PGO build:
TotK-Setup-0.5.0-x86_64-pgo.AppImage. On Windows PGO gives 6-12 % more FPS; on Linux nobody has compared yet. Post your FPS with both AppImages at the same place. sync_ahead = 1withoutshadow = 1, Windows with a dedicated GPU (#1129, #1192). 6-10 % more FPS on a GTX 1050 Ti laptop, same 1% lows. If you had it set before, it was ignored and now takes effect. Report FPS off and on, and any flicker, misplaced objects, gloom on clean ground or crash in #1192.barrier_merge = 1: fewer render passes with water and decals (#1237). A waterfall on an RX 7900 XT: 82 to 141 FPS. On NVIDIA it may flicker or show squares at water and decal edges.gyro_auto_bias = 1: for bow aim that drifts after Calibrate gyro (#292, #1267). Turn on Gyro drift learning at rest on the Controls tab and put the controller down for a second now and then. Tell us in #292 if it helps.
Features
- AMD FSR 3.1 upscaler and frame generation, on any GPU (#460, #537, #1158). Built into the game, no extra DLL, off by default.
- Upscaler: set 3D scene upscaler to AMD FSR 3.1. Less shimmer on grass, wires and far edges; modes below Native give more FPS. FSR 3.1 sharpness sets the sharpening (default 80, 0 off). Costs about 1.5 ms of CPU per frame: more FPS when the GPU is the limit, about 10 % less when the CPU is.
- Frame generation: set Frame generation on the Game tab to AMD FSR 3 (
frame_gen = fsr3, applies at once). A generated picture goes between every two drawn ones: the game draws at half the frame limit, the screen gets the full rate. Use it when the game draws at least 60 FPS; below that artefacts and input lag grow.
- PlayStation button prompts (#180). Set Button prompts on the Controls tab to PlayStation (
prompts = playstation), applies at the next start. Menus, HUD and texts show × ○ △ □, L1, R1, L2, R2, Options and Share. With Button layout on Xbox or Auto, × is the bottom button. - The game builds a missing screen layout or prompts folder itself (#180, #378). After a change of resolution, HUD width, Button prompts or Button layout, it builds the files in the background (about a minute of one core, low priority) and uses them at the next start. The Prepare button on the Screen tab is gone.
- Quick save and quick load (#1188, game 1.4.3). Turn on Quick save on the Controls tab: F6 saves, F7 loads, both keys can be rebound. A quick save replaces the oldest autosave; the manual save stays. Not available in cutscenes and dialogues.
- Free camera (#1199, #1213, game 1.4.3). Turn on Free camera on the Controls tab (needs a restart) and pick a gamepad combo (for example ZL + ZR + L3) or a key. Each press steps through: fly away from Link, leave the camera where it is while you play, back to normal. While flying: left stick or W A S D to move, ZR / ZL up and down, right stick or mouse to turn, R / L double or halve the speed; the game gets no input.
Mods
- The Mods tab order decides code patches too (#790). When two mods patch the same code, the higher one wins, as with files. Reorder and restart, no rebuild. Each mod's row lists what it overrides and what overrides it. A mod with code the port cannot run can be used without that code through its switch "Use ... without its code" (off by default: the mod's files may need that code).
- Mods with code plugins work (#845, #1249).
exefs/subsdk*plugins built with exlaunch now run, for example The Second Quest's MSFix, Full Inventory Expansion and Quick Weapon Durability. The next start builds the plugin in, a few minutes once. Plugins that need more than the port offers, such as UltraCam, stay off and their row says why. - Code mods no longer need the setup folder (#845). The setup copies its build tools into the game folder (
build-kit0.6 GB,build-cache1.5 GB). After that you can delete the setup folder or move the game folder, and updates reuse the cache. Run the new setup once on an existing install.
Graphics
- DLSS and FSR 3.1: the characters' motion vectors cost less CPU. About 0.65 ms less render-thread time per frame in the town on a Ryzen 9 7900X. The picture is unchanged.
- HUD width for ultrawide screens (#643, #1262). HUD width on the Screen tab keeps the hearts, the minimap and the rest of the HUD within the middle 21:9 or 16:9 of a wider screen; the picture still fills it. The default
fullchanges nothing.
Memory and crashes
- Renderer memory is sized as on the console. The port reported the game's renderers up to three times the console's command memory; in another port this ran a renderer out of memory near Zora's Domain and crashed the game. The figures now match the console. No cost.
Fixes
- Gyro aiming works when the game is started from Steam (#1282). Steam Deck, Steam Controller and DualSense under Steam Input had no gyro. Motion now comes from the real controller and buttons from Steam's pad, so Steam's remapping still applies. The Steam layout needs a gyro binding (for example Gyro Behavior "As Mouse" on a back button), or Steam turns the gyro off.
- The bow aim no longer turns sideways on a tilt right after a load (#1274). The aim starts level and settles within a second while the controller is held still.
- Linux: the controller works while another window has focus (#971).
- The menu shows the installed version after an update (#1078). It could show the previous release or
unknown. Every update now rebuilds the exe: one more compile and link. - NVIDIA Reflex no longer holds 60 fps with
fps_limit = display(#1239). Reflex now uses the monitor's measured rate, as the frame pacer does. A numericfps_limitwas not affected. - Sound no longer goes silent above 200 fps (#337). With
fps_limitabove about 200 all sound turned off a few seconds after the start until a restart.audio_drain_fix = 0restores the game's code. - Contact shadows no longer make caves and shaded ground flat and smoky (#439).
contact_shadowsnow darkens only sunlit surfaces. Grass in full sun can still show fine dark speckle at high strength. Off by default; a little cheaper on the GPU when on. - Soft shadows no longer get blurrier in steps away from Link (#1291). With
pcsson, the blur keeps its width across the shadow cascades. The shader cache is rebuilt once after the update, for every player. - The mouse turns the camera in Autobuild's placement view (#1300). With
mouse_mode = directon 1.2.1 and 1.4.3, the mouse now acts as the right stick in cameras the direct mode does not reach. - Field of view works on game 1.2.1 (#1255). Recall aiming follows it too.
- Game 1.1.0: dynamic resolution can be turned off (#1252). With it off, the scene no longer drops to 90 and 80 % in busy places.
- Game 1.1.0:
sync_aheadworks (#1253). Off by default, needsshadow = 1. - Game 1.1.0: full climbing speed above 60 fps, and shrine gears open their doors (#35, #276, #1001, #330, #984). Above 30 fps gears and water wheels counted as stopped, so the doors in Riogok, Turakamik and the Wind Temple stayed shut. The 1.2.1 fixes
climb_fix(needsrealtime = 1) andhighfps_fixnow cover 1.1.0. - Game 1.4.3: the launchers in Tenbez Shrine land the ball above 30 fps (#1215). Above about 45 fps the ball stopped on the rim and could fall into the pit. Only these two launchers change;
shutter_fix = 0restores the game's speed. - Chinese and Korean text: the ellipsis sits on the line again (#591).
- Shadow range works on 1.2.1 and 1.4.3 (#606).
shadow_rangenow reaches the open world: at 300 sharp sun shadows reach three times as far. - DLAA: dust and small particles in shrine fog can stay visible (#1263). The new switch Fog and particles after DLAA on the Screen tab (
dlaa_effects_after = 1) draws them over the smoothed picture. Off by default: water edges are then not smoothed, and the inventory preview and the scope are not checked yet. - Falling rain is back with shadow storage (#1233). With
shadow = 1(the default on Linux, Wine and Proton) rain showed only splashes on the ground. About 0.1 ms of CPU per frame in rain;wb_merge = 0restores the old behaviour. - Puddles and still water no longer flicker (#1126). The reflection no longer switches on and off in patches while the camera stands still, with or without DLAA.
- No more stretched slabs after a load with
sync_aheadand replay workers. Withsync_ahead = 1andreplay_workersset on a discrete GPU, a load could leave huge stretched slabs, a ceiling over Link or walls in place of trees for the whole session. - DLAA on 1.4.3: water seen at a low angle no longer flickers (#1126). Ponds and streams no longer flip between the reflection of the trees and of the sky, and Link and other characters stay steady and sharp.
dlaa_cam_jitter = 0restores the old behaviour. - DLSS: fogged areas in the Depths keep a steady brightness. The new switch Fixed DLSS exposure on the Screen tab (
dlss_fixed_exposure, off by default, applies at once) stops large fogged areas turning darker or lighter for a frame while the camera moves. sync_aheadon 1.4.3: no gloom on clean ground in the Depths, and shrine lamp reflections stay on. Link standing still in the Depths could get the gloom haze and die. Costs about 1 % of run time, only withsync_aheadon.
Performance
- Frame-ahead keeps its gain on more frames (#1131). With
sync_ahead = 1the game no longer waits for the GPU about every ninth frame: in the town, the waits fell from 317 ms to 25 ms over 40 s. - AMD: no more FPS loss after 5-10 minutes of play (#1174). On AMD's Windows drivers FPS fell from 60 to 20-30 until a restart. The cause, the "device lost" address report, is now off by default, so the
addr_report = 0workaround from 0.4.1 is no longer needed.addr_report = 1turns it back on to chase a device lost. - Fewer FPS drops on attacks, tree chopping and cutscenes with some controllers (#329). Rumble no longer stalls the game, which hit Bluetooth controllers most. The
rumble = 0workaround should no longer be needed. - Perf traces can skip the memory census (#946).
TOTK_PERF_CENSUS=0withTOTK_TRACE=perfremoves its cost, about 3 % of a traced Steam Deck frame. Traces only.
Thanks
Thanks to St5sz2Jk for the Steam Input gyro fix, ipavlin98 for the gyro levelling, airquark for the drift learning, ARHCOS and hstormo for reporting the drift, jretropie for reporting the lost controller input out of focus, Zolrex for reporting the missing version, oHatless for finding the cause of the AMD slowdown and its workaround, 1033929578-tech for reporting it with logs, itaskaev2 for the Reflex frame limit fix, quick save and the Autobuild mouse fix and for testing the PRs of this release, ipavlin98 for the rain fix, the DLAA effects switch, the puddle and DLAA water flicker fixes, the stretched slabs and Depths gloom fixes with sync_ahead and the fixed DLSS exposure, ProSep for the frame-ahead write-backs and the HUD width, Marjaperse for bringing it onto the Shapes step, ripps818 for barrier_merge, Eric Dallo and itaskaev2 for using mods without their code (from The Second Quest support in #790), itaskaev2 for the design of plugin support (#845), Ducvu159753 for reporting plugin mods (#1249), and shinodanpen for the sound fix above 200 fps the field of view on 1.2.1 and the shadow range fix, and Marjaperse for the 1.1.0 dynamic resolution and sync_ahead fixes, fabiomode2 for the PlayStation button prompts (#741), and Swordman14, kurerb, ctstuds, NazusANG and The-Gaymer for asking for them, Mrbronzaico for finding that rumble caused the FPS drops (#329), PucKoyomiS for reporting the mouse in Autobuild (#1300), Specht2010 and itaskaev2 for the contact shadows in caves (#439, #1219), ireallyLoveKetchup for reporting the soft shadow steps and itaskaev2 for fixing them (#1291, #1299), lebomis for the free camera (#1213) and nosehetmano-wq for asking for it (#1199), shenjackyuanjie for the 1.1.0 climbing and gear fixes (#1155), and falo2k for reporting the Tenbez Shrine launchers with saves and videos (#1215) and shinodanpen for fixing them (#1295), rcyggdra for reporting the Chinese ellipsis and finding its fix, and lostars for that fix in MacNativeGames (#591), itaskaev2 for the setup in seven more languages (#497) and Luxury213 for the first Spanish setup (#815), the SavageWind recompilation for showing how to build FSR 3.1 from AMD's SDK sources, xellow78-lgtm for the first frame generation and FSR 3.1 ports (#1089, #1084), codexx-dev for the FSR 3.1 sharpening and steady-picture fixes (#1245), Lucas-blip-png, itaskaev2 and VictorSCosta for the earlier FSR 3.1 work (#228, #914, #876), and samsepl0l, Jaoneto, Asreix367, Jupinga157 and JamesDoesGaming902 for asking for frame generation and FSR (#460, #806, #730, #537, #1158), klikso for the switch for the perf trace's census (#1330), corne-ac for the Steam Deck profile that found its cost (#946), and nosehetmano-wq and Z5Meisosis for measuring sync_ahead (#1129, #1192).