• Welcome to Touhou Wiki!
  • Registering is temporarily disabled. Check in our Discord server to request an account and for assistance of any kind.

Game Tools and Modifications

From Touhou Wiki
Jump to navigation Jump to search

This article holds info about existing tools to extract or modify the data of the Touhou Project 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.

Localisation Patches

General Utilities

Brightmoon
Download, w/ source code
Purpose

Generic GUI tool for extracting data of various game archives.

ThBrightmoon1.png
Screenshot
Supports
Main series:
Fighters:
Other games:
Latest version

2011-04-20

Author unknown
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).
  • *.msg or msg*.dat - Dialogues (Dumping and recompiling).
  • *.std - Background scripts (Dumping and recompiling).
Supports
  • DAT unpacking and repacking


  • ECL dumping and recompiling


  • ANM extraction, conversion and repacking


  • MSG dumping and recompiling


  • STD dumping and recompiling
Latest version

Release 12 (2019-10-28)

Author
Touhou Toolkit GUI
Download, w/ source code
Purpose

GUI for Touhou Toolkit version 9 or earlier (officially version 6 is the last supported version).

Thtoolkitgui1.png
Screenshot
Supports
Latest version

1.1 (2015-02-23)

Author dobro
Mystic Square Toolkit
Download
Purpose

Collection of command-line tools to decompile and recompile the data of Mystic Square.

Features

Supports the following formats:

  • *.std - Stage scripts (Containing enemy layout, danmaku patterns, background section layout and scroll speeds) (Decompile/Recompile).
  • *.map - Background section definitions (A section is 5 rows of 24 tiles) (Decompile/Recompile).
  • *.mpn - MPTN Background tile bitmaps and palettes (Decompile/Recompile).
  • *.tx2 - Dialogues (Decompile/Recompile).
Supports
Latest version

Beta

Author
  • Tom
anm2png
Download, w/ source code
Purpose

Console application to convert anm files in Touhou dat files to png images.

Author Rarity
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).

Thvorbiscompressor1.png
Screenshot
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:
Icon th075.png
TH075
(unstable)
Other games:
Latest version

1.0 (2011-05-22)

Author NamelessLegacy
Touhou Launcher
Download
Purpose

Puts all of your Touhou games in one program for convenience.

ThLauncherGamesMenu.png
Screenshot
Features
  • (Alternative download link)
  • Run any official Touhou game.
  • Download and manage replays.
  • Add fan-made games and mods.
  • Read some manga whenever you want.
  • Open any game's folder and AppData folder.
  • Run PC-98 emulator to play older Touhou games.
Supports
Latest version

5.5.0 (2024-03-05)

Author A Digital Project
ThScoreFileConverter
Download, w/ source code
Purpose

Tool for generating text and HTML summaries of score files.

Thscorefileconverter1.png
Screenshot
Supports
Latest version

2.4.0 (2019-12-22)

Author Iihoshi Yoshinori
TouhouSuperExtractor
Download, w/ source code
Purpose

Generic tool for extracting data of various game archives, including some fangames, as well as DxLib format archives.

Supports
Latest version

1.25 (2018-05-20)

Author sweetie
135tk
Download, w/ source code
Purpose

Set of command-line tools to view, extract and edit the files of recent Tasofro games.

Supports
Latest version

2021-12-09

Author brliron
arc_unpacker
Download, w/ source code
Purpose

Command-line tool for extracting images and sounds from visual novels and some other Japanese games.

Supports
Latest version

0.11 (2016-07-30)

Author rr-


Music-Related Utilities

Extractors

thbgmextractor
Download
Purpose

GUI extraction tool with lots of customization options

Thbgmextractor V1.6.4.png
Screenshot
Features
  • Loop count and fade-out curves customisable on a per-track basis
  • Waveform display
  • Automatic tagging
  • Configurable hooks for external encoders
  • Support for new games can be added using title files
Supports

Built-in:

Also supports additional games (all present and most likely future Windows-era Touhou games since 1.5.0 beta 2 / 1.4.6) via title files. The download page includes a collection of links to 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.6.7 (2020-05-21)

Author smdn
THxxBGM
Download
Purpose

Music player and extractor (Tutorial)

Thxxbgm208.png
Screenshot
Features
  • Minimalist music player interface
  • Extraction into WAV format
Supports

Built-in:


Also supports additional games (all present and most likely future Windows-era Touhou games since 2.0.3) via title files.

Latest version

2.08 (2018-08-12)

Author うり
Touhou Music Room
Download
Purpose

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

Musicroom interface.png
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
  • Support for new games can be added by downloading BGM files created by others or yourself, instructions on the folder "bgminfo" are included.
    • Newer games are linked here.

Known issues:

  • Does not work if it is opened in a directory containing non-English characters (Japanese, accented characters, etc.)
  • Original download link is offline. Source code can be downloaded here
Supports
Main series:
Fighters:
Other games:
Latest version

2.2.8 (2020-06-22)

Author DTM (2.2.2 - 2.2.8)

Alunral (2.2.1)
NamelessLegacy (until 2.2)


Changers

Touhou BGM Changer
Download, w/ source code
Purpose

Tool for replacing BGM tracks in Touhou games

ThbgmChg E.png
Screenshot
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)
  • FBPLAY - A player that supports a wide range of games including TH06-TH11. Unofficial versions support up to TH13.

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 in that game.

Here are some sources of these files:

Bgm files

These files are for use in Touhou Music Room / Touhou Vorbis Compressor:

Gameplay-Related Utilities

Supporting multiple games

d3d8to9
Download
Purpose

Various essential Windows 10 fixes. Touhou 6 EoSD unlimited FPS fix, Touhou 7.5 IaMP crashing fix, and more. Download "d3d8.dll" into game directory.

Features

A modern, open-source DX8 to DX9 converter.

  • Enables exclusive fullscreen instead of (borderless) windowed fullscreen on Windows 10. Reduces input delay when used with the Vsync Patches.
  • Enables compatibility with various screen recording and streaming software (e.g. Open Broadcaster Software).
  • Enables compatibility with various third-party graphics tools (e.g. MSI Afterburner, ReShade).
  • Bugfixes compared to the older DX8 to DX9 converter (e.g. non-blurry Touhou 7.5 sprites)
Supports
Author crosire
DX8 to DX9 converter
Download
Purpose

Obsolete DX8 to DX9 converter. Recommend using d3d8to9 instead.

Author Boris Vorontsov (ENBDev)
Vsync Patches
Download
Purpose

Reduces input delay (game responds more quickly when a button is pressed).
For EoSD, please remember to install (and run!) the game in Japanese locale, or the filenames will be gibberish and the patch won't be able to find the main program. Failing that, you can use vpatch_th06_unicode.dll instead of vpatch_th06.dll, and rename the program to 東方紅魔郷.exe.
Author download site: http://ux.getuploader.com/swmplv75e/

Features

Additional features include:

  • Enabling use of Ctrl to fast-forward replays, in older games that did not already have this feature
  • Fixing the display glitches for PCB cherry values above 1 million and UFO scores above 231
  • An option to select full-screen or windowed mode upon game startup, in older games that did not already have this feature
  • The ability to resize the game's window to any dimensions and/or remove the title bar in windowed mode
  • The ability to increase the game speed above 60fps (but not decrease it)
  • Optional MoF MarisaB 3.xx power fix
Supports

Danmakufu

Author swmpLV/75E (English instructions by Drake)
dgVoodoo2
Download
Purpose

An advanced DX8 converter that enables optional high-resolution rendering (e.g. native 1080p) and other graphical enhancements, but has notable known issues.

Features
  • Similar features to the DX8 to DX9 converter (Windows 10 fixes, etc), but converts to DX11 (feature level 10.1).
  • Enable high-resolution rendering, anti-aliasing, and anisotropic filtering.
  • Alt-Enter shortcut to toggle fullscreen.

Known issues:

  • Additional input lag and higher graphical requirements compared to the DX8 to DX9 converter.
  • When playing at high resolutions, graphical artifacts are visible throughout the interface and around some in-game sprites.
  • Incorrect graphics in some games (e.g. invisible trees in EoSD stage 3).
Supports
Author Dege
Vertical Play
Download
Purpose

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

Pivot.png
Screenshot
Supports
Latest version

Version 2.4 (2011-09-24)

Author niisaka
THRotator
Download
Purpose

Another tool allowing games to be played in a vertical-oriented resolution, with more games supported and customisable positioning for HUD elements.

Supports
Latest version

2.1.0

Author massanoori
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 difficulty will be affected.

Features
  • Compatible with every present and, most likely, future version of the supported games.
Supports
Main series:
Author niL
Touhou Input Display
Download
Purpose

Reads the memory of Touhou games and gives a display of the game's inputs.

Features
  • Displays the inputs of replays as well.
  • Auto-detects the running game
  • Does not depend on input device or setup.
  • Somewhat configurable, will likely support future games.
Supports
Author Drake
No Hitbox DATs
Download
Purpose

Removes the visible hitbox.

Supports
Author Emarrel
Real Hitbox Patches
Download
Purpose

Changes the sizes of bullets to approximately match their hitboxes.

Supports
Author sibgamer
Voice Mod
Download
Purpose

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

Supports
Author unknown
thprac
Download
Purpose

Advanced practice tool for Touhou shmups allowing you to change settings and skip to any pattern

Thprac th18.png
Screenshot
Supports
Latest version

v2.2.1.2 (2023-03-28)

Author
ThMouse
Download
Purpose

Enables mouse control in Touhou danmaku games, allowing the player character to move towards wherever the cursor points.

Supports
Latest version

v0.31 (2013-08-27)

Author hwei
TouhouKeymap
Download
Purpose

Thcrap plugin which adds configurable keyboard controls to all supported games

TouhouKeymap.png
Screenshot
Supports
Latest version

0.1.4 (2021-07-24)

Author devinacker


Supporting single games

Icon th06.png 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
Practice Mode Replay Patch
Download
Purpose

Allows players to save replays from Practice Mode stages, a feature that was first officially introduced in PCB.

Author unknown chinese people (Redone by Wriggle)


Icon th08.png 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


Icon th11.png Subterranean Animism

SA Boss Rush
Download
Purpose

A boss rush modification to TH11. Removes stages, bombs and continues, and every player faces Satori's entire arsenal, along with other quirks. Created as a challenge mode and a means to boss practice.

Author Drake

Icon th12.png 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
UFO Boss Rush
Download
Purpose

A boss rush modification to TH12. Removes stages, bombs and continues, along with other little quirks. Created as a challenge mode and a means to boss practice.

Author Drake

Icon th13.png 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 does no affect to the game whatsoever. Simply replace th13.exe with the one in the download link.

Latest version

2011-08-14

Author 雷鸣


Icon sh03.png 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


See Also

External Links