ok-ww

ok-script で開発された、鳴潮（Wuthering Waves）向けの画像認識ベースの自動化ツールです。バックグラウンドモードに対応しています。

Windows のユーザーインターフェースをシミュレートして動作し、メモリの読み取りやファイルの改変は一切行いません。

English | 简体中文 | 繁體中文 | 日本語

デモ＆チュートリアル:

⚠️ 免責事項

本ソフトウェアは、鳴潮のゲームプレイの一部を自動化するために設計された外部補助ツールです。関連する法令を遵守し、標準的なユーザーインターフェース操作のシミュレートのみによってゲームと連携します。本プロジェクトはユーザーの反復的な作業を簡略化することを目的としており、ゲームバランスを損なったり、不公平な優位性を提供したりするものではありません。ゲームのファイルやデータを改変することは決してありません。

本ソフトウェアはオープンソースかつ無料であり、個人の学習および交流のみを目的としています。商業目的や営利目的の活動には使用しないでください。開発チームは最終的な解釈権を留保します。本ソフトウェアの使用によって生じたいかなる問題についても、本プロジェクトおよびその開発者は責任を負いません。

なお、Kuro Games 公式による鳴潮のフェアプレイ宣言では、以下のように定められています:

ゲーム体験を妨害するサードパーティ製ツールの使用は固く禁止されています。チート、スピードハック、チートソフトウェア、マクロスクリプトなどの不正なツールの使用に対しては、厳格な措置を講じます。これには、自動周回、スキル加速、無敵化、テレポート、ゲームデータの改変などが含まれますが、これらに限定されません。違反が確認された場合、その重大性と頻度に応じて、不正に得た利益の没収、ゲームアカウントの一時停止または永久凍結などを含む（ただしこれらに限定されない）処罰を科します。

本ソフトウェアを使用することにより、あなたは上記の声明を読み、理解し、同意したものとみなされ、起こりうるすべてのリスクを自らの意思で負うことになります。

✨ 主な機能

高解像度対応: 4K までのすべての 16:9 解像度（最低 1280x720）でスムーズに動作します。一部の機能は 21:9 などのウルトラワイド解像度にも対応しています。
バックグラウンドモード: ゲームウィンドウが最小化されていたり、他のウィンドウに隠れていたりしてもバックグラウンドで動作するため、PC を他の作業に使えます。
インテリジェント認識: すべてのキャラクターを自動的に認識するため、スキルシーケンスを手動で設定する必要がありません。ワンクリックで開始できます。
自動ミュート: バックグラウンドで動作している間、ゲームの音声を自動的にミュートできます。

🔧 トラブルシューティング

問題が発生した場合は、サポートを求める前に以下の手順を一つずつ確認してください:

アンチウイルスソフト: ファイルが誤って削除またはブロックされるのを防ぐため、ソフトウェアのインストールディレクトリをアンチウイルスソフト（Windows Defender を含む）の例外またはホワイトリストに追加してください。
ディスプレイ設定:
- ゲーム内フィルターは通常有効にできます。
- Windows HDR は有効にできますが、Auto HDR（自動 HDR）は必ず無効にしてください。
- RTX HDR、RTX Dynamic Vibrance、AMD シャープニングなどの GPU フィルターは無効にすることをおすすめします。
- ゲームのデフォルトの明るさ設定を使用してください。
- ゲーム画面上に情報を表示するオーバーレイ（MSI Afterburner や Fraps などのフレームレート表示等）を無効にしてください。
カスタムキー設定: ゲーム内のデフォルトのキー設定を変更している場合は、ok-ww の設定でも同様に更新する必要があります。設定に記載されているキー設定のみがサポートされています。
ソフトウェアのバージョン: 最新バージョンの ok-ww を使用していることを確認してください。
ゲームのパフォーマンス: ゲームが 60 FPS で安定して動作することを確認してください。フレームレートが不安定な場合は、ゲームのグラフィック品質や解像度を下げてみてください。
ゲームの接続切断: ok-ww の設定で「起動後にランチャーを閉じる」を有効にし、ランチャープロセスが実行されていないことを確認するか、ソースコードから ok-ww を実行してください。
OpenVINO エラー: NPU 搭載の Intel CPU で 0x000005 エラーが発生した場合は、Intel の最新 NPU ドライバーに更新してください。
サポートを受ける: 上記の手順で問題が解決しない場合は、コミュニティチャンネルを通じて詳細なバグレポートを提出してください。
自動ダッシュを無効にする: ゲーム設定で自動ダッシュを無効にしてください。
すべてのキャラクターにメイン音骸を装備する: チーム内のすべてのキャラクターにメイン音骸を装備してください（画面右下に音骸スキルのアイコンが表示される状態）。1人でも未装備の場合、自動戦闘は正常に動作せず、敵を繰り返しロックオンするだけで攻撃しないことがあります。

💻 開発者向け

ソースコードからの実行

開発環境、ソースからの実行、貢献については貢献ガイドを参照してください。

AI スキル

プロジェクトスキルに対応したコーディングエージェントでこのリポジトリを開き、スキル名または自然言語で依頼できます。詳しい使い方、準備、実行手順はエージェントに確認してください。

チームの評価または改善を行う前に、チームを選択し、ゲーム内の「深境再临」または「终焉矩阵」に入ってください。

スキル	概要
evaluate-team	複数回の戦闘で現在のチームの自動戦闘を評価し、改善案を提示します。
improve-team	チームの評価に基づき、自動戦闘の改善を提案・検証します。
ok-script-develop	ok-script を使ってゲーム自動化機能を開発・検証します。
ok-script-tasks	自動化タスクを作成、変更、レビューします。
ok-ww-characters	キャラクターの自動戦闘ロジックを開発、レビュー、テストします。
ok-script-i18n	タスク UI の翻訳を追加、同期、コンパイルします。
pr-review	本プロジェクトの GitHub PR をレビューまたはマージします。
deploy	完了した変更をコミットし、バージョンタグを作成して公開します。
use-local-venv	Python コマンドにリポジトリ内の仮想環境を優先して使用します。

コマンドライン引数

コマンドライン引数を使用して自動起動できます。

# 例: 起動後に最初のタスクを自動実行し、完了したらプログラムを終了する
.\.venv\Scripts\python.exe main.py -t 1 -e

-t または --task: 起動後にリストの N 番目のタスクを自動的に実行します。1 は最初のタスクを表します。
-e または --exit: タスクの完了後にプログラムを自動的に終了します。

💬 参加しよう

本プロジェクトは ok-script フレームワークをベースに開発されており、シンプルでメンテナンスしやすい構成です。独自の自動化プロジェクトを作成したい開発者の方は、ぜひ ok-script をご利用ください。

❤️ スポンサーと謝辞

スポンサー

EXE 署名: SignPath.io による無料のコード署名、証明書は SignPath Foundation より提供。