﻿-----------------------------------------------------------------------------------------------
【名前】　　　　幻想人形演舞-ユメノカケラ- PvPHubExtension
【用途】　　　　幻想人形演舞-ユメノカケラ- (+Extended) の対戦メニュー機能拡張
【バージョン】　　 2.2
【公開ページ】　 https://https://xy1.ebb.jp/025
【製作者】　　　くしち (https://x.com/xyichi)
【公開日】     2026.7.19
【動作環境】　　幻想人形演舞-ユメノカケラ- 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.X-setup.exe" を実行し、画面の指示に従って下さい。

主な選択項目:
・インストール時の表示言語 (jp / en)
・動作環境の選択 (ユメノカケラ / 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拡張:
BGM選択欄に、「ランダム」が追加されます。
これを選ぶと、ゲーム中で1度聴いた曲の中からランダムに再生されます。
また、Extended版では、Extendedの追加曲を選択できるようになります。
こちらも、ゲーム中で1度聴いたことのある曲に限ります。
Extended版では「バトル！人形舞闘会」を選択すると別の楽曲が再生されていましたが、正しい楽曲が再生されるように修正されます。

対戦BGMのランダム選択:
ランダムBGMの抽選対象を設定できます。
インストール時にこの機能をオフにした場合、ユメノカケラの解放済み戦闘曲すべてが抽選対象になります。
曲名のネタバレ防止のため、新規インストール時はオフになっています。

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

リプレイのサブフォルダ表示:
リプレイ選択画面で、save\replay 直下のサブフォルダを開いて中のリプレイを再生できるようになります。

リプレイ一覧のバージョン表記を隠す:
リプレイ一覧の各行頭にある "verX.XX " の表記を隠します。ファイル名が長い場合に見やすくなります。

対戦時の選出画面を自動撮影:
ゲーム内の設定で「リプレイを保存する」を選択している場合、
ネット対戦時の人形選出画面を自動で撮影します。
撮影された画面は、リプレイファイル（.rep）と同じ名前の .png としてreplayフォルダに保存します。


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


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

設定項目:
[pvp_hub]
language          = jp       ; ゲーム内で表示ラベルの言語
bgm_extension     = true     ; BGM選択機能の拡張
bgm_random_pool   = 1,2,3…   ; ランダムBGMの抽選対象を番号で指定
background_select = true     ; 戦闘背景指定
replay_subfolder  = true     ; リプレイのサブフォルダ表示
replay_hide_ver   = true     ; リプレイバージョン表記を隠す
replay_screenshot = true     ; 選出画面の自動撮影

language を jp または en に変更するとゲーム内ラベルの言語が切り替わります。
機能を一時的に無効化したい場合は各機能の値を true から false に書き換えて下さい。
bgm_random_pool の番号は、BGM選択欄に表示される曲の並び順（先頭を1とする番号）です。
変更後はゲームの再起動が必要です。


■■ 更新履歴 ■■
【ver2.2：2026.7.19】
・対戦BGMのランダム選択で、任意のBGMを抽選対象にする機能を追加
・リプレイ選択画面でサブフォルダ内のリプレイを再生できる機能を追加
・リプレイ一覧のバージョン表記を隠す機能を追加
・対戦時の選出画面を自動撮影する機能を追加
・コードマッチ/IPマッチ時に背景指定欄が一瞬表示される問題を修正

【ver1.93：2026.5.9】
・対戦メニューを開いた際、背景指定欄が表示遅延を起こしていた問題を解消

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

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


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

幻想人形演舞-ユメノカケラ-Extended(http://gensoushinki.com/index.php?lang=ja)は、
Barudo(https://twitter.com/Nukekip)様のチームが制作された、
幻想人形演舞-ユメノカケラ-の非公式拡張パッチです。

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

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