ok-ww/ドキュメント

ok-ww logo
ok-ww

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

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

Platform GitHub release Total Downloads Discord

公式サイト: https://ok-script.com/ok-ww

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

デモ＆チュートリアル: YouTube

⚠️ 免責事項

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

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

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

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

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

🚀 クイックスタート

  1. インストーラーのダウンロード: 下記の「ダウンロード」セクションから、最新の ok-ww-win32-Global-setup.exe インストーラーファイルをダウンロードします。
  2. プログラムのインストール: ok-ww-win32-Global-setup.exe ファイルをダブルクリックし、画面の指示に従ってインストールを完了します。
  3. プログラムの実行: インストール後、デスクトップのショートカットまたはスタートメニューから ok-ww を起動します。

📥 ダウンロード

  • GitHub: 公式リリースページ。世界中から高速にアクセスできます。（Source Code のアーカイブではなく、setup.exe インストーラーをダウンロードしてください）。

✨ 主な機能

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

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

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

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

💻 開発者向け

ソースコードからの実行（Python）

Python 3.12 を推奨します。Python 3.9 以降が必要ですが、その他のバージョンは十分にテストされていません。

# 依存関係のインストールまたは更新
pip install -r requirements.txt --upgrade

# リリース版の実行
python main.py

# デバッグ版の実行
python main_debug.py

コマンドライン引数

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

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

💬 参加しよう

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

🔗 ok-script を使用しているプロジェクト:

❤️ スポンサーと謝辞

スポンサー

謝辞

GitHub でソースを見る ↗ · ページ生成日時: 2026年8月9日