Yuanhao Feng

返回

AutoMoyu

Windows 版 Minecraft 基岩版自动钓鱼工具,识别鱼竿状态自动抛竿,也能通过声音判断咬钩。

两种模式#

AutoMoyu 是适用于 Windows 版 Minecraft 基岩版的自动钓鱼工具。它截取游戏画面识别手持鱼竿的状态,在鱼竿收回后自动重新抛竿。按使用场景分两种模式,都是全自动运行:

  • 钓鱼机模式:配合游戏内的半自动钓鱼机使用,钓鱼机负责收竿,AutoMoyu 负责重新抛竿。
  • 野钓模式:不需要钓鱼机,对着任意水面即可。AutoMoyu 通过声音判断咬钩,自动收竿再抛竿。

AutoMoyu 的首页和统计页

左:首页显示当前状态、本次钓获和动态记录;右:统计页汇总每日条数和上钩用时分布。

无需手动配置#

首次使用时,程序会自己抛竿两次完成校准,约 10 秒,不需要框选区域或调整阈值。校准结果按窗口尺寸保存,白天、夜晚和雨天都能用,昼夜过渡时也会随画面亮度自动调整。

在高延迟服务器上,服务器回弹会让刚抛出的竿在画面上跳回。AutoMoyu 能区分这种回跳和真正的收竿,不会重复抛竿。玩家在游戏里操作鼠标或键盘时,程序自动让出控制,停手 5 秒后恢复。抛竿失败、认不出鱼竿或游戏退出时会自动停止,并提示具体原因。

此外还有系统托盘、游戏内浮层、自定义热键(默认 F6 开始/暂停)、自动更新(稳定版和测试版两个通道),以及中英文界面。

工作原理#

自动校准 自动甩竿两次,在手持鱼竿和快捷栏附近 选出两种状态差异最大的区域 收回 / 甩出模板 游戏画面 只截选定区域 每秒 15 次 鱼竿状态识别 与两张模板比较:收回 / 甩出 / 未知 随昼夜亮度变化自适应 游戏声音 WASAPI 进程环回 只录 Minecraft 咬钩检测 2–12 kHz 持续的宽频水花声 过滤鱼游近的短促声响与猫叫等有音调的声音 仅野钓模式 键鼠输入 低级钩子 玩家在游戏内操作时让出控制,停手 5 秒后恢复 状态机 甩竿 等待 收竿 异常时停止 并提示原因 右键 SendInput 仅前台时点击 moyu-core:纯算法,无 I/O,可用录像离线回放 moyu-win:截图、音频、输入等 Windows 平台层

鱼竿状态识别:校准时分别记录收竿和抛竿时的画面,在手持鱼竿和快捷栏附近滑窗,挑出两种状态差异最大的小区域,存为两张模板。运行时每秒截取该区域 15 次,判断当前画面离哪张模板更近;两张都不像时判为“未知”,例如打开了背包。判定阈值由校准数据算出,所以没有灵敏度滑块。

咬钩检测:通过 WASAPI 进程环回只采集 Minecraft 的声音,电脑上播放的音乐或语音通话不会产生影响。咬钩水花是一段 0.3 到 0.8 秒、铺满频带的宽频噪声,而鱼游近时的声响只有一两帧,因此判据是“持续变响”:约 85 毫秒内至少 6/8 的分析帧要同时高出底噪 12 dB,并超过一个绝对门槛。绝对门槛参照每次抛竿时测到的抛竿声音量,随游戏音量一起变化。猫叫、村民等生物叫声同样响且持续,但它们由一串谐波组成,程序为每帧计算音调性,把这类声音排除在外。

模拟点击:通过 Windows SendInput 模拟鼠标右键,默认只在游戏处于前台时点击。程序不读写游戏内存、不修改游戏文件,也不做任何注入。所有处理都在本地完成,除检查更新外不联网。

技术实现#

v0.1 是 Python + tkinter 写的原型,靠盯画面上的浮漂判断咬钩,效果依赖判定框和灵敏度的设置。v1.0 用 Tauri 2 + Rust 重写,画面识别改为看手持鱼竿的状态,咬钩改由声音判断。

Rust 工作区分为三层。moyu-core 包含识别算法和状态机,不依赖任何平台 API,也没有 I/O;moyu-win 是 Windows 平台层,负责查找窗口、截图、SendInput、进程音频环回和键鼠钩子;src-tauri 是桌面应用,管理服务线程、校准流程、SQLite 统计库、托盘、浮层和自动更新。界面使用 React + TypeScript + Tailwind。

由于 moyu-core 没有 I/O,识别算法可以用真实游戏录像反复回放。moyu-bench 命令行工具录制画面、声音和玩家的右键操作作为标注,离线评估鱼竿状态的准确率、两种状态的区分度,以及咬钩检测的召回率和误报数。在白天、夜晚和雨天的四段录像中,鱼竿状态识别准确率都在 99% 以上;旧的声音判据每 10 分钟误报 40 到 130 次,新判据在两段手钓录像中没有误报。

发布流程由 GitHub Actions 完成:推送版本 tag 后构建 NSIS 安装包,用 minisign 为更新包签名并生成更新清单。带预发布标记的版本只推送给测试版通道。

使用说明#

需要 Windows 10 2004 或更高版本,游戏需设为窗口化或无边框模式。安装包可从 GitHub Releases 下载,无需管理员权限。许多服务器禁止挂机钓鱼,使用前请先确认服务器规则。