Touhou Project All-In-One Pack, ver.

2021-05-18

Table of Contents:

01) Intro
02) Playing PC-98 Games
03) Using vpatch
04) Using thcrap
05) Auxiliary Tools
a) Using the DirectX Converter
b) Using the Key Remapper
c) Using DiskExplorer
06) Netplay Tools
a) Using RollCaster
b) Using Adonis
c) Using SokuRoll
d) Using the AoCF Netplay Patch
07) Important Notes
- TH04
- TH05
- TH06
- TH09
- TH10.5
- TH12.3
- TH15.5
- Windows Games
- All Games
- thcrap
08) Running Games in Fullscreen
09) Tips for New Players
10) Running Games on Linux
11) Links

01) Intro

This pack is intended to be a 'one-stop shop' for anyone wishing to play the
official Touhou Project games in English and/or Japanese. It should allow a
complete, optimal playing experience, without having to track down and
install a dozen different patches and tools separately.

As of this version, it includes:

- Original Japanese versions of every official game to date

- English-patched versions of every game from 1 through 13.5
- The latest build of thcrap, for playing 14 and onward in English
- Neko Project II, a PC-98 emulator for playing 1 through 5
- Vpatch, which provides various utilities for older Windows games
- A DirectX converter, for fixing some serious issues in Windows 10
- A key remapper, for custom controls or playing on non-QWERTY keyboards
- DiskExplorer, a utility for viewing and editing PC-98 disk images
- Rollcaster, a netplay utility for 7.5
- Adonis, a netplay utility for 9
- SokuRoll, a netplay utility for 12.3
- The AoCF Netplay Patch for 15.5
- This readme, which explains how to use everything
02) Playing PC-98 Games

The version of Neko Project II (fmgen build) included in this release has
been pre-configured specifically for playing Touhou, so no setup is
necessary unless you'd like to enable bonus features. (See the Links section
for more on that.)

To launch a game:

- Open the emulator, np21nt.exe.

- Go to Harddisk > IDE #0 > Open..., and select the game (.hdi) file.
- Go to Emulate > Reset.

03) Using vpatch

Playing older Windows games through vpatch reduces input lag, allows the
games to played in a window of arbitrary size, and fixes a few odd bugs in
specific games. Though it's called a patch, it doesn't affect the existing
game files, and instead runs alongside the game.

The full instructions can be found in the vpatch folder's readme files, but
for a basic summary:

- Copy vpatch.exe, the game-specific .dll file, and vpatch.ini into the game
folder.
- Edit vpatch.ini to change your desired settings. Most of them are self-
explanatory.
- To play English-patched versions, change the name of the game executable
to th##.exe. (You can change the Japanese versions to whatever else, such as
th##j.exe.)
- Launch vpatch.exe, rather than the game executable, to play.

Additional setup is necessary for 6; see the Notes section for details.

A separate version of vpatch is required to use alongside Adonis; see the

Notes section for details.

In this release, vpatch has already been added to and configured for 6, 7,
8, 9, 9.5, and 10. Files for other games are available in the vpatch folder.

04) Using thcrap

The Touhou Community Reliant Automatic Patcher is a tool which translates

games by dynamically patching them as they run. This has generally replaced
the old system of hard-patched versions as the way to play Touhou in
English.

Full instructions are on their site, but you can get started by running
thcrap_configure.exe (in the thcrap folder) and following the directions
from there.

05) Auxiliary Tools

05a) Using the DirectX Converter

The DirectX converter replaces certain functions of the DX8 library with
versions from DX9. This is mainly intended to fix the issue of uncapped
framerate when playing 6 on Windows 10.

To use it, simply place both included files into the game folder.

In this release, the converter has not been added to 6 by default, since it
should only be used if necessary.

05b) Using the Key Remapper

The key remapper is a simple but powerful tool which remaps keyboard inputs.
This is useful for playing Touhou on non-QWERTY layouts, or just for setting
up custom control schemes.

The remapper affects your whole system, so it can be launched at any time
before or after launching a game.

To configure which keys are remapped to which inputs, simply edit

Remap_Keys.ini before launching. It's thoroughly commented, so everything
should be obvious.

05c) Using DiskExplorer

DiskExplorer is a utility for viewing and editing the contents of PC-98 disk
images. It can be used to apply patches to, extract score files from, or
otherwise mess with the PC-98 games.

To open a game:

- Launch editdisk.exe.
- A file selection dialogue will appear; select the .hdi file.
- For the disk type, select Anex86 HDD.
- From here, you can drag-and-drop files in and out.

Be aware that changes to disk contents are saved on the fly.

06) Netplay Tools

06a) Using RollCaster

RollCaster is a tool which enables netplay in 7.5. To use it:

- Edit config_rollcaster.ini to change your settings; the file is thoroughly

commented, so everything should be obvious.
- Launch RollCaster.exe, select the appropriate option (probably host,
connect, or spectate), and follow any prompts.
- If all goes well, the game will launch and immediately go to the character
selection screen.
 In this release, RollCaster is already added to 7.5.

06b) Using Adonis

Adonis is a tool which enables netplay for 9.

Two versions are included; the original Adonis has both an English and a
Japanese version, while the improved Adonis2 is only in Japanese.

Using the program is simple:

- Edit adonis_config.ini or adonis2.ini to change your settings, including

the game window size and the default IP to connect to.
- Launch your chosen version and language of Adonis and follow the prompts.
If all goes well, it will launch the game for you and immediately connect,
taking you to the difficulty selection screen.

If you wish to use Adonis2 with the English-patched version, you'll have
to rename th09e.exe to th09.exe. (You can change the Japanese version to
whatever else, such as th09j.exe.)

If you wish to use vpatch alongside Adonis, a separate version of vpatch is

necessary; see the Notes section for details.

Keep in mind that 9 and Adonis are known for being finicky, and netplay
probably won't work on the first try. Setting the game and Adonis
executables to Compatibility Mode for Windows XP or Vista may help. You'll
also have to make sure that both players' controls are configured properly.

In this release, Adonis is already added to 9.

06c) Using SokuRoll

SokuRoll is a popular tool which improves netplay in 12.3. To use it:

- Run 'Launch Hisoutensoku + sokuroll.bat', rather than launching the game.

(You can also do this manually by first launching the game, then launching
SokuRollLoader.exe.)
- If it loads properly, the title bar will contain "Ver1.10ac+ R 1.3"
- Once it's running, connect through the game as normal; no further special
action is necessary.

You will only be able to connect to other players who are using SokuRoll.

In this release, SokuRoll is already added to 12.3.

06d) Using the AoCF Netplay Patch

This patch is a popular tool which improves netplay in 15.5. To use it:

- Simply launch th155n.exe, instead of the game executable, to play.

- For use with the beta version of the game (see the Notes section), launch
th155n_beta.exe instead.
 - For use with thcrap, place a copy of Netplay.dll in thcrap\bin\ and launch
the game via the shortcut as normal.

In this release, both versions of the patch are already added to 15.5, and
Netplay.dll is already added to thcrap.

07) Important Notes

TH04:

There are two versions of 4 included in each language; the one marked
"(original)" is the untouched original version, while the other has
been
modified to run correctly on the included build of Neko Project II. You
should only use the original version if playing on a different
emulator.
The modifications in the NPII version don't affect gameplay.

TH05:

Depending on your emulator and system setup, the English version of 5

may crash after completing the Extra, but before recording the score/
replay. The exact conditions which cause this bug are unknown, so
attempt it at your own risk.

TH06:

To use vpatch with 6, the game executable must be named 東方紅魔郷.exe.

(Just in case it doesn't display properly, that's the title, 'Touhou
Koumakyou', in kanji. U+6771, U+65B9, U+7D05, U+9B54, U+90F7.)
Additionally, if your system locale is not set to Japanese, use
AppLocale (or your equivalent software of choice) to launch vpatch.

That aside, 6 is notoriously buggy, so you may need to search out

troubleshooting tips on the web to fix any issues you run into.

TH09:

For in-game text to be displayed correctly when using the hard patch,
you must install Cirno.ttf to your Fonts directory; merely having it in
the game folder won't work.

To use vpatch alongside Adonis, swap out the three normal vpatch files
which are already included in the folder with the three alternate files
located in vpatch\vpatch_adonis\, then launch Adonis as normal.

TH10.5:

No netplay tools are included for 10.5 because if you want to play
10.5,
you should just play 12.3 instead. Anyone who specifically wants to
play
10.5 is an Alice player, and should under no circumstances be trusted.
 TH12.3:

Since 12.3 is essentially an expansion pack to 10.5, you'll need to

link
the two together to have the full roster in 12.3. To do so, edit
configex123.ini in the 12.3 folder, and under [th105path], set 'path'
equal to the location of your 10.5 folder. (If you put both folders
from this release in the same location, and don't rename them, the
correct path is already set.)

TH15.5:

There are two versions of 15.5 included in this pack; one is the latest
release version that the updater will fetch, 1.10d, while the other is
the latest beta version, 1.19 Beta 4. The beta is recommended both for
netplay, since it's the version most people use, and for single-player,
due to its numerous improvements. Both versions are included in the
same
folder; simply launch the corresponding executable to choose between
them.

Windows Games:

Each Windows game includes a "story_e" folder, which contains English

versions of whatever plot-relevant information is included with that
game, as well as the afterword if it's available. For the fighting
games, that also includes material from the official website.

All Games:

To access config, scores, screenshots, and replays:

- For 1 through 5, these are stored in files within the .hdi file, so
you'll need DiskExplorer (or a similar tool) to add or remove them.
- For 6 through 12.3, 13.5, 14.5, and 15.5, they're stored in the game
folder.
- For all others, they're stored in ~\AppData\Roaming\ShanghaiAlice.

thcrap:

To configure thcrap to run games with vpatch, select the vpatch option
for those games when detecting them during first-time setup. (You can
also modify existing config files; see the Touhou Patch Center's site
for detailed instructions.) To do this with 6, a special version of the
vpatch .dll is necessary; it has already been included in this release.

08) Running Games in Fullscreen

Aside from the newer fighters, all Touhou games are designed to run at a 4:3
aspect ratio. When running them fullscreen on a non-4:3 display, this
intended aspect ratio may get ignored, in which case the window will be
 distorted to match the display's dimensions. If you play on a widescreen
display, and fullscreen games aren't letterboxed (ie, with black bars on
either side), then your display is not honoring the game's aspect ratio, and
you'll have to use GPU scaling instead. Fortunately, this is easy to enable:

For Nvidia Cards:

- Open the NVIDIA Control Panel by right-clicking on your desktop.

- In the left menu, go to Display > Adjust desktop size and position.
- Under the Scaling tab, select "Aspect ratio".
- In the dropdown below, select "GPU".

For AMD Cards:

- Open either the AMD Catalyst Control Center or AMD Radeon Settings by
right-clicking on your desktop.

For CCC:

- In the left menu, go to My Digital Flat Panels > Properties.

- Under Image Scaling Preferences, check Enable GPU up-scaling.
- Below, choose Maintain aspect ratio.

For Radeon Settings:

- In the top menu, go to Display.

- Turn GPU Scaling on.
- For the Scaling Mode, select Aspect Ratio.

09) Tips for New Players

Hold Shift for focused movement.

Before starting a game for the first time, read the manual. Newer games
(since 13) have translated in-game manuals, but you can find detailed
explanations of mechanics for every game on the Touhou Wiki.

Additionally on the Wiki, you can find many optional game tools and
modifications not included in this pack, such as 'thprac', which makes
practicing easier and more efficient.

10) Running Games on Linux

This pack is intended for use on Windows, and as such no guarantees are made
regarding running any components on Linux. However, if you wish to attempt
it, these procedures should more or less work. More information is available
on the Wiki.

PC-98 Games:

Neko Project II Kai is the recommended emulator. It is not

included
in this pack; see the Links section. Be sure to use the IA-32
version (xnp21kai) and configure all the necessary settings as
with
NP2fmgen.

Windows Games:

In most cases, the games can simply be launched from within their
own directories with Wine, for example:

$ wine th##e.exe

For Japanese versions, the LANG variable should first be set, for
example:

$ LANG=ja_JP.UTF8 wine th##.exe

thcrap:

To launch the shortcuts generated by thcrap, use Wine's "start"

command. For example, from the shortcut's own directory:

$ wine start "th## (en).lnk"

Or from anywhere, with an absolute path:

$ wine start /unix "/absolute/path/to/th## (en).lnk"

Be aware that the included build of thcrap may not be able to

connect to the patch server. In such a case, in order to add new
patches or update existing ones, you'll have to manually download
and add them to thcrap/repos/.

11) Links

General information at the Touhou Wiki (English):

http://en.touhouwiki.net/wiki/Touhou_Wiki

Touhou Patch Center, home of thcrap:

https://thpatch.net/wiki/Touhou_Patch_Center

Emulating with Neko Project II fmgen:

https://www.shrinemaiden.org/forum/index.php?topic=11117.0

Neko Project II fmgen by nenecchi_0505:

http://nenecchi.kirara.st/

English patches for 1 through 5 by xJeePx:

https://www.shrinemaiden.org/forum/index.php?topic=13903.0

DiskExplorer by junnno:
http://hp.vector.co.jp/authors/VA013937/editdisk/index_e.html

Vpatch by swmpLV/75E:
http://en.touhouwiki.net/wiki/Game_Tools_and_Modifications#Vsync_Patches

Key remapper by Mefidex:

https://www.shrinemaiden.org/forum/index.php?topic=219.0

DirectX converter by Boris Vorontsov:

http://enbdev.com/download_convertor_dx8todx9.htm

Rollcaster and other documentation at the Suimusou wiki:

http://wiki.mizuumi.net/w/Immaterial_and_Missing_Power/Netplay

Sokuroll and other documentation at the Hisouten wiki:

https://hisouten.koumakan.jp/wiki/Netplay

AoCF Netplay Patch from LunarCast:

http://lunarcast.net/aocf.php

Detailed documentation at the AoCF wiki:

https://aocf.koumakan.jp/

Neko Project II Kai, for Linux:

https://domisan.sakura.ne.jp/article/np2kai/np2kai.html
https://github.com/AZO234/NP2kai
https://aur.archlinux.org/packages/np2kai-git/