• Welcome to Touhou Wiki!
  • Account registration is currently disabled.
  • Please visit our IRC channel and query an administrator to create a new account. Sorry for the inconvenience.

Game Tools and Modifications

From Touhou Wiki
Jump to: navigation, search

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.

Localisation Patches

General Utilities

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
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 5 (2011/08/17)

Author xarnonymous
Touhou Toolkit Extra
Download, w/ source code
Purpose

Fork of Touhou Toolkit with added support for TH14 and TH143.

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 6 (2014/05/18)

Author Necrotek
Touhou Toolkit GUI
Download, w/ source code
Purpose

GUI for Touhou Toolkit

Supports

The same as in thtk

Latest version

1.0 (2013/07/27)

Author dobro
anm2png
Download
Purpose

Console application to convert anm files in Touhou dat files to png images. A Java Swing wrapper is provided to make it easer to use.

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

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)
Latest version

1.0 (2011/05/22)

Author NamelessLegacy
Touhou Launcher
Download
Purpose

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

Thlauncher7.png
Screenshot
Features
  • Can run any official Touhou game
  • Add fan-made games and mods
  • Open any game's folder and AppData folder
  • Run PC98 emulators to play older Touhou games
  • Download replays and extract them to the appropriate game folder
Supports
Latest version

Version 1.10 (18/11/2014)

Author Widdiful
ThScoreFileConverter
Download
Purpose

Tool for generating text and HTML summaries of score files.

Supports
Latest version

1.9.1.0 (2014-08-24)

Author Iihoshi Yoshinori
TouhouSuperExtractor
Download
Purpose

Generic tool for extracting data of various game archives, including some fangames.

Supports
Latest version

1.16 (2014-09-17)

Author sweetie


Music-Related Utilities

Extractors

thbgmextractor
Download, w/ source code
Purpose

GUI extraction tool with lots of customization options

Thbgmextractor V1.6.0.png
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 (all present and most likely future Windows-era Touhou games 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.6.2 (2014/05/15)

Author smdn
THxxBGM
Download, w/ source code
Purpose

Music player and extractor

Thxxbgm200.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.03 (2011/08/17)

Author うり
Touhou Music Room
Download, w/ source code
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.
Supports
Main series:
Fighters:
Other games:
Latest version

2.2.1 (2011/08/22)

Author NamelessLegacy (until 2.2)


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 りょうちん


Pixel Playlist
Download
Purpose

Tool for playing music based on visual context-cues.

PPinterface.png
Screenshot
Features
  • Ability to import music files in a variety of formats (.mp3, .ogg, .flac, .mid, .wav, etc.)
  • Ability to assign a playlist containing any number of songs in place of a BGM track.
  • Flexible configuration -- you could give mid-bosses their own songs, for example.
  • Configurations are completely user built; if a game isn't supported, you could try building a configuration for it yourself.
Supports
Main series:
Fighters:
Other games:


Latest version

2.5 (2014/03/29)

Author AndrewFM


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 using in Touhou Music Room / Touhou Vorbis Compressor:

Gameplay-Related Utilities

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.

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)
Vertical Play
Download
Purpose

Allows games to be played in a 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
Author unknown
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


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


External Links