NateScarlet / auto-derby

🐎🖥《赛马娘》(ウマ娘: Pretty Derby)辅助脚本
MIT License
463 stars 106 forks source link
automation umamusume windows

auto-derby

version python Join the chat at https://gitter.im/auto-derby/community Conventional Commits

自动化养马

:exclamation: 脚本违反用户协议 请勿公开宣传
The script violates the user agreement, please do not publicize

FAQ

育成结果 Nurturing result

功能

使用方法

需求 DMM 版 和 python3.8

安装依赖

Shift + 右键 点击项目文件夹空白处 - 在此处打开命令窗口 在其中运行

py -3.8 -m pip install -r requirements.txt

启动

双击 launcher.cmd 可通过一个简单的 GUI 进行启动

或者手动调用模块:

py -3.8 -m auto_derby 工作名称

工作名称随便输入错误的名字会提示当前支持的工作

更新版本

用户数据默认储存在 data 文件夹下。

复制 data 文件夹到新版本项目文件夹即可继承数据。

问题反馈

通过 Github issues 提交反馈

启动器勾选 debug 时会在项目目录下生成相关调试信息,反馈时请将相关信息一同附上

反馈前请手动清理敏感信息(例如用户名、机器名)

launcher.log

启动器日志

auto_derby.log

运行日志,.1 .2 .3 后缀的文件为之前日志的备份

debug

调试数据,.1 .2 .3 后缀的文件夹为之前调试数据的备份。

last_screenshot.png 为脚本最后看到的游戏画面。 界面识别相关问题不要提供在出错后手动进行的截图。

log.jsonl 和 images 为网页日志内容和图片,可用 ./scripts/view_web_log.py 查看。 训练识别相关问题因为是异步处理的截图,光提供 last_screenshot 没有用。

贡献代码

PR 提到开发 (dev) 分支,CI 会自动跑测试。

一个 PR 只解决一个问题。

开发依赖在 dev-requirements.txt。

运行命令时候可用的环境变量见 .env.example,推荐用 godotenv 工具来执行命令。

如果 CI lint 阶段出错,运行 make format 应该能自动修复。

本地跑测试使用 make test

添加新图片模版后使用 make -C auto-derby/templates 生成索引。

限制图片模版位置使用 ./scripts/capture_template_position.py 或者用画图编辑。 画图编辑完后推荐运行 make -C auto-derby/templates {模版名称}.pos.png 来将图片转为 1bit 深度来减小体积。