Skip to content
This repository has been archived by the owner on Mar 12, 2023. It is now read-only.

Latest commit

 

History

History
106 lines (81 loc) · 6.39 KB

Touhou.md

File metadata and controls

106 lines (81 loc) · 6.39 KB

Set up thcrap and vsync patch for Touhou games bought on Steam

Based on tutorials from

I will use TH10 Mountain of Faith as an example in the followiing steps. I tested on my Steam Deck and Arch Linux with Flatpak version of Steam.

Apply thcrap

  1. Download the TH10. Switch to desktop mode if you are using Steam Deck.

  2. Download thcrap from here, and extract to a directory. I put thcrap and all other patches/scripts under ~/Touhou directory, so it would be /home/deck/Touhou/thcrap/.

  3. Locate your Steam game directory.

    • For Steam Deck, it's under /home/deck/.local/share/Steam/steamapps/common/ if you installed the game on internal SSD, or /run/media/mmcblk0p1/steamapps/common/ if installed on micro SD card.
    • For general Linux distributiions, if Steam is install as a system package, game directory is /home/$USERNAME/.local/share/Steam/steamapps/common/.
    • If you installed Flatpak version of Steam, it's /home/$USERNAME/.var/app/com.valvesoftware.Steam/data/Steam/steamapps/common/. For each Touhou game you would find the th*.exe file under its directory. I will use /home/deck/.local/share/Steam/steamapps/common/th10/th10.exe in the following tutorial.

  4. Go to the thcrap folder ~/Touhou/thcrap and crate a config folder. Inside of the config folder cate a games.js file with content

    {
  "th10": "Z:/home/deck/.local/share/Steam/steamapps/common/th10/th10.exe",
  "th10_custum": "Z:/home/deck/.local/share/Steam/steamapps/common/th10/custom.exe"
}

    replace the path with the one in previous step. The Z: is how wine locate files on Linux.

  5. Add the thcrap.exe to your Steam library. On Steam Deck you can right click thcrap.exe --> Add to Steam. Or you can open Steam, go to your library, and at bottom left click ADD A GAME manually add thcrap.exe to Steam. If you are using Flatpak version of Steam, you may need to add the permission to allow steam access ~/Touhou directory using Flatseal.

  6. Run thcrap.exe from Steam, if it doesn't run, go to the game setting (click setting bottom --> Properties --> Compatibility) check Force the use of specific Steam Play compatibility tool, and select specific proton version. The proton 7.0-5 works for me.

    If using Flatpak version of Steam, running thcrap.exe from Steam cannot not update repo. So I used Bottles instead. Create a new bottle with default gaming profile. Then go to settings disable dxvk. Next, under the dependencies menu install .NET framework 4.6.1. Add thcrap.exe to shortcuts, and run it.

  7. During he installation you choose your language patch. I use default english pack in this example. Then it will ask you game location, since we already added the game in games.js, just click next. Next, it asks for shortcuts. We don't create any shortcuts here, since we will add the patch to Steam launch command.

  8. Download thcrap_proton wrapper script from here. You can find its explanation at the github repo. I put the script here /home/deck/Touhou/thcrap-steam-proton-wrapper/thcrap_proton.

  9. Edit the thcrap_proton script with your favouriate text editor, change these two variables

    THCRAP_FOLDER="/home/deck/Touhou/thcrap"
THCRAP_CONFIG=en.js

...

    THCRAP_FOLDER is where your thcrap folder. THCRAP_CONFIG is the config file generated. You could find it under the "/home/deck/Touhou/thcrap/config" directory.

  10. Make thcrap_proton executable. You can either right click the script --> Properties --> Permissions check IS executable, or using command line in terminal chmod u+x /home/deck/Touhou/thcrap-steam-proton-wrapper/thcrap_proton.

  11. Change your Touhou game launch options. Go to your Steam library --> click your game --> settings icon --> properties. Edit LAUNCH OPTIONS under GENERAL settings to

    /home/deck/Touhou/thcrap-steam-proton-wrapper/thcrap_proton -e "%command%"

    Change /home/deck/Touhou/thcrap-steam-proton-wrapper/thcrap_proton according to your thcrap_proton script location.

  12. Now when you launch the game through Steam it will launch thcrap, then thcrap will update the patch and launch the game. It's recommended you uncheck the Keep the updater running in background in thcrap setting, so Steam could properly shutdown the game when you quit.

Apply vpatch

vpatch only works for the executable file from original disk. You need an .exe from original disk, not the steam version.

  1. Download the patch from touhouwiki, and extrat it to /home/deck/Touhou/VsyncPatch/.

  2. Go to vpatch_rev7 directory, then copy vpatch.exe, vpatch.ini and vpatch_th10.dll to the game directory /home/deck/.local/share/Steam/steamapps/common/th10/.

  3. Open vpatch.ini in the game directory with your favourate text editor. We are going to change windows size. For TH10 the default window is very small. If using 4K display, set enabled = 1, Width = 2667 and Height = 2000. If using 1080p display set Width = 1280 and Height = 960. Based on this tutorial.

  4. Make a backup of original Steam executable. Copy /home/deck/.local/share/Steam/steamapps/common/th10/th10.exe to /home/deck/Touhou/th10.exe.steam. This is for convenience, you can always recover it using Steam by verifing local data.

  5. Replace the /home/deck/.local/share/Steam/steamapps/common/th10/th10.exe with the one you leaglly obtained from original disk.

  6. Change the Steam game launch option to

    /home/deck/Touhou/thcrap-steam-proton-wrapper/thcrap_proton -v -e "%command%"

    the -v flag let Steam runs vpatch.exe