ok-wuthering-waves README

The project's README from github.com/ok-oldking/ok-wuthering-waves. As one markdown file: README.md.

ok-ww logo
ok-ww

一个基于图像识别的鸣潮自动化程序，支持后台运行，基于 ok-script 开发。
An image-recognition-based automation tool for Wuthering Waves, with background mode support, developed with ok-script.

通过 Windows 接口模拟用户进行操作，无内存读取、无文件修改

平台 GitHub release 总下载量 Discord

官方网站： https://ok-script.com/ok-ww

English | 中文说明 | 繁體中文 | 日本語

演示与教程: YouTube

⚠️ 免责声明

本软件为外部辅助工具，旨在自动化《鸣潮》的部分游戏流程。它完全通过模拟常规用户界面与游戏交互，遵循相关法律法规。本项目旨在简化用户的重复性操作，不会破坏游戏平衡或提供不公平优势，也绝不会修改任何游戏文件或数据。

本软件开源、免费，仅供个人学习与交流使用，请勿用于任何商业或营利性目的。开发者团队拥有本项目的最终解释权。因使用本软件而产生的任何问题，均与本项目及开发者无关。

请注意，根据库洛官方的《鸣潮》公平运营声明：

严禁利用任何第三方工具破坏游戏体验。 我们将严厉打击使用外挂、加速器、作弊软件、宏脚本等违规工具的行为，这些行为包括但不限于自动挂机、技能加速、无敌模式、瞬移、修改游戏数据等操作。 一经查证，我们将视违规情况和次数，采取包括但不限于扣除违规收益、冻结或永久封禁游戏账号等措施。

使用本软件即表示您已阅读、理解并同意以上声明，并自愿承担一切潜在风险。

🚀 快速开始

  1. 下载安装包：从下方的“下载渠道”中选择一个，下载最新的 ok-ww-win32-China-setup.exe 安装文件。
  2. 安装程序：双击 ok-ww-win32-China-setup.exe 文件，并按照安装向导的提示完成安装。
  3. 运行程序：安装完成后，从桌面快捷方式或开始菜单启动 ok-ww 即可。

📥 下载渠道

✨ 主要功能

QQ_1762960844719

🔧 疑难解答 (Troubleshooting)

如果遇到问题，请在提问前按以下步骤逐一排查：

  1. 杀毒软件：将软件的安装目录添加到您的杀毒软件（包括 Windows Defender）的信任区或白名单中，以防文件被误删或拦截。
  2. 显示设置：
    • 一般可以开启游戏内滤镜，但不能开启显卡滤镜，例如 NVIDIA 动态亮丽、AMD 锐化。
    • 使用游戏默认的亮度设置。
    • 关闭任何在游戏画面上显示信息的叠加层（如 MSI Afterburner、Fraps 等显示的帧率）。
  3. 自定义按键：如果您修改了游戏内的默认按键，请务必在 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

💬 加入我们

本项目基于 ok-script 框架开发，简单易维护。欢迎有兴趣的开发者使用 ok-script 开发您自己的自动化项目。

🔗 使用ok-script的项目：

❤️ 赞助与致谢

赞助商 (Sponsors)

致谢

ok-wuthering-waves (ok-oldking/ok-wuthering-waves)

Searching Database…

7.8K ·GitHub
Ok-wuthering-waves
这是什么？ok-ww 是一款基于图像识别的《鸣潮》游戏自动化工具，可以自动战斗、自动刷声骸，并一键完成日常任务。
这是作弊引擎，还是只是个读屏幕的机器人？它完全通过模拟 Windows 输入和计算机视觉读取屏幕来控制游戏；不读内存，也不修改任何游戏文件。
怎么安装和运行？从发布渠道下载最新的 ok-ww-win32-China-setup.exe，运行安装程序，然后从桌面快捷方式或开始菜单启动 ok-ww。
用它需要 Python 吗？不需要，Windows 安装程序是自包含的；只有作为开发者从源码运行时才需要 Python（3.9+，推荐 3.12）。
自动战斗总能可靠工作吗？队伍里每个角色都必须装备主声骸，游戏分辨率至少 1280x720，不能开 GPU 锐化滤镜或悬浮 FPS 计数器，而且游戏必须稳定跑在 60 FPS，否则战斗和索敌都可能出问题。
用这个工具违反游戏规则吗？README 明确警告：使用任何第三方自动化工具都违反游戏条款、有封号风险，用户需自行承担全部风险。
它只支持 Windows 吗？是的，它是一个 Windows 桌面应用，通过在 Windows 上模拟操作系统级输入来自动化游戏。
游戏窗口最小化时它也能运行吗？可以，后台模式让它在游戏窗口最小化或被其他窗口遮挡时也能继续运行，不会打断你用电脑做别的事。
它支持哪些分辨率？它支持 4K 以及低至 1280x720 的所有 16:9 分辨率，对 21:9 超宽屏有部分兼容。
它能自动识别我的角色和技能吗？可以，它会自动识别所有角色并配置技能序列，无需手动设置，一键就能开始。
ok-script 是什么？ok-script 是本项目所依赖的底层自动化框架；《原神》《崩坏：星穹铁道》等其他游戏的类似自动化工具也基于它构建。
What are similar projects?March7thAssistant, MaaEnd, Umi-OCR, Game-Cheats-Manager, X-AnyLabeling, LunaTranslator, MaaAssistantArknights, CircuitLordVRModInstaller
Which topics is it in?openvino, games, qt, bot, onnx, ocr, game, windows-app, gaming, image-processing, agpl, computer-vision
Creator
ok-oldking
Size
293.3 MB
Stars
7.8K
Updated
CommitOct 10Releasev3.7.4Oct 05
Age
2y
Commits · 90 Days