Touhou Patch Center:Download
Project overview | ||||||
---|---|---|---|---|---|---|
About | Tutorial | FAQ | Download | Patch servers | Bug tracker | Wiki security |
Main Package (Multi-Language, Multi-Game)
- Pre-packaged patches based on our English translation (not recommended).
- Development Builds with the latest features, but also with more bugs (not recommended).
- For Wine users (Linux, Mac, and Steam Deck), you can look at the Wine tips page, which contains tips to make the thcrap installation easier and lists common issues and their solutions.
System Requirements
- Windows XP with at least Service Pack 2, or a later version of Windows; also works with Wine
- Internet connection only required for initial configuration and updating; without a connection,
thcrap
will simply use the last downloaded state
Setup Instructions
Video walkthrough
Alternative Text walkthrough on how to get just English
Concise
- First of all, you don't need to extract this into a specific game directory. The patcher can run from any directory.
- Run
thcrap.exe
and follow the instructions to create your patch configuration.
- You'll end up with a .js file (the configuration itself) as well as links to start every Touhou game found on your system with this configuration. Note that thcrap does not modify any existing Touhou installation on your system.
Detailed
- Download Patch and unzip (directory does not have to be specified; feel free to place wherever you want)
- Run
thcrap
to find the Touhou games. - Pick your languages.
Yes, plural. If you understand English to some degree, we recommend to always includelang_en
first, and your native language after that. Read more on the topic of patch stacking here. - Wait for the downloads to occur.
- In the browsing dialog, select the path where your Touhou games are located, or hit Cancel to search your whole system.
- Select your preferred version out of the Touhou games with multiple versions on your system.
- Use shortcuts.
- Enjoy.
Running on top of vpatch
This is possible as of the 2013-10-25 build. Due to the DLL-centric design of vpatch, thcrap
doesn't automate this yet, so this requires a few manual steps for now:
- If you don't have vpatch yet, please download it from Touhou Wiki or from the author's download page.
- Configure your patch stack as usual. If you have multiple versions of the games installed, it is merely important to choose the correct directory at this point.
- Open the generated
games.js
in a plaintext editor, and replace the game's .exe file names withvpatch.exe
(or whatever the local vpatch executable is called). - Starting the games through the shortcuts will then launch thcrap, vpatch and the game itself. thcrap will automatically enable support for Japanese characters and file names, so AppLocale is not required (yes, not even for 東方紅魔郷.exe).
HALP! My Embodiment of Scarlet Devil runs like a Tengu jet fighter on steroids!!
Getting Touhou 06 to run on Windows 10 requires vpatch.
- Download this complete vpatch th06 for thcrap package. It includes vpatch (rev4) and our modified Unicode vpatch DLL.
- Extract the zip contents into your EoSD directory.
- If your EoSD directory already contains a file named
vpatch_th06.dll
, please remove it. You will only needvpatch_th06_unicode.dll
. - If your game executable is named
th06.exe
, rename it to東方紅魔郷.exe
. This is necessary becausevpatch.exe
will expect to find only this file. If you only haveth06e.exe
and neither東方紅魔郷.exe
orth06.exe
, you are using the modified English static patch. We highly recommend that you use a proper Japanese original 1.02h version instead. - Open
thcrap\config\games.js
with a text editor and maketh06
point tovpatch.exe
instead of the game executable. - If you encounter a lot of screen tearing, open
vpatch.ini
in a text editor and set
tovsync = 0
.vsync = 1
Tricks
File Output
This will dump all the original, unpatched files loaded by a game as it runs.
Steps:
- Locate the .js file that is created when you run
thcrap.exe
(this would be whatever you named your shortcuts, so if you called your shortcut "en" then the .js file will also be called en.js). - Open it with your text editor (notepad, editpadpro, etc)
- Change
to either"dat_dump": false
- this will output files to wherever you placed your original game, in a folder called"dat_dump": true
dat
- this will output files into the given directory."dat_dump": "C:/name/to/dump/path/"
Then, run the shortcut.
Steam integration
We'd actually need a new guide how to do this at this place!
Troubleshooting
A complete patch setup is made up of a number of individual parts, any one of which will be responsible for the issue you're experiencing. If possible, please try to pin down the cause before reporting an issue to us.
- Does the issue appear in the original, unpatched game?
- While thcrap fixes some of the bugs in the original games as part of its patch support, we sadly don't have the capacities to fix all of them, as we are mostly busy with thcrap's own bugs and features, first and foremost. Still, please report the issue, maybe it is trivial enough that one of our developers can look at it and fix it fairly quickly.
- Try removing patches from your stack, one by one, starting at the bottom.
- To do this, edit the run configuration .js file generated by
thcrap
in a plaintext editor like Notepad.
- For example, if you only selected the English translation, you'd edit
en.js
(or whatever you've named it). You'd first remove thesection, then check whether that fixed your error, using your existing shortcuts or launchers. If it didn't, remove the next patch, and so on., { "archive": "thpatch/lang_en/" }
- If you are unfamiliar with JSON, use JSONLint or JSON Formatter to verify the syntax of your edited file. This site also gives you helpful error messages if you e.g. left a comma at the end of the
"patches"
section.
- If necessary, repeat this until you have no patches left. Note that running thcrap with no patches is still different from running the original, unpatched game. It still applies the game-independent features of thcrap, like its locale independence code or its propagation to child processes, onto the game, which might be the cause of your bug.
- If the bug still appears with no patches, you're done. But if you could identify a patch that caused your issue:
- Temporarily delete or rename
thcrap_update.dll
in the thcrap directory in order to disable automatic updates. - Look at
thcrap_log.txt
and check which files of that patch are actually loaded by the game. These are indicated by lines beginning with a+
. - Delete those files one by one, until the bug doesn't appear any more.
- These files will be re-downloaded once you restore
thcrap_update.dll
.
- Temporarily delete or rename
- To do this, edit the run configuration .js file generated by
- Now that you know the exact cause, report all the info you've gathered to the team, and they will be happy about your detailed bug report, and certainly less frustrated than if you just posted one screenshot of the bug. ☺
Known issues
My game isn't recognized by the configuration tool, and no shortcut is created
If that game happens to be Immaterial and Missing Power: thcrap does not support it yet.
If you're on Linux or MacOS with Wine, there seems to be a bug when when the game is in a subfolder of the selected folder (which happens when you add your folder with all your games in it). If this happens, you'll need to use the "Find games in a specific folder..." button to add each game one by one.
Otherwise, please post the game's executable on either Discord or our IRC channel #thcrap on irc.freenode.net. We'll see what we can do.
Dialog
Untranslated Japanese text appears blank on Wine
This is a bug in Wine, and has not been fixed as of October 2017. Even if Japanese fonts are installed and work as intended on an unpatched game, Wine's font substitution is not sophisticated enough yet to use glyphs from these fonts in case the currently selected font (Touhou Biolinum for Latin script languages) does not contain Japanese glyphs.
Dialogue does not fit in text box
Unfortunately, ZUN's engine has never been able to do automatic line breaks, and we don't want to combat this by having the wiki parser guess where to put a line break. This means that all of the line breaks have to be done manually.
If you see such a line, just log in, look for the corresponding page and split it yourself. If it's a third-party patch, then e-mail the project leader about the issue, or tell them on GitHub or wherever they host their patch.
Errors
Japanese text error
The error to the right is shown whenever a Touhou game is started and there is another Touhou game process active, meaning that you cannot run two Touhou games at the same time. Check Task Manager for any zombie processes and kill them if necessary.
Some translations are incomplete or missing
Check the corresponding text page on this site; most likely, the translations there have not been finished yet.
Patch configuration
Why does Patch X not work with Patch Y?
When you are using multiple patches, the order is important. For example one may want to use Gamer251's Mima patch for the Mima sprite and dialog, the Alphes patch for Alphes-style art, and our English patch to have the rest of the game translated to English. If one was to use the Mima patch first, then the Alphes patch, then the English one, they would discover that while the other patches were applied, the English title screen was applied to the Mima's custom title. So for a typical patch selection, the correct way to select a patch if it's not already not added for you (as seen with Nazeo's gangster patch) is using the main language first, then the mod.
There a crash on Wine (Linux and Mac) when running a game
Make sure you're using the last version, we fixed some important bugs with Wine in the version 2021-08-30.
Also, if you previously applied the workaround where you copied some DLL files around, delete them. This workaround is no longer needed, and having old DLL files in the thcrap directory can cause a crash. You should not have any DLL file in the thcrap root folder.
Moreover, if using a customized (non-distro) kernel, it's possible that your maintainer or you may not have compiled it with the CONFIG_CROSS_MEMORY_ATTACH option enabled. This option is (at least for Proton and derivatives) necessary for thcrap to access the game executables' memory for patching.
The patch does not seem to update.
A complete, manual reinstallation of the latest thcrap version usually fixes this.
HALP
Something not covered here? Everything just going wrong? We have the solution! (Most of the time.)
Please visit our Discord or IRC channel #thcrap on irc.freenode.net. Things we would need are OS, game, what you were doing, and the patcher's log file (thcrap_log.txt
).
Run configuration parameters
Root level
dat_dump
- Dumps original game data from the .dat archive as it's loaded.
- As of the 2013-07-29 build, this also dumps the sprite boundaries for all graphic files.
- values: false to disable, directory string to specify directory, anything else will enable dumping into game directory/dat
console
- Enables or disables the on-screen patch debugging console.
- values: true / false
font
- Changes the font used in the game to any other font installed on your system.
- values: string
Patch level
archive
- Specifies the base directory of this patch. Must end in a forward slash (/).
- As of the 2014-01-03 build, this can be a directory relative to the one the run configuration is stored in.
- value: string
ignore
- Ignores any files from this patch that match the given wildcard.
- value: array of strings
Example: Disabling music title and spell card translations for a specific language
{
"archive": "thpatch/lang_en/"
},
{
"archive": "thpatch/lang_pt-br/",
"ignore": ["*themes.js", "*spells.js"]
},
update
- Set to
false
to disable automatic updates for this patch. - value: true/false
Alternatively, you can safely delete thcrap_update.dll
after configuration to remove all on-line functionality.