ok-oldking/ok-wuthering-waves
鸣潮 后台自动战斗 自动刷声骸 一键日常 Automation for Wuthering Waves
About ok-oldking/ok-wuthering-waves
ok-oldking/ok-wuthering-waves is an open-source project on GitHub, mainly written in Python. 鸣潮 后台自动战斗 自动刷声骸 一键日常 Automation for Wuthering Waves It currently holds 7,548 stars and 643 forks with 154 open issues, and was last pushed on 2026-10-04 (repository created 2024-06-08).
Project Overview
Git Homed tracks it on the Today's Trending board, currently at rank #66 with 69 new stars today.
GitHub Repository Details
README
ok-ww
一个基于图像识别的鸣潮自动化程序,支持后台运行,基于 ok-script 开发。
An image-recognition-based automation tool for Wuthering Waves, with background mode support, developed with ok-script.
通过 Windows 接口模拟用户进行操作,无内存读取、无文件修改
官方网站: https://ok-script.com/ok-ww
English | 中文说明 | 繁體中文 | 日本語
---
⚠️ 免责声明
本软件为外部辅助工具,旨在自动化《鸣潮》的部分游戏流程。它完全通过模拟常规用户界面与游戏交互,遵循相关法律法规。本项目旨在简化用户的重复性操作,不会破坏游戏平衡或提供不公平优势,也绝不会修改任何游戏文件或数据。
本软件开源、免费,仅供个人学习与交流使用,请勿用于任何商业或营利性目的。开发者团队拥有本项目的最终解释权。因使用本软件而产生的任何问题,均与本项目及开发者无关。
请注意,根据库洛官方的《鸣潮》公平运营声明:
严禁利用任何第三方工具破坏游戏体验。
我们将严厉打击使用外挂、加速器、作弊软件、宏脚本等违规工具的行为,这些行为包括但不限于自动挂机、技能加速、无敌模式、瞬移、修改游戏数据等操作。
一经查证,我们将视违规情况和次数,采取包括但不限于扣除违规收益、冻结或永久封禁游戏账号等措施。
使用本软件即表示您已阅读、理解并同意以上声明,并自愿承担一切潜在风险。
🚀 快速开始
1. 下载安装包:从下方的“下载渠道”中选择一个,下载最新的 ok-ww-win32-China-setup.exe 安装文件。
2. 安装程序:双击 ok-ww-win32-China-setup.exe 文件,并按照安装向导的提示完成安装。
3. 运行程序:安装完成后,从桌面快捷方式或开始菜单启动 ok-ww 即可。
📥 下载渠道
- GitHub: 官方发布页,全球访问速度快。(请下载
setup.exe安装包,而不是Source Code源码压缩包) - Mirror酱: 国内镜像,下载可能需要购买其平台的 CD-KEY。
- 百度网盘: 免费下载
- 夸克网盘: 免费下载
✨ 主要功能
- 高分辨率支持: 流畅运行于 4K 及以下所有 16:9 分辨率(最低 1280x720)。部分功能兼容 21:9 等超宽屏。
- 后台模式: 支持游戏窗口最小化或被遮挡时在后台运行,不影响您使用电脑。
- 智能识别: 全角色自动识别,无需手动配置技能序列,一键启动。
- 自动静音: 在后台运行时,可自动将游戏静音。
🔧 疑难解答 (Troubleshooting)
如果遇到问题,请在提问前按以下步骤逐一排查:
1. 杀毒软件:将软件的安装目录添加到您的杀毒软件(包括 Windows Defender)的信任区或白名单中,以防文件被误删或拦截。 2. 显示设置:
- 一般可以开启游戏内滤镜,但不能开启显卡滤镜,例如 NVIDIA 动态亮丽、AMD 锐化。
- 使用游戏默认的亮度设置。
- 关闭任何在游戏画面上显示信息的叠加层(如 MSI Afterburner、Fraps 等显示的帧率)。
ok-ww 的设置中进行同步配置。仅支持设置中列出的按键。
4. 软件版本:检查并确保您使用的是最新版本的 ok-ww。
5. 游戏性能:请确保游戏能稳定在 60 FPS 运行。如果帧率不稳定,请尝试降低游戏画质或分辨率。
6. 游戏断线:在 ok-ww 设置中开启“启动后关闭启动器”,确保启动器进程未在运行;或者使用源码运行。
7. OpenVINO 报错:如果遇到 0x000005 报错,并且使用的是带 NPU 的 Intel CPU,请更新至 Intel 最新的 NPU 驱动。
8. 寻求帮助:如果以上步骤都无法解决您的问题,请通过社区渠道提交详细的错误报告。
9. 关闭自动奔跑:游戏设置里关闭自动奔跑。
10. 为所有角色装备主声骸:队伍中的每个角色都必须装备主声骸(画面右下角应显示声骸技能图标)。任何一个角色未装备主声骸时,自动战斗将无法正常运行,并可能反复锁定敌人而不攻击。
---
💻 开发者专区
从源码运行 (Python)
推荐使用 Python 3.12。要求 Python 3.9 及以上版本,但其他版本尚未经过完整测试。
# 安装或更新依赖
pip install -r requirements.txt --upgrade
运行 Release 版本
python main.py
运行 Debug 版本
python main_debug.py
命令行参数
您可以通过命令行参数实现自动化启动。
# 示例:启动后自动执行第一个任务(一条龙),并在任务完成后退出程序
ok-ww.exe -t 1 -e
-t或--task: 启动后自动执行第 N 个任务。1代表任务列表中的第一个。-e或--exit: 任务执行完毕后自动退出程序。
💬 加入我们
- QQ 交流群:
1035795301(入群答案:老王同学OK) - QQ 频道: 点击加入 (群满或获取最新资讯)
- 开发者群:
926858895( 注意: 此群仅面向有开发能力、希望参与贡献的开发者,入群前请确保您已能够从源码成功运行项目。)
🔗 使用ok-script的项目:
- 鸣潮 https://github.com/ok-oldking/ok-wuthering-waves
- 原神(停止维护,
- 少前2 https://github.com/ok-oldking/ok-gf2
- 星铁 https://github.com/Shasnow/ok-starrailassistant
- 星痕共鸣 https://github.com/Sanheiii/ok-star-resonance
- 二重螺旋 https://github.com/BnanZ0/ok-duet-night-abyss
- 白荆回廊(停止更新) https://github.com/ok-oldking/ok-baijing
❤️ 赞助与致谢
赞助商 (Sponsors)
- EXE 签名: Free code signing provided by SignPath.io, certificate by SignPath Foundation.