2026/04/26(日)幻想人形演舞-ユメノカケラ- PvPHubExtension

作ったもの演舞ツール
2025-04-26-pvphubextension-v1.6.png
幻想人形演舞-ユメノカケラ- /Extended の対戦メニューに機能を追加する拡張するMODです。
日本語と英語に対応しています。
There is an English document at the bottom of this page.
This is an extension MOD that adds features to the PvP menu in TPDP SoD (+Extended).
It supports both Japanese and English.

導入前に必ず、このページの解説やダウンロードファイル内の ReadMe_JP.txt をお読み下さい。
使用中、何か異常を感じた場合は、ご使用をおやめ下さい。
特に、対戦時に何か影響があると感じた場合は、必ずご使用をおやめ下さい。
Be sure to read the instructions on this page and the ReadMe_EN.txt file included in the download before installation.
If you notice anything unusual while using this product, please stop using it immediately.
In particular, if you feel that it is affecting your gameplay, please stop using it immediately.


この拡張機能について

「幻想人形演舞-ユメノカケラ-」及び、その非公式拡張パッチである、「幻想人形演舞-ユメノカケラ- Extended 」の対戦メニュー機能を拡張します。
以下、この機能及び、配置されるファイル、修正されるファイル内容について「本拡張機能」と呼称します。

本拡張機能は、個人の制作物であり、非公式のものです。
本拡張機能について、幻想人形演舞-ユメノカケラ-公式様への問い合わせはご迷惑になりますので行わないで下さい。
本拡張機能をご使用の際には、方針や仕様へのご理解、界隈へのご配慮等、自助自律に努めていただきますようお願いします。

免責

Windowsの基本的なファイル操作や、当該ゲームのインストールパスなどについては理解済の方の使用を想定しています。これらについては本ページでは解説しません。

PCの性能によっては動作が遅くなる可能性があります。
動作させるPCの設定や仕様、あるいは本拡張機能の不具合などによって動かない可能性があります。
また、現在は動いていても、「幻想人形演舞-ユメノカケラ-」の仕様変更、「幻想人形演舞-ユメノカケラ- Extended」の仕様変更、OSの仕様変更、DirectXの仕様変更等によって将来動かなくなる可能性があります。
そうした様々な要因について、製作者は動作や対応を保証できません。
あらかじめご了承下さい。

導入前に幻想人形演舞-ユメノカケラ-のフォルダをフルバックアップして下さい。
本拡張機能は、ゲームの動作に強制的に介入するものです。
製作者の環境での動作検証は行っていますが、使用者全ての環境を想定することはできません。
想定外の不具合が発生することは充分ありえます。
ゲームクライアントやファイル、セーブデータ、リプレイデータなどの破壊が絶対に起こらないと保証することはできません。

ゲームの動作に強制的に介入するということのリスクについて、ご理解、ご了承の上、ご使用下さい。
本拡張機能の使用によって発生したいかなる損害にも製作者は一切の責任を負いません。
最悪のケースに備え、必ず導入前の環境を丸ごとバックアップし、元に戻せるように備えておくことを強くお勧めします。

インストール

PvPHubExtensionをインストールした環境に、ExtendedやBattleOverlayをインストールすると、PvPHubExtensionが上書きされ機能が失われます。
ExtendedやBattleOverlayをインストールしたあとにPvPHubExtensionをインストールしてください。

本拡張機能はインストーラ形式で提供されます。
"PvPHubExtension-vX.X-setup.exe" を実行し、画面の指示に従って下さい。

ウィザードの主な選択項目:
  • セットアップ言語 (インストーラ自身の表示言語)
  • 動作環境の選択 (ユメノカケラ/Extended)
  • インストール先フォルダ (幻想人形演舞がインストールされている場所を指定)
  • 操作 (新規インストール / アップデート / 再インストール / 既存の拡張機能を削除)
  • インストール言語 (ゲーム内で表示されるラベルの言語: jp / en)
  • 機能の有効化 (BGM拡張 / 背景指定)

インストーラは以下を自動的に行います。
  • "dxgi.dll"が 対象の幻想人形演舞-ユメノカケラ- のフォルダに存在しない場合に配置。
  • "PvPHubExtension.dll" を 幻想人形演舞-ユメノカケラ- (+Extended) のフォルダ内 plugins\ に配置。
  • "TPDPHook.ini" に [pvp_hub] セクションを追記し、機能を有効化。 
    幻想人形演舞-ユメノカケラ-     # インストールフォルダ
├ gn_enbu.exe
├ ...
├ dxgi.dll                 # 無ければ自動で追加
├ TPDPHook.ini             # 情報追加
├ ...
├ dat
├ save
├ ...
└ plugins
  └ PvPHubExtension.dll  # DLL配置

アンインストール

"PvPHubExtension-vX.X-setup.exe" を再度実行し、
操作選択ページで「PvPHubExtension を削除」を選択して下さい。
"PvPHubExtension.dll" の削除と "TPDPHook.ini" 内の [pvp_hub] セクションの削除が
自動的に行われます。
本インストーラが配置したdxgi.dllがあった場合、それも削除されます。
その後、
"PvPHubExtension-vX.X-setup.exe", "ReadMe_JP.txt", "ReadMe_EN.txt", "LICENSE"
を手動で削除してください。

動作確認環境

・幻想人形演舞 -ユメノカケラ- ver1.103
・MOD: Extended ver3.41
・MOD: Extended ver4.0
・MOD: StyleIconExtension (for Extended)
・MOD: BattleOverlay (for SoD)
・MOD: BattleOverlay (for Extended)

これより古いバージョンや幻想人形演舞（無印）、他のMODについては動作確認しておらず、そのサポート予定もありません。

追加される機能と使い方

ゲームを起動し対戦メニューを開くと、インストール時に有効にした機能が追加されます。

対戦BGM拡張(Extended専用)

BGM選択欄でExtendedの追加曲を選択できるようになります。
ただし、ゲーム中で1度聴いたことのある曲に限ります。
また、Extendedでは「バトル！人形舞闘会」を選択すると別の楽曲が再生されていましたが、正しい楽曲が再生されるように修正されます。

対戦BGMのランダム選択

対戦BGMの項目に「ランダム」が追加されます。
これを選択した状態で対戦を開始すると、解放済みの楽曲のうち、XXXの楽曲からランダムに選択され対戦中に再生されます。

戦闘背景の指定

画面下部に新たに背景画像を指定する項目が追加されます。
対戦時の背景を、ここで指定したものに固定することができます。
対象は、元々ランダムに出現していた背景に限られます。
「ランダム」を選択すると対象の中からランダムで出現します。これはオリジナルと同じ挙動です。

仕様の挙動

対戦BGM拡張を行うと、楽曲「バトル！人形舞闘会」は「バトル！八雲紫」と解禁状態が共有されるようになります。
ゲーム中で「バトル！人形舞闘会」を聴いても、「バトル！八雲紫」を聴いていないと、「バトル！人形舞闘会」は選択できなくなります。

設定変更

本拡張機能の設定は "TPDPHook.ini" 内の [pvp_hub] セクションで行います。
インストーラが初期値を書き込むため、通常は手動編集の必要はありません。

設定項目

[pvp_hub]
language = jp ; ゲーム内 UI ラベルの言語。jp または en
bgm_extension = true ; BGM 選択肢拡張機能。true で有効化、false で無効化
background_select = true ; 背景指定機能。true で有効化、false で無効化

言語を切り替えたい場合は language の値を jp または en に変更して下さい。
機能を一時的に無効化したい場合は各機能の値を true から false に書き換えて下さい。
変更後はゲームの再起動が必要です。

ダウンロード

更新履歴

【ver1.93：2026.5.9】
  • 背景選択欄が表示遅延を起こしていた問題を解消

【ver1.6：2026.5.5】
  • ユメノカケラに対応
  • BGMのランダム選択機能を追加
  • 対戦背景を指定する機能を追加

【ver1.1：2026.4.26】
  • Extended専用として公開
  • Extendedの追加曲を選択可能にする機能を追加

Credit(JP)

幻想人形演舞、幻想人形演舞-ユメノカケラ-は、同人サークルFocasLens様／幻想人形劇団様 の著作物で、東方Projectの二次創作作品です。

幻想人形演舞-ユメノカケラ-Extended (Touhou Puppet Dance Performance Sard of Dream Extended)は、Barudo様のチームが制作された、幻想人形演舞-ユメノカケラ-の非公式拡張パッチです。

Mod:Shard of Dreams - Battle Overlayは、Wowoer様の公開された、幻想人形演舞-ユメノカケラ-/Extendedの非公式機能拡張パッチです。

本拡張機能DLLはくしち個人による、非公式の制作物です。
本拡張機能DLLに関する、FocasLens様、幻想人形劇団様、Barudo様やExtended制作スタッフへの問い合わせはご迷惑となりますので行わないようお願い申し上げます。

About This Extension

This is an unofficial dynamic-link library that extends the PvP menu of "Touhou Puppet Dance Performance: Shard of Dreams" (TPDP SoD)" and its unofficial extension patch "TPDP SoD Extended".

This functionality, the DLL file, and the changes it makes to other files are
referred to below as "this extension".

This extension is a personal, unofficial work.
Please do not contact the official TPDP SoD developers about issues related to this extension; doing so only causes them inconvenience.
Please use this extension responsibly, with awareness of its design and consideration for the wider community.

Disclaimer

This guide assumes that you are already familiar with basic Windows file operations and the installation path for the game in question. These topics will not be covered on this page.

Performance may degrade depending on PC specifications.
The extension may fail to operate due to PC configuration, specifications, or bugs within the extension itself.
Even if it works today, future changes to "TPDP SoD", "TPDP SoD Extended", the operating system, or DirectX may break compatibility in the future.
The author cannot guarantee operation or provide support for these factors.
Please understand and acknowledge this before use.

BACK UP YOUR ENTIRE TPDP FOLDER BEFORE INSTALLING THIS EXTENSION
This extension forcibly intervenes in the game's runtime behavior.
The author has tested it in their own environment, but cannot anticipate every user environment.
Unexpected issues are entirely possible.
Damage to game executables, files, save data, or replay data cannot be absolutely guaranteed never to occur.

Please use this extension only after fully understanding and accepting the risks of forced runtime intervention.
The author bears no responsibility for any damage caused by use of this DLL.
To prepare for the worst case, we strongly recommend backing up the entire pre-installation environment so that you can revert if necessary.

Installation

If you install Extended or BattleOverlay on a system where PvPHubExtension is already installed, PvPHubExtension will be overwritten and its functionality will be lost.
Please install PvPHubExtension after installing Extended or BattleOverlay.

This extension is distributed in installer form.
Run "PvPHubExtension-v1.6-setup.exe" and follow the on-screen instructions.

Main wizard choices:
  • Setup language (the installer's own UI language)
  • Game environment (SoD / Extended)
  • Install destination (the folder where TPDP is installed)
  • Operation (Fresh install / Update / Reinstall / Remove PvPHubExtension)
  • Plugin language (the language used for in-game labels: jp / en)
  • Enable features (BGM extension / Background select)
The installer automatically performs the following:
  • Place “dxgi.dll” in the folder for TPDP SoD if it is not already present.
  • Places "PvPHubExtension.dll" into the plugins\ subfolder of TPDP SoD (+Extended)
  • Adds a [pvp_hub] section to "TPDPHook.ini" to enable the extension
Note: this installer does not register an entry in Windows "Programs and Features" and does not modify the registry.
To upgrade or remove the extension, run the same installer (".exe") again and select the desired action on the operation page.
If a previous version of "PvPHubExtension.dll" is detected, the installer automatically determines whether to offer "Update" or "Reinstall".
幻想人形演舞-ユメノカケラ- # TPDP SoD/Extended folder
├ gn_enbu.exe
├ ...
├ dxgi.dll          # If don't exists, it will be added
├ TPDPHook.ini      # Additional Settings
├ ...
├ dat
├ save
├ ...
└ plugins
  └ PvPHubExtension.dll  # Place the DLL

Uninstallation

Run "PvPHubExtension-vX.X-setup.exe" again and select "Remove PvPHubExtension" on the operation page.
"PvPHubExtension.dll" and the [pvp_hub] section in "TPDPHook.ini" are deleted automatically.

After that, manually delete the following:
"PvPHubExtension-vX.X-setup.exe", "ReadMe_JP.txt", "ReadMe_EN.txt", "LICENSE"

Verified Environments

  • TPDP SoD ver1.103
  • MOD: TPDP SoD Extended ver3.41
  • MOD: TPDP SoD Extended ver4.0
  • MOD: StyleIconExtension (for Extended)
  • MOD: BattleOverlay (for SoD)
  • MOD: BattleOverlay (for Extended)
Older versions and the original Touhou Puppet Dance Performance (no subtitle), and other MODs have not been tested and are not planned for future support.

Features and Usage

After launching the game and opening the PvP menu, the features you enabled during installation will be added.

PvP BGM Extension (For Extended only)

You will be able to select additional tracks from the “Extended” section in the BGM selection menu.
However, only tracks you have heard at least once during gameplay are selectable.
Additionally, in Extended, selecting "Vs Butokai Puppeteer" played a different track; with this extension, the correct track is played.

Random Selection of PvP BGM

The “Random” option will be added to the Battle BGM menu.
If you select this option before starting a battle, the system will randomly select a track from the SoD tracks you have unlocked and play it during the battle.

Specifying the Battle Background

A new option to select a background image has been added at the bottom of the screen.
You can set the background for battles to the image selected here.
This option is limited to backgrounds that previously appeared randomly.
If you select “Random,” the background will appear randomly from the available options.
This behaves the same as the original version.

Behavior Notes

With the PvP BGM Extension active, the unlock state of "Vs Butokai Puppeteer" becomes shared with that of "Vs Yukari Yakumo".
Even if you hear "Vs Butokai Puppeteer" played during gameplay, it cannot be selected from the menu unless you have also heard "Vs Yukari Yakumo".

Configuration

This extension's settings live in the [pvp_hub] section of "TPDPHook.ini".
The installer writes initial values, so manual editing is normally unnecessary.

Settings

[pvp_hub]
language = jp ; Language for in-game UI labels. jp or en.
bgm_extension = true ; BGM list extension. true to enable, false to disable.
background_select = true ; Background selection feature. true to enable, false to disable.

To switch the language, change "language" to "jp" or "en".
To temporarily disable a feature, change its value from true to false.
A game restart is required for changes to take effect.

Download

Change History

[ver1.93: 2026.05.09]
  • Fixed a delay in displaying the background selection field

[ver1.6: 2026.05.05]
  • Compatible with SoD
  • Added a random BGM selection
  • Added a Background selection

[ver1.1: 2026.04.26]
  • Released exclusively for Extended
  • Added a feature to allow selection of songs added in the Extended version

Credit(En)

幻想人形演舞(Gensou Ningyou Enbu) and 幻想人形演舞-ユメノカケラ-(Gensou Ningyou Enbu Yume no Kakera) are
copyrighted works by the doujin circle FocasLens / 幻想人形劇団(Gensou Ningyou Gekidan),
and are a derivative work of the Touhou Project.
"Touhou Puppet Dance Performance" and "Touhou Puppet Dance Performance: Shard of Dreams" are
an unofficial English title that refers to the above.
Touhou Puppet Dance Performance: Shard of Dream Exntended is an unofficial expansion patch created by Barudo (+his team).
Mod:Shard of Dreams - Battle Overlay is an unofficial expansion patch released by Wower.

This extension is an unofficial creation by くしち (Kushichi) (individual).
Please do not contact FocasLens, Gensou Ningyou Gekidan, or Barudo(&his team) about this tool, as it will cause inconvenience.