# touhou-engine: a Python reimplementation of Touhou gameplay

> touhou-engine reimplements Touhou danmaku gameplay in Python, with TH07: Perfect Cherry Blossom as its reference game. The author says its engine logic was ported frame by frame against a decompilation, while the new architecture supplies an event stream, replay handling, headless stepping, and a pygame renderer. It reads original game archives supplied by the user.

- Type: Case study
- Targets: Game
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-06
- Original resource: <https://github.com/SaigyoujYuyuko/touhou-engine>
- Primary source: <https://github.com/SaigyoujYuyuko/touhou-engine/blob/6d12df8dc57b66766c311ea299d0b257410765ef/README.md>
- Catalog page: <https://awesomerea.org/resources/touhou-engine-case/>
- Record JSON: <https://awesomerea.org/resources/touhou-engine-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/touhou-engine-case/index.md)

## Requirements & limits

- Requires Python 3.12 or newer and the documented numpy, pillow, pygame, loguru, and msgspec dependencies.
- Requires the user's own TH07 data archive; BGM uses thbgm.dat from the same directory.
- The source attributes its decompilation reference to some100/th07.

## Primary sources

1. <https://github.com/SaigyoujYuyuko/touhou-engine/blob/6d12df8dc57b66766c311ea299d0b257410765ef/README.md>

## More in Games

- [Untangle: a browser rebuild from REA and Ghidra evidence](https://awesomerea.org/resources/untangle-rea-evidence-rebuild-case/index.md) · Case study
- [xoreos: an open reimplementation of BioWare’s Aurora engine family](https://awesomerea.org/resources/xoreos-aurora-engine-case/index.md) · Case study
- [z2rs: an incremental Rust reconstruction of Zelda II checked against an emulator](https://awesomerea.org/resources/z2rs-zelda2-reconstruction-case/index.md) · Case study
- [ArkWeb: a two-game movement and collision experiment](https://awesomerea.org/resources/arkweb-two-game-case/index.md) · Case study
- [Batla 3D server emulator (2015 client)](https://awesomerea.org/resources/batla-3d-server-emulator-case/index.md) · Case study
- [bf-private-server: a Brave Frontier revival server](https://awesomerea.org/resources/bf-private-server-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.