Mufanc
Genshin-SmartFishingRod
Python

原神⭐钓鱼辅助工具 | 自动收竿、校准游标

Last updated Jul 3, 2026
281
Stars
21
Forks
4
Issues
0
Stars/day
Attention Score
34
Language breakdown
Python 99.0%
Batchfile 1.0%
Files click to expand
README

原神钓鱼辅助工具 v3.1.1

「您只需抛出鱼竿,然后我们会帮您搞定一切」

>
* 如果你觉得这个脚本好用,请点一个 Star⭐,你的 Star 就是作者更新最大的动力
  • 感谢 @hgjazhgj 提供使用 Alpha 通道的思路
  • 感谢 @SwetyCore 开发的无需管理员权限版本

效果展示

演示视频:

✨欢迎大家在 Issues 中分享自己的配置文件✨

✨也祝各位早日钓到精五鱼叉✨

更新内容(返璞归真?):

  • 使用一些 Unity 命令行参数强制游戏以 1600x900 启动,在牺牲一部分游戏体验的情况下极大提升了检测准确度

这个脚本有什么特色?

  • 直接在游戏画面上通过叠加层显示信息,直截了当,便于调试
  • 使用相对距离定位进度条,不会因为 ui 布局变化而影响检测效果
  • 当配置文件正确时,拥有接近 100% 的检测准确率
  • 可使用快捷键直接对选区截图,方便您构造自己的配置文件

使用教程:

  • 首先确保你的抗锯齿设置为 SMAA

方式一:下载

💡 Release 版本(v3.1.1)现已发布,下载后直接解压即可使用,点击这里 跳转到下载页
>

方式二:手动通过代码运行

  • 首先下载项目代码到本地
git clone https://github.com/Mufanc/Genshin-SmartFishingRod.git
cd Genshin-SmartFishingRod
1. 直接以 1600x900弹出式窗口(启动参数加上 -popupwindow)启动游戏,然后启动脚本
>
2. 或将 configs.yml 中的 game-executable 选项修改为你的游戏程序路径,然后启动脚本
>
2. 在终端中执行 python main.py(脚本会自动申请管理员权限)
>
3. 选择合适位置抛下鱼竿,脚本会自动完成钓鱼

快捷键

  • Alt + .
隐藏 / 显示叠加层(隐藏后仍可自动钓鱼)
  • Alt + 小键盘【1-9】
按叠加层上框定的区域对游戏进行截图,善用此功能可以很方便地创建自己的模板文件
  • Alt + 小键盘 0
弹出一个窗口,其中标识了识别区域和结果,方便 debug

关于 detects.yml

  • 该配置文件中存储着一些图片检测和坐标查找相关的选项:
templates:
  - name: button
    rect: { left: 0.83, top: 0.88, right: 0.13, bottom: 0.03 }  # 识别区域
    threshold: 0.95
    template: button.png

- name: hook rect: { left: 0.49, top: 0.1, right: 0.49, bottom: 0.76 } threshold: 0.6 template: hook.png

progress: # 进度条的相对宽高 width: 0.26 height: 0.028

# 进度条中心点到鱼钩图案中心点的高度 offset: 0.052

# 其它设定 frame-color: [ 192, 255, 255 ] # BGR threshold: 0.035 sp: [ 6, 18 ]

templates

描述了所有用于匹配的模板图片信息,其中每个元素的属性解释如下:

  • name
该模板图片的名称
  • rect
描述方式类似 css 中的 position: fixed,指定一个待识别的区域,其 rect 属性中按比例存储了区域的位置信息,比如游戏画面的左上四分之一范围可以表示为:
rect: { left: 0, top: 0, right: 0.5, bottom: 0.5 }
  • threshold
置信度阈值,当区域内最优匹配与模板相似度不小于此阈值时,认为匹配成功
  • template
模板图片的文件名,注意模板图须放在模板文件夹下的 images/ 文件夹下。该属性为非必须指定,当不指定时,脚本仅在游戏画面上标注对应区域以供使用快捷键截图,并不会做任何匹配

progress

  • widthheight
描述进度条的宽度和高度,均为关于游戏画面大小的相对表示(例如 width: 0.5 就是画面的一半宽)
  • threshold
当游标在滑框内的位置达到此阈值后不再点击鼠标,可根据目标鱼种适当调整
  • offset
进度条中心与「鱼钩」图标的相对距离
  • frame-color
游标和滑框的主要颜色,注意是按 BGR 表示
  • sp
一个二元数组,设某一横坐标 x 下 y 轴方向 frame-color 颜色像素数目为 n,则当 sp[0] <= n < sp[1] 时,认为这是滑框的左边界或右边界,而当 n >= sp[1] 时,则认为该位置是游标。用截图工具截图并设法放大计数,便可得到 sp 的最佳取值

无法使用 Alpha 模式时的一些调用技巧

  • 将右下角检测上钩的区域置于水面偏蓝绿色背景上,检测鱼钩图样的黄色方框置于偏深色背景上,有助于提高检测效果
  • 如果在雪山、踏鞴砂等特殊钓点出现无法自动收竿的情况,请尝试更改阈值或使用针对性的匹配图样

声明和警告

  • 脚本需要管理员权限是因为游戏以管理员权限启动,若无管理员权限则无法模拟鼠标动作
  • 脚本并未修改游戏内存及文件数据,而是类似连点器这样使用 PostMessage 向窗口发送鼠标事件,但仍然存在被检测到的可能,如果你很担心被封号,请不要使用该脚本
🔗 More in this category

© 2026 GitRepoTrend · Mufanc/Genshin-SmartFishingRod · Updated daily from GitHub