-----------------------------------------------------------------------------------------------
【名前】　　　　幻想人形演舞-ユメノカケラ- Extended StyleIconExtension
【用途】　　　　幻想人形演舞-ユメノカケラ- Extended のゲームUI/機能の追加
【バージョン】　2.0
【公開ページ】　https://xy1.ebb.jp/021
【製作者】　　　くしち (https://x.com/xyichi)
【公開日】　　　2025.10.14
【必要環境】　　幻想人形演舞-ユメノカケラ- Extended ver3.41/4.0
-----------------------------------------------------------------------------------------------


■■この拡張機能について■■
「幻想人形演舞-ユメノカケラ-(http://www.fo-lens.net/enbu_ap/)」
の
非公式拡張パッチである
「幻想人形演舞-ユメノカケラ- Extended (http://gensoushinki.com/) 」
の
ゲーム内UI/機能を拡張する非公式のダイナミックリンクライブラリです。
以下、当該DLLファイル及びその機能について「本拡張機能」と呼称します。

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


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

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


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

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

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

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

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

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


■■インストール■■
！！！既に他のプラグインを使用している場合共存できない場合があります。！！！
！！！ゲームクラッシュの恐れがあるので同時使用は行わないで下さい。！！！

幻想人形演舞-ユメノカケラ- Extended のゲーム実行ファイルと同じ場所に、
中身のdllごと plugins フォルダを配置して下さい。

plugins フォルダが既に存在する場合は、その中に "StyleIconPlugin.dll" だけを配置して下さい。
"StyleIconPlugin.dll" の過去のバージョンがある場合は、上書きして下さい。


幻想人形演舞-ユメノカケラ-/      # Extended	
└── SoD-Extended-JP.exe       # 既存ファイル/フォルダは環境によって若干違う
     ├SoD-Extended-EN.exe 
     ├gn_enbu.exe
     ├TPDPHook.dll
     ├TPDPHook.ini
     ├dat/
     ├save/
     ├...
     ├...
     ├...
     ├plugins/                  # ←このフォルダの下にdllを追加する
     └── StyleIconPlugin.dll  # ここに配置



■■アンインストール■■
"StyleIconPlugin.dll", "ReadMe.txt", "LICENSE"を削除して下さい。
レジストリを使ったり、新しいファイルを生成したりはしないのでファイル削除のみでOKです。


■■動作確認環境■■
・幻想人形演舞 -ユメノカケラ- Extended ver3.41
・幻想人形演舞 -ユメノカケラ- Extended ver4.0


これより古いバージョンについては動作保証外です。
また、幻想人形演舞（無印）/ -ユメノカケラ-については仕組み上動きません。
動作確認もしていません。
導入してもおそらく動かないか、ゲームがクラッシュします。


■■使い方■■
幻想人形演舞-ユメノカケラ- Extended を起動して下さい。
幻想人形演舞-ユメノカケラ- Extended に下記の機能が追加されます。

・人形箱を開くと、各人形の右上にスタイルを示すアイコンが人形の右上に表示される
・人形箱を開くと、各人形の右上に印を示すアイコンが人形の右上に表示される ※設定されている場合のみ(後述)
・タイトルバーにバージョン表記が追加される（StyleIconExtension v2.0）※設定されている場合のみ(後述)

全て表示や自動処理に関する機能のため、プレイヤー側で何か操作をすることはありません。


■■仕様の挙動■■
もし、PCの性能などの問題で、ゲームの起動があまりにも遅い場合、本拡張機能が適用されません。
ただし、後述の設定変更で適用までの時間を調整することで解決する場合があります。
デフォルトでの設定は3秒です。これよりも遅くしてみて下さい。

逆に、あまりにも高速にゲームが起動してしまうと適用が間に合いません。
この場合はあとから適用されるはずなので、人形箱を開き直してみて下さい。

また、人形箱を開いたまま一定時間操作しなかったり、ゲームをタスクバーに最小化したした際に、
ゲーム画面が真っ黒になっていることがありますが、ゲームは停止していません。
カーソル操作で復旧します。

datフォルダ内にアイコン用の画像ファイルを一瞬だけ生成しています。
ゲームの操作や動作に影響はありませんが、何らかの事情でこれを読み取れないとアイコンが表示されません。
印のアイコンが表示されなくてもゲームの操作に支障はありません。
現段階では環境に依存するものとして仕様としています。
将来のバージョンアップで解消する予定です。


■■設定変更■■
上記の適用時間や、タイトルバーのバージョン表記の有無を変更できます。

適用時間を変更する場合は、
ゲームフォルダの"TPDPHook.ini"をメモ帳で開き、[general]の下に
"styleicon_delay=【適用までの時間】"の行を追加して下さい。

例）
[general]
styleicon_delay=5000

この場合、5秒後に本拡張機能が適用されるようになります。
数値の単位はミリ秒です。5000なら5秒、2500なら2.5秒です。


また、タイトルバーにバージョンを表記する場合は、[general]の下に
"styleicon_override_title=true" の行を追加して下さい。
また、元々記述のある "set_window_title" の値を true にして下さい。

例）
[general]
...
(省略)
...
set_window_title=true
styleicon_override_title=true

こう記述すると、タイトルバーにExtended本体用のバージョンと、本拡張機能のバージョンが併記されます。


ただし、本拡張機能のバージョンだけを表示させることはできません。
つまり、下記のように書いても反映されません。

例）
set_window_title=false
styleicon_override_title=true


逆は成立します。下記のように書くと、Extended本体用バージョンだけ表示されます。

例）
set_window_title=true
styleicon_override_title=false


印のアイコンを非表示にする場合は、[general]の下に
"enable_mark_circles=false" の行を追加して下さい。

例）
[general]
...
(省略)
...
enable_mark_circles=false


■■更新履歴■■
【ver2.0：2025.10.14】
・人形箱内で各人形の右上に印を示すアイコンを表示させる機能を実装


【ver1.0：2025.7.23】
・公開
・人形箱内で各人形の右上にスタイルを示すアイコンを表示させる機能を実装
・タイトルバーのバージョン情報オンオフ切替機能を実装
・プラグイン反映までのディレイを調整できる機能を実装


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

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

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