デスクトップ版 v1.3.3.2 の同梱説明を基にしています。正式版の入手方法はダウンロードとインストールをご覧ください。

初期設定

1. 配布パッケージをすべて書き込み可能なフォルダーに展開してください。GGEA.exe だけをコピーせず、OpenCvSharpExtern.dll、config、resources との階層構造を保ちます。
2. Android エミュレーターを起動し、ゲームのインストールを確認します。ADB デバッグの設定がある場合は有効にします。
3. GGEA.exe の初回起動時に、実行中のプロセス、インストール情報のレジストリ、一般的なフォルダー、PATH から ADB を検索します。候補が一つなら自動選択し、複数なら参照可能な実行履歴の中で直近の ADB を優先します。履歴がない、または参照できない場合は判定できない旨を表示します。設定の一覧で確認してください。次回以降は保存済みの選択を保持します。
4. 検出に失敗すると設定画面を開きます。参照ボタンから adb.exe（BlueStacks は HD-Adb.exe）を選択し、保存します。パスは一覧に残り、再起動後も選択できます。キャンセルすると今回の編集は保存されません。ポータブル版、標準以外のインストール先、アクセス制限のあるフォルダーでは手動選択が必要な場合があります。
5. 必要に応じてエミュレーターの実行ファイルを選び、起動引数を確認します。MuMu は最初の Android インスタンス、LDPlayer は launch --index 0 が既定です。BlueStacks は同一フォルダーの HD-Adb.exe と HD-Player.exe を自動で組み合わせます。
6. BlueStacks では設定の詳細項目で Android Debug Bridge を有効にして保存してください。無効の場合、GGEA はその旨を案内します。
7. ゲームのサーバーと言語を選んで保存します。パッケージ名は自動設定されます。メイン画面に戻って一覧を更新し、対象デバイスが利用可能か確認します。

起動とゲームへの移動

エミュレーターがすでに起動している場合は、一覧から対象を選択してエミュレーター／ゲームの起動ボタンを押します。ADB に接続し、デバイスが利用可能になるのを待ってゲームを開きます。ADB の選択後や一覧更新後は、確認済みで起動識別情報が一致するオンライン対象だけを保持します。初回検出時、元の対象がオフラインになった場合、再起動後は手動選択が必要で、別アカウントへ自動で切り替わりません。同一インスタンスの TCP と emulator-* は boot_id が一致する場合だけ同一対象と扱います。対象アカウントのデバイスを選択していることを確認してください。デバイスのブランドは別途識別し、MuMu ではマネージャーのインスタンス情報も使って起動識別情報に基づき重複接続をまとめます。

自動操作には 1920×1080 の横画面が必要です。サイズが違う場合は自動タップを停止しますが、スクリーンショット機能で確認できます。開発・強化を一度実行する項目は既定で選択され、選択デバイスの画像と標準 ADB スワイプを使います。ブランドによる無効化は行いません。開発経路図ではゲームのズームを保持し、二つの立ち絵テンプレートと複数スケールの検索で対象を探します。連続する二フレームで安定して一致した場合だけタップし、対象不明、タイトル消失、検索上限、中止の場合は停止します。

デイリータスクの前に、アカウント、通信、イベントのダイアログを手動で確認してください。本人確認、データ同期、ダウンロード確認では自動操作を停止します。手動で処理してからやり直してください。

デイリータスク

1. 一覧で必要な項目を選び、ドラッグで順序を調整します。
2. タスク開始ボタンを押すと一覧順に実行し、処理の間にホーム画面へ戻って状態を確認します。
3. 中止ボタンを押した後は、現在のゲーム画面を確認してから再実行してください。

初回は低リスクの項目一つだけで接続とテンプレート認識を確認し、その後ほかのタスクを有効にすることを推奨します。

AP 消費とステージ移動

1. AP 消費ページで作品と HARD ステージを選択・管理し、プランを保存します。
2. 作品座標、テンプレート、stageSwipeCanvasDelta は現在の解像度で検証してください。エミュレーター、画面倍率、ゲームバージョンを変えた場合は再調整します。
3. 全画面スワイプを優先し、作品を安全なタップ範囲へ移動できない場合に限り、固定の半画面スワイプを一度使います。
4. タップ位置のずれ、未解放、タイトル認識失敗、スワイプ異常では直ちに停止します。繰り返し再試行せず、logs/ のログを保管してください。

テンプレート管理

スクリーンショット、テンプレート保存、テストの各機能で素材を管理します。画面を取得し、安定して識別しやすい領域を選択して保存し、同じページで信頼度と座標をテストしてください。ゲーム UI の更新で古いテンプレートが無効になった場合は再取得します。

テーマ・ログ・通知・更新

• 右上の設定の隣にある電球でライト／ダークを切り替えます。設定は直ちに保存され、次回起動時に復元されます。初回はダークテーマです。
• 終了通知は設定の Windows 通知スイッチで管理します。デイリーキュー、単独 AP 消費、自動スカウト、自動周回、自動攻略、ボール工場が対象です。利用者による中止やリソース不足では停止理由を表示します。
• デバイスの接続済み表示は ADB が使えることだけを表し、ゲームアカウントの状態確認を意味しません。
• logs/ に操作順序、認識結果、エラー理由を記録します。
• 更新前に config/、独自の AP プラン、座標、テンプレートをバックアップしてください。設定を直接上書きせず、必要に応じて移行します。ソースの配布スクリプトは artifacts/publish/ を上書きするため、旧パッケージのバックアップは backups/ に置きます。
• 起動、接続、認識の問題では ADB のパス、接続、ゲーム画面、テンプレートを確認します。自動操作中にパッケージ内のファイルを移動・削除しないでください。

実行時の注意

GGEA はテンプレートや画面状態が条件を満たすときだけ操作を続けますが、ゲーム画面、通信、アカウント、エミュレーターの状態は変化します。動作を見守り、ダイヤ、課金、アカウント認証、不明な画面が関係する場合は直ちに停止して手動で確認してください。

ファイルと配布パッケージ

プログラムのルートにある GGEA.exe を実行してください。config は設定、resources は認識素材、logs は実行ログです。すべて展開し、フォルダーを残してください。

配布 ZIP には「使用说明.txt」が含まれます。Markdown、開発者向け README、実行ログ、デバッグシンボル、過去のテスト版フォルダーは含みません。ソースリポジトリの README.md は開発者向けで、ZIP には同梱しません。

ショップ確認の原画像と診断メモは logs/shop、ホーム画面の認識資料は logs/recognition に保存します。開発用スキャン・位置検証の画像と JSON はプロジェクトの logs/captures に保存します。旧資料は自動移行しません。MuMu の画像転送用一時ファイルは読み取り後に削除し、認識テンプレートは resources/common/templates に保存します。

ローカルプラグイン

• 終了後、信頼できるプラグインを plugins/<id>/ にすべて配置します。起動後に設定で有効化・保存し、もう一度再起動すると反映します。
• プラグインはアシスタントと同じローカル権限を持ち、サンドボックスではありません。インストール、更新、削除はアプリを終了してから行います。
• 設定は config/plugins/ に保存され、アシスタントのオンライン更新でもプラグインは保持されます。プラグインの後始末に失敗した場合は新しいデバイス操作を止めます。設定で無効にして再起動してください。
• 旧拡張の設定はプラグインが取り込めるよう残ります。未インストール・無効のプラグインの拡張機能は実行しません。

前のページダウンロードとインストール

次のページアプリ画面