A wrapper script for launching the official Touhou games on Steam with the Touhou Community Reliant Automatic Patcher (thcrap), and optionally the Vsync patch (vpatch) and thprac, from the Steam client using Proton on GNU/Linux.
This script works by setting up and managing a global thcrap instance, launching the configuration tool when needed, all without user intervention.
Before launching a game, this script takes the command Steam would normally run, and alters it to include the patch loader. This creates a seamless integration between the Steam client and thcrap, allowing the games to function as if they weren't patched at all!
On Windows, when launching a game bought on Steam with thcrap, Steam will be able to detect and automatically wrap it, so integration will work fine.
On Linux, this isn't the case. Due to the compatibility layer used to run the games, launching them from outside the Steam client will make Steam unable to detect that they are running. This means that, while using thcrap, Steam integration won't be available, your playtime won't be tracked, and your friends won't be able to see that you are playing weird indie Japanese shmups.
Also, with Steam Play/Proton, it is expected that you can run your games without having to mess around with Wine. For Touhou, it's annoying having to fire up Wine to be able to set-up the translation patches, and then having no proper integration with Steam when trying to play the games.
Here's a video tutorial by Maxmani.
yay -S thcrap-steam-proton-wrapper-git
flatpak install flathub com.valvesoftware.Steam.Utility.thcrap_steam_proton_wrapper
Download the script, mark it as executable, and put under /usr/local/bin/ (or somewhere that you find convenient):
curl -O https://raw.githubusercontent.com/tactikauan/thcrap-steam-proton-wrapper/master/thcrap_proton
chmod +x thcrap_proton
mv thcrap_proton /usr/local/bin
If you have gone through the manual installation, you have the opportunity to change the following variables inside the script:
- The
THCRAP_FOLDERvariable points to where the thcrap installation will be located. You can to change it, for example, if you want it to point to your current thcrap installation. - The
THCRAP_CONFIGdefines the config file that will be loaded when no other is specified in the launch options.
Go to your Steam library -> right click the game -> Properties -> and edit the launch options to:
thcrap_proton -- %command%
In case you have put your script outside /usr/local/bin/, you'll have to provide the full path:
/path/to/thcrap_proton -- %command%
This is the base command, which will run the game with the default config.
The default config is THCRAP_CONFIG, set to en.js if unmodified in the script.
To change the config file loaded by thcrap, use the -c flag, like this:
thcrap_proton -c pt-br.js -- %command%
would run the game with Brazilian Portuguese translations.
After installation, you can find all installed configs at $THCRAP_FOLDER/config.
Note: the %command% always comes at the end
To enable vpatch for that game, include the -v flag, like this:
thcrap_proton -v -- %command%
Note that this script does not install vpatch on it's own.
To enable thprac for that game, use the -p flag, like this:
thcrap_proton -p -- %command%
The script will download and install thprac to THPRAC_FOLDER.
Default location is /home/$USER/.local/share/thprac.
Upon launching thprac will ask whether to apply to the ongoing game, if running game in full screen mode you may need to minimize the game to see the dialog box. To change thprac language, don't attach thprac to ongoing game when prompted and it will start a launcher. Then change language in thprac setting.
If you want to use any environment variables in your launch options, you can put them before the %command%, like this:
thcrap_proton -- PROTON_USE_WINED3D=1 %command%
Upon first launch, the script will download and set-up a thcrap instance, if there's not one already, and then launch the configuration tool, so you can generate your config files.
After that, when the thcrap loader window shows up, click on 'Settings and logs' and uncheck 'Keep the updater running in background', so Steam can correctly detect when the game is closed.
And thats it!
The script sends all it's output to /tmp/thcrap_proton.log, which includes the original and modified launch commands.