EC Face Personality Generator は、『EmotionCreators（エモーションクリエイターズ）』のキャラメイク画面において、作成中のキャラクターの顔立ち・スライダー値・表情（ブレンドシェイプ）および頭部正面ショットの画像解析から、RPG風ステータス・性格タグ・二次元美学に基づいた「美少女度スコア（SSR〜N）」を自動判定し、キャラカード（PNG）に保存するプラグインです。
✦ 主な機能
1. 骨格＆スライダーによる性格・RPGステータス算出（スライダー解析）
顔の52箇所におよぶスライダー値（shapeValueFace）を工場出荷時の中立状態（0.0/0.5基準）からどれだけ動かしたかを相対計算。
6大ステータス: STR（腕力）、CON（体力）、AGI（敏捷）、INT（知力）、CHA（魅力）、MOR（士気）
戦闘派生値: 会心率（%）、治癒親和（回復力）、威圧感（低美少女度＋硬質骨格で上昇）
性格・クラス傾向: 傲嬌/鋭利、温順治癒、堅毅沈着、冷艶、元気、無口など＋クラス傾向（戦士、暗殺者、治癒者など）
2. 二次元特化の美少女度（顔面偏差値）ビジュアルエンジン
一般的な「三庭五眼（実写用の比率）」を排除し、アニメ・二次元黄金比に特化した評価アルゴリズムを採用。
眼面比（40%）: 耳幅および皮膚輪郭から計測した可視顔幅に対する眼幅・眼間距離のバランス。
対称性（30%）: 骨格位置の水平度・サイズ差 ＋ 左右反転差分による対称性。
虹彩・瞳（20%）: 瞳の彩度、明暗構造、ハイライト比率（ネオンカラーの瞳も正当に高評価）。
フェイスライン（10%）: 顎のVライン収縮度・輪郭の滑らかさ。ハイネック・襟・髪の毛を誤認識しない皮膚マスク処理を搭載。
萌え・成熟・生気メーター ＆ SSR/SR/R/N レアリティ判定（例: 【SSR】傲嬌系看板娘）。
3. MOD頭部（カスタムヘッド）・表情ブレンドシェイプ完全対応
外部MODヘッドなどの「スライダーが効かない顔」であっても、頭部骨格（ボーン）と仮想カメラによる自動撮影で視覚的に判定可能。
笑顔（smile）、怒り（angry）、まばたき（blink）などの表情ブレンドシェイプを検知し、性格・美少女度査定に反映。
4. キャラカード（PNG）への自動保存・引き継ぎ
キャラカード保存時（ExtendedSave 経由）、その瞬間の顔データ・美少女度を自動撮影＆JSONデータとしてカード内部に書き込みます。
他の環境でカードを読み込んだ際も、過去の査定結果をそのまま復元・閲覧できます。
✦ 動作環境・必要前提プラグイン
EmotionCreators（ゲーム本体）
BepInEx 5.x（x64）
KKAPI / ECAPI (marco.kkapi)
ExtensibleSaveFormat (com.bepis.bepinex.extendedsave)
（推奨・オプション）OpenCV 高精度ビジュアル解析
OpenCV（OpenCvSharp）を導入すると、皮膚のYCrCb色空間判定・HSV虹彩解析・局所光照正規化反転対称性などの高度な画像解析パイプラインが有効になります。
OpenCvSharp.dll および OpenCvSharpExtern.dll (x64) を BepInEx/plugins/ または BepInEx/userlibs/ に配置してください。
未導入時は、内蔵のピクセル判定アルゴリズムに自動でフォールバック（退行）するため、クラッシュすることなく動作します。
✦ インストール方法
リリースから ECFacePersonality.dll をダウンロードします。
ゲームのインストールフォルダ内にある BepInEx/plugins/ フォルダへ配置します。
（OpenCVを使用する場合）OpenCvSharp.dll と OpenCvSharpExtern.dll も同フォルダまたは BepInEx/userlibs/ に配置します。
✦ メイカー画面での使い方
1. パネルの展開と操作
メイカーに入ると、画面右上に小さく 「面相評価」 タブが表示されます（デフォルトで作業の邪魔にならないよう折りたたまれています）。
タブをクリックすると、詳細な査定パネルが展開されます。
タイトルバーをドラッグすることで画面内の好きな位置へ移動可能です。右上の 「收起」 ボタンでいつでもタブ状態に戻せます。
2. 査定データの更新（手動更新システム）
メイカーの動作を重くしないため、本プラグインは手動更新が基本となっています。スライダーを動かした後は以下のボタンを押してください。
「再評価」ボタン:
スライダーの変更を検知すると、ボタン横に ● マークが点灯し警告文が出ます。
クリックすると現在のスライダー値からRPGステータス・性格タグを再計算します。
「再撮影」ボタン:
仮想カメラを起動し、顔の正面ショットを撮影して美少女度・虹彩・輪郭・萌属性を再解析します。
カード保存時の自動処理:
カードを保存（上書き含む）する際は、自動的にその時点の顔が撮影・再評価されてカードに書き込まれます（「再撮影」を押し忘れていても最新の状態で保存されます）。
✦ パネルの表示項目解説
| 項目 | 内容 |
| 性格タグ (Chips) | 顔立ちから導き出された性格（傲嬌/鋭利、温順治癒、元気など）。 |
| 顔面偏差値 / レア度 | 美少女度総合スコア（1〜100）およびランク（SSR〜N）。右上に解析エンジン名（OpenCV / 内置 / ONNX）を表示。 |
| 二次元称号 | 美少女度と萌属性タグを組み合わせた称号（例: 【SSR】傲嬌系看板娘）。 |
| サブメーター | 萌度（童顔・丸顔・大目）、成熟（面長・吊り目・シャープな顎）、生気（ハイライト・瞳の鮮やかさ）。 |
| クラス傾向 | 最も高いステータスに基づいて割り振られる推奨ロール（戦士、暗殺者、策士、治癒者など）。 |
| ステータスバー | STR / CON / AGI / INT / CHA / MOR（白線は基準値50）。 |
| 戦闘補正値 | 会心率（眼尾の吊り上がり等で上昇）、治癒親和、威圧感、魅力倍率。 |
| 詳細指標 (Metrics) | 展開すると、目・鼻・口・顎などの各幾何学オフセット（-1.0〜+1.0）を確認できます。 |
✦ 主な設定項目（BepInEx Config）
設定ファイル（BepInEx/config/com.custom.ec.facepersonality.cfg）または Configuration Manager からゲーム内でも調整可能です。
[General]
Enabled (デフォルト: true): プラグイン全体の有効/無効。
StartCollapsed (デフォルト: true): メイカー入場時にパネルを閉じた状態（右上タブ）から開始するかどうか。
AutoRecalculate (デフォルト: false): スライダー変更時に自動でリアルタイム再評価するかどうか（※PC負荷を考慮し、デフォルトはOFF）。
[Calibration]（符号のキャリブレーション）
MOD環境等により「目尻を上げているのに性格が下垂目（治癒系）と判定される」といった逆転現象が発生した場合、各項目の数値を 1 から -1 に変更することで方向を即座に反転できます。
EyeTiltSign: 目尻の上下方向
MouthCornerSign: 口角の上下方向
BrowSign: 眉毛の角度（吊り眉/八の字）
JawSign: 顎の幅
[Beauty]（撮影・美少女度査定）
Enabled (デフォルト: true): 撮影および美少女度判定の有効化。
CaptureOnSave (デフォルト: true): カード保存時に自動補正撮影を行うか。
UseOpenCV (デフォルト: true): OpenCvSharpによる解析を行うか（利用不可時は自動で内蔵処理に切り替わります）。
CaptureMargin (デフォルト: 1.22): カメラの画角余白（顎位置を基準に頭頂部の余白を調整）。
CaptureZoom (デフォルト: 1.0): カメラの拡大・縮小。
SaveDebugCapture (デフォルト: true): 撮影した画像とランドマーク解析ログを BepInEx/EC_FacePersona/ に出力（調整・確認用）。
✦ トラブルシューティング / FAQ
Q. スライダーを動かしてもパネルの数値が変わりません。
A. 負荷軽減のため手動更新になっています。パネル下の「再評価」または「再撮影」をクリックしてください。
Q. OpenCVが有効になりません（「内置」と表示される）。
A. OpenCvSharp.dll および OpenCvSharpExtern.dll が 64bit (x64) 版 であるか、配置場所（BepInEx/plugins/ など）が正しいかご確認ください。ログ（LogOutput.log）に詳細なエラー理由が出力されます。
Q. 髪型や服装の襟のせいで顔の判定がおかしくなりませんか？
A. 本プラグインは頬部分の皮膚色（YCrCb色空間）をサンプリングし、白色のシャツ襟や髪の毛を除外する皮膚マスク処理を行っているため、高襟やマフラーを着用していても正確に顎ラインを検出できます。
✦ ライセンス・免責事項
本プラグインは個人が楽しむ目的で制作された非公式MODです。
ゲーム本体のアップデートや他MODとの競合により予期せぬ動作を引き起こす可能性があります。重要なキャラカードのバックアップを推奨します。