Compatdata Redirect

Compatdata Redirect

might require some more optimizations and improvements - free to submit test results, improvements, suggestions

When changing the used Proton Version for a game, files in the Compatdata are changed and renewed. This does not always work well, and with recent Proton Versions it is even possible that the Compatdata has to be removed as it got broken.

tinkergame can circumvent this problem, by allowing you to map the currently selected Proton Version to a corresponding Compatdata directory (or alternatively delete the compatdata)

This can be configured via two different ways, by selecting either single-proton or global-proton in the corresponding "Redirect compatdata" Game Menu option. (by default this option is "disabled" - meaning the regular Compatdata directory is used)

When enabling either of the options tinkergame doesn't migrate any game configuration (yet?) from the current Compatdata to the new one, so the user has to take care of migrating any configs.

Note: If a symlink exists for the prefix already that was not created by TinkerGame (for example on Steam Deck), there may be unforeseen consequences!

single-proton

When using this option the custom Compatdata directory is stored in the compatdata/tinkergame subdirectory as SteamAppID-Proton Version (f.e. 31337-proton-6.3-4) besides the regular Compatdata of the game.

The regular Compatdata will be replaced with a symlink pointing to the custom Compatdata. If the regular Compatdata already exists, it will be

• reused, if its Proton Version matches
• renamed (with random backup suffix) if it is a real directory and the Proton Version does not match
• re-created if it is already a symlink, but points to a Compatdata using a different Proton Version

global-proton

This option works almost identically to the single-proton, but the custom Compatdata is stored in $STLPROTCOMPDATDIR/compatdata-Proton Version (f.e. ~/.config/tinkergame/proton/compatdata/compatdata-proton-6.3-4) The Compatdata symlink for the game is created accordingly. Using this option it is possible to share one single Compatdata between all games using this option and the same Proton Version

SteamUser-Redirect

Both single-proton and global-proton options can be combined with the additional per-game REDIRSTEAMUSER option in the Game Menu, which can be used on the SteamUser directory. The following modes are available:

• disabled (default, the SteamUser remains unmodified)
• symlink (the SteamUser is symlinked to a central location - see SteamUser for options)
• restore-backup (the SteamUser is restored from the Backup - see Backup for options)

When disabling a symlink again, tinkergame replaces it with a real directory and either recovers the data from the central directory (only when it is a per-game directory) or recovers from the per-game backup if available.