异环工具箱

基于 MaaFramework 的异环自动化工具

完全以后台运行为目的开发，不用担心抢占窗口焦点和键鼠

模板自 MaaPracticeBoilerplate

点击 开始钓鱼 后进入钓鱼界面，启动该功能即可自动钓鱼

完全支持后台运行，响应很快，正常情况下100%不追踪丢

如果觉得卡、追踪会超出绿色范围，大概是电脑性能占用满了，把游戏画质调到最低即可解决

• 自动卖鱼买换饵

  • 关闭
    钓到饵用完或者渔获已满判断为完成
  • 开启
    一直钓，直到手动终止，卖鱼买换饵过程会抢占鼠标

• 其他设置

  详见程序内描述

游戏内先打开钢琴界面，GUI 选项中输入 MIDI 文件的路径，会读取第一个乐器，自动弹钢琴
（不输入 MIDI 文件路径，会从工作目录扫描 MIDI 文件）

解码 MIDI 文件依赖 music21
（安装并更新命令: python -m pip install -U music21）

仅使用键盘输入，完全支持后台运行

• 默认键盘输入 API （maafw API）
  乐谱节拍过快、单位时间内音符过多，会导致延迟超过拍的时间码
  即使单位时间内音符不多，拍内的音符与音符间也会有延迟

• 使用自定义的 WinAPI
  启用该选项能解决延迟问题

• 自动拾取 🧲

  自动判断可拾取物品并快速拾取，适合粉爪等需要按 F 拾取的场景

在 Release 中下载最新版本的压缩包

解压后即可使用

目前会自动打包 MFAA 和 MXU 两种 GUI，觉得哪个好用就用哪个

• MFAA

  启动时会自动判断 .NET 和 C++ 运行时
  若电脑中没有对应运行时，需按 GUI 给出的提示在微软官网下载或 GUI 自动下载

• MXU

  体积小，执行效率也比 MFAA 高
  如果觉得 MFAA 钓鱼时溜鱼跟随不及时，最好换用这个 GUI

打开文件夹内对应的 GUI 的 exe 文件（Windows）即可启动

因为要支持后台运行，所以必须以管理员身份运行，如果嫌每次都要右键exe麻烦，可以在属性里把该exe设为 以管理员身份运行此程序

仅支持游戏分辨率比例 16:9，内部缩放到 720p 处理，所以设置 720p 以上并不会提高识别精度

依赖 Python，自行安装 Python 3.14 或更高版本，Windows 用户安装时记得勾选添加到 PATH

需要安装 Python 包 maafw
（安装并更新命令: python -m pip install -U maafw）

如果发现 GUI 中任务执行到一半没有报错直接失败，那么大概是调用 Python 失败，检查是否正确安装 Python，Windows 用户需要检查是否将 Python 添加到了 PATH 环境变量

• 日志

  如果觉得 debug 文件夹体积太大、写入频繁，浪费硬盘，可在 config/maa_option.json 中将 logging 设为 false 以关闭日志（使用 全局设置 功能可以让程序修改这个选项）

  提交 issue 仍需要提交日志，所以遇到 bug 时需要打开日志，最好将 draw_quality 设为 100 以提交更清晰的报错自动截图

以下内容为开发者准备，普通用户不需要操作

拉取本仓库和子模块:
git clone --recursive https://github.com/op200/NTEToolbox.git

更新子模块（若有需要）:
git submodule update --init --recursive

子模块为 MaaCommonAssets，内含 OCR 模型文件

安装 Python 依赖:
使用任意包管理器安装 pyproject.toml 中的依赖

复制 OCR 依赖:
执行 tools/configure.py 文件