两种模式#
AutoMoyu 是适用于 Windows 版 Minecraft 基岩版的自动钓鱼工具。它截取游戏画面识别手持鱼竿的状态,在鱼竿收回后自动重新抛竿。按使用场景分两种模式,都是全自动运行:
- 钓鱼机模式:配合游戏内的半自动钓鱼机使用,钓鱼机负责收竿,AutoMoyu 负责重新抛竿。
- 野钓模式:不需要钓鱼机,对着任意水面即可。AutoMoyu 通过声音判断咬钩,自动收竿再抛竿。

左:首页显示当前状态、本次钓获和动态记录;右:统计页汇总每日条数和上钩用时分布。
无需手动配置#
首次使用时,程序会自己抛竿两次完成校准,约 10 秒,不需要框选区域或调整阈值。校准结果按窗口尺寸保存,白天、夜晚和雨天都能用,昼夜过渡时也会随画面亮度自动调整。
在高延迟服务器上,服务器回弹会让刚抛出的竿在画面上跳回。AutoMoyu 能区分这种回跳和真正的收竿,不会重复抛竿。玩家在游戏里操作鼠标或键盘时,程序自动让出控制,停手 5 秒后恢复。抛竿失败、认不出鱼竿或游戏退出时会自动停止,并提示具体原因。
此外还有系统托盘、游戏内浮层、自定义热键(默认 F6 开始/暂停)、自动更新(稳定版和测试版两个通道),以及中英文界面。
工作原理#
鱼竿状态识别:校准时分别记录收竿和抛竿时的画面,在手持鱼竿和快捷栏附近滑窗,挑出两种状态差异最大的小区域,存为两张模板。运行时每秒截取该区域 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 下载,无需管理员权限。许多服务器禁止挂机钓鱼,使用前请先确认服务器规则。