A reconstruction of the Japanese PC-98 Touhou 3: Phantasmagoria of Dim.Dream, with a native C++17 port for Windows and Linux. The portable version runs without a DOS emulator and uses the original game's external data.
Note
The native development preview supports story, versus CPU and two-player
battles, endings, Staff Roll, Music Room, saves and PMD sound.
Portable source is on port/modern-64;
the PC-98 DOS reconstruction is on main.
Build instructions and the supported game-data layout are below.
The portable version is currently a source-build preview; a public GitHub
Release has not been published. Follow Build the portable version
to build th03-port64.exe and copy the launchers into a writable play folder,
such as C:\Games\th03-portable.
The portable guide records the current preview, verification and remaining gameplay checks.
Place these files beside th03-port64.exe:
| File | Purpose |
|---|---|
th03.hdi |
Your supported Japanese full-version PC-98 hard-disk image, with the installed game in YUMEZIKU. |
FREECG98.BMP |
External 2048×2048 Anex86-format PC-98 font bitmap, also used by DOSBox-X. |
ym2608_adpcm_rom.bin |
External 8,192-byte YM2608 rhythm data for PMD86 sound. |
The HDI reader currently expects a specific FAT12 layout and reads the original
resource archives, YUME.CFG and YUME.NEM from YUMEZIKU. See
supported original data
for the format requirements. TH03 does not yet have TH04's loose-file preparation
script. Game files, the font and rhythm data are supplied separately.
Run Play.bat for normal play with PMD86 sound, or Play-silent.bat
without sound or a rhythm ROM. Both keep scores and settings in save-normal
beside the executable. Keep this folder when updating; the game disk is read-only.
The optional
Play-invincible.bat
protects human players while CPU players can still take damage. It patches a
new process in memory and uses separate save-invincible saves. This launcher
checks the supported preview executable's hash; use Play.bat for self-built
executables until their patch location is verified.
The title initially hides its menu: press a direction to reveal it. Release keys between menu choices.
| Mode | Controls |
|---|---|
| Menus / single player | Arrow keys move or navigate; Z/Enter confirms, Z shoots, X bombs and Esc pauses or returns. |
| Two-player P1 | T/F/H/B move up/left/right/down; Z shoots and X bombs. |
| Two-player P2 | Numeric keypad moves; Left shoots and Right bombs. |
| Paused battle | Q returns to the title. |
See the portable guide for Music Room, name entry, replay inputs and audio options.
Compiling requires CMake 3.16+, a 64-bit C++17 compiler and Ninja. Linux also needs SDL2 and pkg-config. Original game data is needed at runtime. Get the portable branch explicitly:
git clone --branch port/modern-64 https://github.com/N0zoM1z0/th03.git th03-portable
cd th03-portableInstall MinGW-w64 GCC, CMake and Ninja. For MSYS2's UCRT64 environment, install the GCC, CMake and Ninja packages in its UCRT64 terminal:
pacman -S --needed mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-cmake mingw-w64-ucrt-x86_64-ninjaThen open CMD, enter your checkout and run the following. Adjust the MSYS2 path if installed elsewhere:
set "PATH=C:\msys64\ucrt64\bin;%PATH%"
port64\build-windows.bat
mkdir run
copy build\portable-win64\th03-port64.exe run\
copy port64\Play.bat run\
copy port64\Play-silent.bat run\Add the original data files to run as described above, then start
run\Play.bat or run\Play-silent.bat.
On Debian/Ubuntu, install the build dependencies:
sudo apt install build-essential cmake ninja-build pkg-config libsdl2-devFrom the portable checkout, build the game and create a writable play folder:
cmake -S port64 -B build/linux-x64 -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build/linux-x64 --target th03-port64 --parallel 1
mkdir -p runPlace your th03.hdi, FREECG98.BMP and rhythm ROM in run, then launch:
./build/linux-x64/th03-port64 --hdi run/th03.hdi --font-bmp run/FREECG98.BMP \
--save-dir run/save-normal --audio --pmd-driver pmd86 \
--opna-rom run/ym2608_adpcm_rom.binFor silent play, omit --audio, --pmd-driver and --opna-rom, and add --mute.
Build details, headless checks and Linux-to-Windows cross-compilation
are in the portable guide.
This reconstruction was built with AI coding agents. Contributions that improve behavior, recovered semantics, readability and platform support are welcome.
- Testing and bug reports. Try different characters, difficulties, story routes, versus modes, endings, sound options and save flows. A recorded Reimu Easy campaign completes on both platforms, but broader manual play and listening remain useful. Report bugs with your preview or commit, OS, reproduction steps and expected versus actual behavior. Screenshots or replays help with rendering issues.
- Ports and backends. Improve rendering, audio and input support, or help bring the portable version to additional platforms and architectures.
- Semantics and readable source. Review behavior against the original game, improve names and types, simplify control flow and document useful findings. Focused fixes with a reproduction or relevant comparison are welcome.
Send portable PRs to port/modern-64 and DOS reconstruction PRs to main.
The current DOS composition reproduces OP.EXE, MAIN.EXE, MAINL.EXE
(the ending) and ZUN.COM byte for byte against the pinned Japanese targets.
The progress graphic describes tracked reconstruction scopes; it is not a
whole-game completion percentage. Native playability and source-exact DOS
acceptance are tracked separately.
- DOS build composition and exact comparisons
- Playing the rebuilt DOS game
- Reconstruction progress and current agent handoff
- Source and build architecture
- Reconstruction workflow, shared tools and agent instructions
- Portable implementation, checks and remaining work
ZUN (上海アリス幻樂団 / Team Shanghai Alice) created Touhou Project and the original TH03 game, characters, artwork and music.
Thanks to the authors and contributors of:
- ReC98 — nmlgc and contributors, for PC-98 reverse engineering, recovered source, hardware definitions and DOS build infrastructure used throughout this reconstruction.
- master.lib — the original PC-98 graphics and system library used by TH03.
- Our TH04 reconstruction — the reference for the portable workflow and the shared PMD synthesis, audio transport and host-timing work adapted for TH03.
- KAJA / PMD — the original PC-98 music driver and formats reconstructed by the portable audio layer.
- ymfm — Aaron Giles and contributors, for Yamaha FM, SSG and ADPCM synthesis.
- SDL2 — Linux windowing, input and audio.
- DOSBox-X and the FREECG98 contributors — PC-98 execution tests and the external font bitmap.
- libOPNMIDI, MAME and 98fmplayer/libopna — rhythm-data and audio references used during validation.
- Unicorn, Capstone and Ghidra — original-code execution, disassembly and reconstruction checks.
- Wine and mtools — DOS-toolchain execution and disk-image preparation.
Project-authored code and documentation use the MIT License. ymfm retains its BSD-3-Clause license; SDL2 uses the zlib license. The original game data is supplied separately and remains credited to ZUN.
