Game Tools and Modifications

This article holds info about existing tools to extract or modify the data of the Touhou games.

All of the tools are built for Windows only, however some have source code included and therefore it might be possible to get them to work on other platforms.

If your computer has trouble recognizing Japanese words related to Touhou, see the Input Method Dictionary.

For more information on the inner workings of the games, see the Technical Information pages.

General Utilities

Touhou Toolkit
Download, w/ source code
Purpose

Command-line toolkit for extracting, modifying, and repacking the data of the Team Shanghai Alice games.

Features

Supports the following formats:

  • th*.dat - game archives (extraction and repacking).
  • *.anm - image archives and animation data (extraction, conversion to PNG and repacking)
  • *.ecl - stage scripts (containing enemy layout and danmaku patterns) (dumping and recompiling)
    • Reference on the site contains an (incomplete) documentation of the level script syntax
  • *.msg - dialogue (dumping and recompiling)
Supports
  • DAT unpacking and repacking


  • ANM/ECL/MSG actions
Latest version

release 4 (2011/04/17)

Author xarnonymous
Brightmoon
Download, w/ source code
Purpose

Generic GUI tool for extracting data of various game archives.

Supports
Main series:
Fighters:
Other games:
Latest version

2011/04/20

Author unknown
Vertical Play
Download
Purpose

Allows games to be played in a vertical-oriented resolution. See the Vertical Play page for a detailed usage description.

 
Screenshot
Supports
Latest version

Version 2.4 (2011/09/24)

Author niisaka
anm2png
Download
Purpose

Console application to convert anm files in Touhou dat files to png images. A Windows application written in c# is included that produces a batch file to run the program for every anm file in a folder.

Author unknown
Touhou Vorbis Compressor
Download, w/ source code
Purpose

Compresses the original lossless BGM used by the main series games to Ogg Vorbis.

Saves (depending on the selected quality) up to 80% of a game's disk space without a noticeable impact on game performance or music quality (for most people).

Features
  • Proxy DLL implementation, no game files are modified. Compatible with every present and, most likely, future version of the supported games.
  • Fixes the crash on the in-game pause menu caused by a non-existing BGM file. This bug appears in every Team Shanghai Alice game from Perfect Cherry Blossom on.
    This fix can also be used to play uncompressed games without a BGM file.
Supports
Main series:
Fighters:
 
TH075
(unstable)
Latest version

1.0 (2011/05/22)

Author NamelessLegacy
Touhou Ultra
Download, w/ source code
Purpose

This mod will make the bullets go faster or in higher amounts, making the touhou games harder. It is not a selectable option in the menu, and every other difficulty will be affected.

Features
  • Compatible with every present and, most likely, future version of the supported games.
Supports
Main series:
Author ??


Music-Related Utilities

Extractors

Touhou Music Room
Download, w/ source code
Purpose

Easily understandable GUI tool for game BGM playing, extracting and tagging.

 
Screenshot
Features
  • Basic song playback and music room comment display
  • Customizable loop count and fade duration
  • Automatic track name and comment translation downloading from this Wiki
  • Built-in Ogg Vorbis encoding. Can create chained bitstream output files.
  • Exclusive support for games compressed with the Touhou Vorbis Compressor.
  • External flac/mp3 encoding with the possibility to add other command-line encoders
  • Tagging in Japanese and English
  • Masstagging support for PC-98 soundtrack extractions, Shuusou Gyoku and every single one of ZUN's Music CDs
Supports
Main series:
Fighters:
Other games:
Latest version

2.2.1 (2011/08/22)

Author Alunral (since 2.2.1)

NamelessLegacy (until 2.2)

thbgmextractor
Download, w/ source code
Purpose

GUI extraction tool with lots of customization options

 
Screenshot
Features
  • Fully customizable loop count and fade-out curves, visualized by a diagram
  • Configurable hooks for external encoders
Supports

Built-in:


Also supports additional games (up to TH13 since 1.5.0 beta 2 / 1.4.6) via title files.

Usage
  • Drag a BGM file (usually thbgm.dat) onto the ThbgmExtractor.exe file.
    The program will ask you for the output directory and then start the extraction process.
Latest version

1.5.1 (2011/10/25)

Author smdn

Changers

Touhou BGM Changer
Download, w/ source code
Purpose

Tool for replacing BGM tracks in Touhou games

Features
  • Ability to import music files in WAV format
  • Ability to set loop points
Supports

Built-in:

Latest version

2.02 (2008/09/08)

Author りょうちん

Players

  • thplay - 東方蓄音機 (Touhou Gramophone) (Japanese)
  • bgmforall - BGM For All Version 1.1 By 野风信子 (Chinese)
  • THxxBGM - 東方BGM Player (Japanese)

Title files

There is a common format for files that store information about BGM names and their positions in thbgm.dat files. The usual naming convention is titles_thXX.txt. Note that older versions of software may not fully support TH13 title files due to the reduced sample rate for spirit world versions.

Here are some sources of these files:

  • 東方シリーズ用ツール has th06, th07, th07.5, th08, th09, th09.5, th10, th11, th12, th125, th128, th13, th11 trial, th12 trial and th13 trial. (Some of those may have incorrect looping offsets)
  • 東方シリーズ曲入れ替えツール has an alternative list for individual wav bgm files, extracted from data file using a ripping tool (th06 to th10).


Game Specific

Supporting single games

  Embodiment of Scarlet Devil

Retexture Patch
Download
Purpose

Replaces all the images in EoSD with cleaner, higher resolution images. The sprites have also been updated with those from the newer games. Read the readme before installing, as it contains some important information. This patch is packaged with the English translation patch as well.

Latest version

0.3

Author Emarrel
Hitbox Patch
Download
Purpose

Displays a visible hitbox on the character sprite when the Shift key is pressed. Hitbox is invisible when Shift is not pressed.

Author jisakujien

  Imperishable Night

th08bgm_patch
Download, w/ source code
Purpose

Binary patcher to fix several audio glitches in Imperishable Night's BGM file.

Author unknown
noflashmyon
Download, w/ source code
Purpose

DLL patch that makes Youmu's ghost half transparent when focused, so that it no longer obscures her hitbox

Author jisakujien

  Undefined Fantastic Object

Score counter bugfix
Download, w/ source code
Purpose

Binary patch to fix the score display glitch that occurs when score exceeds about 2.14 billion.

Author Nereid


  Ten Desires

th13
Download, w/ source code
Purpose

(Only for Windows Vista and Windows 7) Adds a code to the th13.exe so the game can play on Windows Aero. It doe's no affect to the game whatsoever. Simply replace th13.exe with the one in the download link.

Latest version

2011/08/14

Author 雷鸣

  Banshiryuu

PBG6 Data Extractor
Download, w/ source code
Purpose

Command-line tool to extract data from the *.ac6 files.

Latest version

2011/01/13 (Initial release)

Author NamelessLegacy

Supporting multiple games

Vsync Patches
Download
Purpose

Reduces input delay (game responds more quickly when a button is pressed). Will need AppLocale for EoSD if system is not set to a Japanese locale.

Supports

Danmakufu

Author swmpLV/75E (English instructions by Drake)
No Hitbox DATs
Download
Purpose

Removes the visible hitbox.

Supports
Author Emarrel
Voice Mod
Download
Purpose

Allows characters to have a voice. See the Voice Mod page for a detailed usage description.

Supports
Author unknown


External Links