CCResultSS
FINAL FANTASY XIVの特定の画面を自動検出してスクリーンショットを撮影するアプリケーションです
■ 機能
- クリスタルコンフリクトのリザルト画面とPVPプロフィール画面を3秒ほどで自動検出します
- 検出時に自動的にスクリーンショットを保存します
- ゲームへの干渉なし: このアプリはPythonで画面をチェックしているだけのため、ゲームの機能や操作に一切干渉しません
■ セットアップ
□ 必要な環境
- Windowsであること
- Python 3.12 もしくは 3.13 がインストールされていること（推奨。インストール方法はPythonInstallationGuide.htmlを参照）
- 注意: Python 3.14以上では、一部のライブラリがビルドできないため動作しない可能性があります
- Python 3.9以降でも動作する可能性があります。アプリを実行してスクリーンショットが取得できていれば問題ありません
- FINAL FANTASY XIVが起動していること
■ 使用方法
□ 起動方法
python -m venv .venv
.venv\Scripts\activate # Windowsの場合
pip install -r app\requirements.txt
python app\src\main.py
□ セキュリティ警告について
□ 動作確認
- アプリケーションを起動したら、PvPプロフィール画面を開いてスクリーンショットが正常に撮影されるか確認してください。撮影成功時はデスクトップ通知が表示され、
screenshots/フォルダに画像が保存されます。
□ 停止
- Ctrl+Cを押す、またはコマンドプロンプトを閉じると停止します。
■ 設定
- スクリーンショットの画像形式を設定できます。
jpeg: ファイルサイズが小さく、非可逆圧縮（デフォルト）png: ファイルサイズが大きく、可逆圧縮（高品質）
□ CCRESULT_BASE_SCALE / PVPPROFILE_BASE_SCALE
□ CCRESULT_DELAY / PVPPROFILE_DELAY
- 検知してから画像取得するまでの待ち時間を設定できます（デフォルト: 0秒）。
- 例えば、シリーズレベルアップ時やアラガントームストーン入手の表示がリザルト画面と重なる場合などに、調整としてご利用ください
- CCRESULT_DELAY = 0 # クリスタルコンフリクトリザルト画面の待ち時間（秒）
- PVPPROFILE_DELAY = 0 # PVPプロフィール画面の待ち時間（秒）
- 例:
PVPPROFILE_DELAY = 0.5 と設定すると、検知後0.5秒待ってからスクリーンショットを撮影します
- 待ち時間はログにも表示されます（
待ち時間: X.Xms）
- 設定を変更した場合は、アプリケーションを再起動してください。
□ CCRESULT_SHOOT_COUNT / PVPPROFILE_SHOOT_COUNT
- 検知してから待ち時間の後に撮影する回数を設定できます（デフォルト: 1回、範囲: 1-5回）。
- 人によっては1回の撮影では適切なタイミングで撮れない場合があるため、複数回撮影することで確実に撮影できます
- CCRESULT_SHOOT_COUNT = 1 # クリスタルコンフリクトリザルト画面の撮影回数
- PVPPROFILE_SHOOT_COUNT = 1 # PVPプロフィール画面の撮影回数
- 例:
PVPPROFILE_SHOOT_COUNT = 3 と設定すると、待ち時間後に1枚撮影し、さらに1秒後にもう1枚、さらに1秒後にもう1枚撮影します（合計3枚）
- 複数回撮影の場合、1枚目には連番が付かず、2枚目以降に連番が追加されます（例:
20251230_120000_pvpprofile_2.jpg、20251230_120000_pvpprofile_3.jpg）
- 撮影回数はログにも表示されます（
撮影: 1/3回目、撮影: 2/3回目、撮影: 3/3回目など）
- 設定値は1から5の整数である必要があります。整数でない場合、アプリ起動時にエラーメッセージが表示されて終了します。
- 設定を変更した場合は、アプリケーションを再起動してください。
■ ファイルの保存場所
- スクリーンショット:
screenshots/フォルダ（実行時に自動作成）
- ファイル名（1回撮影の場合）:
YYYYMMDD_HHMMSS_ccresult.jpg / YYYYMMDD_HHMMSS_pvpprofile.jpg
- ファイル名（複数回撮影の場合）: 1枚目は通常のファイル名、2枚目以降は
YYYYMMDD_HHMMSS_ccresult_2.jpg、YYYYMMDD_HHMMSS_ccresult_3.jpg のように連番が追加されます
- ログ:
app/logs/フォルダ（実行時に自動作成）
- ファイル名:
ccresultss_YYYYMMDD.log
■ 動作について
- 監視間隔: 1秒に1回、ゲーム画面をチェック
- 撮影タイミング: 画面が検出されたとき（同じ画面が表示され続けている間は繰り返し撮影されません）
- キャプチャ方式: Windows Graphics Capture API (WinRT) を最優先で使用します（Windows 11推奨）。WinRTが失敗した場合は、Windows API（PrintWindow）にフォールバックし、さらに失敗した場合はmss方式にフォールバックします。WinRT/PrintWindowを使用すると、他のウィンドウに隠れていてもターゲットウィンドウの内容のみをキャプチャできます
- ログ表示: コマンドプロンプトにリアルタイムで表示されます。使用したキャプチャモード（WinRT、PrintWindow、またはmss）も表示されます
- 通知: 撮影成功時にデスクトップ通知を表示します（フルスクリーン時は表示されない場合がありますが、Windowsのアクションセンターに記録されます）
■ 注意事項
- ゲームウィンドウを最小化している場合は撮影できません
- フルスクリーン時の通知: ゲームをフルスクリーンで実行している場合、Windowsの仕様により通知が表示されないことがあります。撮影成功はログで確認できます
- UIの文字が被る場合: 自動検知でスクリーンショットを撮影する際、シリーズレベルアップ時の文字など、画面上に表示されているUI要素が画像に被って写ることがあります。この場合、CCRESULT_DELAY / PVPPROFILE_DELAY や CCRESULT_SHOOT_COUNT / PVPPROFILE_SHOOT_COUNT の設定を変更してご調整ください
□ 利用規約について
本アプリケーションは以下の特徴があります：
- ゲームへの干渉なし: ゲームのメモリやプロセスにアクセスせず、Windows APIを使用した画面キャプチャのみを行います
- 操作の自動化なし: ゲームの操作を自動化したり、キー入力をシミュレートしたりする機能はありません
- データの改変なし: ゲームのデータを読み取ったり、改変したりする機能はありません
- 公平性への影響なし: ゲームの公平性や競技性に影響を与える機能は一切ありません
ご注意: 本ツールは画面のピクセル情報を読み取るだけです。ゲームデータの改ざんや自動操作、メモリの読み取りは一切行いません。技術的には、OBSやDiscordの画面共有と同様に「画面をキャプチャして解析（エンコード）」する機能です。使用は自己責任でお願いします。万が一、本アプリケーションの使用により何らかの問題が発生した場合、開発者は責任を負いかねますので、ご了承ください。
■ トラブルシューティング
□ 画面が検出されない
config.iniのCCRESULT_BASE_SCALEやPVPPROFILE_BASE_SCALEの値を調整してください（ゲーム画面のUI倍率に合わせて設定します）
□ スクリーンショットが保存されない
screenshots/フォルダの書き込み権限を確認- ディスク容量を確認
□ ライブラリのインストールに失敗する
- インターネット接続を確認: ライブラリのダウンロードにはインターネット接続が必要です
- ウイルス対策ソフトの確認: ウイルス対策ソフトがブロックしていないか確認してください
- 管理者権限で実行: バッチファイルを右クリック → 「管理者として実行」を試してください
- プロキシ設定: プロキシを使用している場合、設定を確認してください
- ディスク容量: ディスク容量が不足していないか確認してください
- エラーメッセージの確認: バッチファイル実行時に表示されるエラーメッセージを確認してください
□ アプリケーションが動作しない
- ログファイル（
app/logs/ccresultss_YYYYMMDD.log）を確認
- ゲーム（FINAL FANTASY XIV）が起動していることを確認
- ウィンドウが最小化されていないことを確認
□ キャプチャ方式のフォールバックについて
- 本アプリケーションは、Windows Graphics Capture API (WinRT) を最優先で使用しますが、以下の場合にフォールバックが発生します：
- WinRTが失敗した場合 → PrintWindow API にフォールバック
- PrintWindowが失敗した場合 → mss方式にフォールバック
- フォールバックが発生する主なケース：
- ウィンドウが最小化されている場合
- 特定のウィンドウタイプでキャプチャAPIがサポートされていない場合
- セキュリティ上の理由でキャプチャAPIが制限されている場合
- 使用されたキャプチャモードはログに表示されます（「キャプチャモード: WinRT」「キャプチャモード: PrintWindow」「キャプチャモード: mss」）
- mss方式では、他のウィンドウが重なっていると、その重なった部分もキャプチャされる可能性があります
- 通常のゲームウィンドウ（FINAL FANTASY XIV）では、WinRTまたはPrintWindowが正常に動作します
□ 通知が表示されない
- ゲームをフルスクリーンで実行している場合、Windowsの仕様により通知が表示されないことがあります
- 通知はWindowsのアクションセンター（通知センター）に記録されます。タスクバーの通知アイコンから確認できます
- 撮影成功はログ（コマンドプロンプトまたは
app/logs/ccresultss_YYYYMMDD.log）でも確認できます
- 通知を確認したい場合は、ゲームをウィンドウモードで実行してください
■ 開発・著作権情報
ライセンス (MIT License)
- 本ソフトウェアはMITライセンスのもとで公開されています。
- 商用・非商用問わず、自由に使用・改修・再配布が可能です。
- 本ソフトウェアを使用したことによるいかなる損害についても、作者は一切の責任を負いません。