-----------------------------------------------------------------------------------------------
【名前】　　　　幻想人形演舞-ユメノカケラ- PvPHubExtension
【用途】　　　　幻想人形演舞-ユメノカケラ- (+Extended) の対戦メニュー機能拡張
【バージョン】　　 1.93
【公開ページ】　　https://xy1.ebb.jp/025
【製作者】　　　くしち (https://x.com/xyichi)
【公開日】　　　2026.05.05
【動作環境】　　幻想人形演舞-ユメノカケラ- v1.103 / Extended v3.41/4.0/Battle Overlay
-----------------------------------------------------------------------------------------------


■■この拡張機能について■■
「幻想人形演舞-ユメノカケラ-(http://www.fo-lens.net/enbu_ap/)」
及び、その非公式拡張パッチである、
「Extended (http://gensoushinki.com/) 」
「Battle Overlay (https://tpdp.miraheze.org/wiki/Mod:Shard_of_Dreams_-_Battle_Overlay) 」
の対戦メニュー機能を拡張します。
以下、この機能及び、配置されるファイル、修正されるファイル内容について「本拡張機能」と呼称します。

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


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

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


！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！
！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！

！！！！！導入前に幻想人形演舞-ユメノカケラ-のフォルダをフルバックアップして下さい！！！！！

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

ゲームの動作に強制的に介入するということのリスクについて、ご理解、ご了承の上、使用下さい。
本DLL使用によって発生したいかなる損害にも製作者は一切の責任を負いません。

最悪のケースに備え、必ず導入前の環境を丸ごとバックアップし、
元に戻せるように備えておくことを強くお勧めします。

！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！
！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！


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

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

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

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

------------------------------------------------------------------
幻想人形演舞-ユメノカケラ-\  # ユメノカケラ/Extendedのインストールフォルダ
├gn_enbu.exe            # 既存ファイル/フォルダは環境によって異なる
├SoD-Extended-JP.exe       
├SoD-Extended-EN.exe
├dxgi.dll               # ← 既存のファイルが無ければ追加される
├TPDPHook.ini           # ← [pvp_hub] セクションが追記される
├...
├dat\
├save\
├...
└plugins\               # ← インストーラがDLLを配置する
 └PvPHubExtension.dll   # ここに配置される
------------------------------------------------------------------

なお、本インストーラを実行しても Windows の「プログラムと機能」には登録されません。
レジストリも書き換えません。
バージョンアップや削除を行いたい場合は、インストーラを実行して
操作選択ページから行いたい項目を選んで下さい。
"PvPHubExtension.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.6：2026.5.9】
・背景指定欄が表示遅延を起こしていた問題を解消

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

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

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

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

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

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