sumpler / zenlesszonezero-auto

绝区零 | ZenlessZoneZero | 零号空洞 | 自动化 | 图片分类 | OCR识别 | zzz | 图像分类

绝区零 零号空洞自动化框架2.1

当前项目处于开发阶段，正在开发零号空洞的自动化操作，可能会有很多问题，欢迎大家提出PR，一起完善这个项目。

本项目仅提供学习交流使用，如果觉得本项目做的不错，可右上角送作者一个Star

！！！本项目开源免费，如果您遇到任何收费情况都属于被他人欺骗

目录：

1. 项目简介
2. 使用说明
3. 安装教程
4. 安装教程-懒人版
5. 运行报错解决办法
6. 快捷键说明
7. 事件BUG说明
8. 后台运行
9. 免责声明

项目简介

绝区零 零号空洞自动化框架是一个基于Python3.10的自动化框架

本项目基于图像分类、模板匹配、OCR识别进行地图全局自动寻路和事件处理，不涉及任何游戏内部数据的修改，不会对游戏内部数据造成任何影响。

本项目的当前目标是可以让玩家从每周长时间的零号空洞材料刷取中解放出来，只需要在电脑上挂着就可以自动完成。本项目后续也会继续考虑增加其他自动化操作，帮助玩家做到日常托管。

2.1优化内容：

1. 模式选择增加了业绩银行一起的选择
2. 战斗模块独立出来，增加了连携技的判定，当前战场角色的判断
3. 新增了部分角色的战斗逻辑，战斗期间会根据需要调用对应逻辑
4. 降低了搜索路径时部分格子误判的概率
5. 修复bug若干

2.0优化内容：

1. 更改走格子自动寻路逻辑，对高难度地图进行了一定的适配，通关模式会优先寻找一个队友应对boss战斗
2. 运行模式增加零号银行的存款模式，方便刷去零号银行积分
3. 增加炸弹功能(会炸掉遇到的第一个敌人，是否解锁炸弹需要在参数配置里更改，默认解锁)
4. 增加战斗地图寻路(在需要跑图的地图会自动寻怪，注意:寻路主要针对旧都列车进行优化，其他地图依旧有概率撞墙)
5. 战斗增加闪避弹反判定
6. 战斗新增DIY战斗逻辑功能，可在配置文件里自己设计战斗逻辑伪代码(项目提供一套默认的战斗逻辑)
7. 鸣徽选择增加自定义类型选择(配置参数里可进行修改)

如有疑问，或者遇到bug，请到Issues提交问题，让遇到类似问题的朋友可以有地方找到相应的解决方案（常见问题可能可以帮助解决部分疑惑）

QQ群985508983

使用说明(前置条件)

请先打开游戏，进入零号空洞界面后，再运行脚本

1、脚本说明

本脚本主要适用于零号空洞每周五次委托奖励和零号业绩的刷取，每周五次通关后可以将脚本改成只刷零号业绩，拿到零号业绩就可以跑路。练度够的话推荐刷旧都列车前线，目前测试下来最快。

目前脚本适配性最好的地图是旧都列车，自动刷取建议选择旧都列车，低难本基本测试没问题，刷取每周五次委托奖励和零号业绩基本够用了。高难度副本目前支持内部和腹地，核心难度开发者练度不够目前打不过，数据集不全，模型识别可能会有问题，等后面开发者等级高了会继续进行测试。

视频演示：内部通关

视频演示：零号业绩速刷

2、游戏内设置说明(下面几项严格按照要求来)

如果脚本运行出现问题，请严格按照推荐游戏设置设置游戏画面！

1. 设置->输入->棋盘镜头移动速度->1
2. 设置->画面->显示模式->1280*720窗口
3. 设置->键鼠设置->角色切换下一位->Space(战斗场景下的切人按键必须是Space)
4. 脚本运行会占用键盘鼠标，在使用时不要操作键盘鼠标
5. 脚本运行前游戏界面置于零号空洞副本选择界面
6. 帧率设置为60帧，刷拿命验收的时候必须是60帧，否则会出现问题
7. 显示屏防蓝光关闭，HDR也要关闭，否则影响截图做模板匹配
8. 显示屏缩放比例设置为100%
9. 目前脚本只支持游戏语言设置为简中，暂未对其他语言进行适配

3、配置文件说明

1. 将项目文件夹下的config.example.yaml复制一份重命名为config.yaml文件

   参照config.example.yaml文件中的注释说明进行配置config.yaml文件的参数

   #ZoneMap = {
   #    1: {
   #        "name": "旧都列车",
   #        "level": {1: "外围", 2: "前线", 3: "内部", 4: "腹地", 5: "核心"},
   #    },
   #    2: {
   #        "name": "施工废墟",
   #        "level": {1: "前线", 2: "内部", 3: "腹地", 4: "核心"},
   #    },
   #}
   
   # 模型训练集大部分来自旧都列车，脚本刷图目前旧都列车最稳定，其他图bug会比较多，刷零号业绩旧都列车前线最快，练度够可以直接刷前线
   targetMap:
       level: 1                # 默认等级 1: 外围
       zone: 1                 # 默认区域 1: 旧都列车
   modeSelect: 1               # 模式选择 1: 全通关  2: 刷零号业绩  3：零号银行
   maxFightTime: 300           # 最大战斗时间，单场战斗时间默认为150s，超过150s会重开(部分战斗场景需要跑图，目前还没进行相关处理，遇到这种情况会退掉重开)
   maxMapTime: 1500            # 在地图内最大时间默认为900s，超过最大时间未通关地图会重开
   hasBoom: True               # 是否解锁炸弹
   useGpu: True                # 是否使用GPU，默认True, 使用GPU会加速模型训练,如果改为False，会强制使用CPU进行OCR识别
   selBuff: ["冻结", "暴击", "决斗", "闪避"]       # 鸣辉选择

2. 将项目文件夹下fight/tactics_defaults下的所有文件复制到fight/tactics文件夹下。

   该项目下为战斗逻辑的默认伪代码设计，玩家可以根据自己的需求自行设计伪代码，后续会整理伪代码设计规则供玩家进行DIY

   默认.yaml为默认战斗逻辑，此外，玩家可自定义人物战斗逻辑，目前仅支持艾莲、莱卡恩、苍角。

   红光.yaml和黄光.yaml为红光和黄光判定后的动作逻辑，玩家也可自行编辑。

   此外，玩家甚至可以自定义人物技能施放逻辑，参考艾莲技能.yaml。普通模块每执行2次后，便会执行一次技能模块。

3. 以管理员权限打开shell后运行main.py文件（脚本必须以管理员权限运行）

python main.py

安装教程

本项目提供通过conda创建安装环境的使用说明(有能力的可以通过其他方式部署项目，本项目不再做详细说明)

1. 下载本项目

   git clone https://github.com/sMythicalBird/ZenlessZoneZero-Auto.git
   cd ZenlessZoneZero-Auto

2. conda安装相关依赖

   ！！！ GPU版本和CPU版本二选一，GPU版本使用前提是你的电脑上使用的是Nvidia显卡

   详细安装教程:Conda环境配置说明

   安装视频演示:Conda环境配置演示

3. 环境配置好后，输入

   python main.py

安装教程(纯小白，或依赖懒得自己动手配置)

演示视频：start一键安装启动

1. 通过本页面上方绿色的Code-DownloadZIP直接下载解压文件并解压
2. 在云盘下载启动器，链接：start.exe | start.exe备用链接 | start.exe备用链接2
3. 将下载好的启动器放置到项目目录下(ZenlessZoneZero-Auto)
4. 在项目目录下以管理员权限运行start.exe
5. 第一次运行时请等待一段时间，等待Python环境安装
6. 选择1安装环境需要的依赖(第一次运行时选择，安装完依赖就不需要再选了)
7. 选择2运行脚本(第一次运行需要下载模型文件，需要等待一段时间)

运行报错解决办法

1、出现ImportError: DLl load failed while importing onnxruntime_pybindl1_state:动态链接库(DLL)初始化例程失败，

如果之前安装过CUDA

pip uninstall onnxruntime-gpu
pip install onnxruntime-gpu==1.17

如果没安装过CUDA，或者更换onnxruntime-gpu版本无效，则更新Microsoft Visual C++ 可再发行程序包

快捷键说明

F10  恢复运行
F11  暂停运行
F12  结束运行

事件BUG说明

遇到脚本无法处理的事件可以截图上传至2.0测试版本异常事件汇总 ，截图使用链接提供的截图工具，截取图片后发在问题下的评论区，开发者看到会进行处理

后台运行

！！！提醒：远程桌面部署比较麻烦，仅适用于部分有计算机基础和动手能力的同学使用，小白不推荐使用

后台运行的功能实现是通过新建另外的用户，然后新用户远程桌面连接到本地，在远程桌面运行脚本。

非Server版本的Windows系统默认是不支持多用户同时远程桌面的，所以需要进行一些设置，具体设置方法请参考

Windows多用户同时远程本地桌面

免责声明

本软件是一个外部工具旨在自动化绝区零的游戏玩法。并遵守相关法律法规。该软件包旨在减少用户游戏负担,并且它不打算以任何方式破坏游戏平衡或提供任何不公平的优势。该软件包不会以任何方式修改任何游戏文件或游戏代码。

This software is an external tool designed to automate ZenlessZoneZero's gameplay. and comply with relevant laws and regulations. This package is designed to provide simplicity and user interaction with the game through features, and it is not intended to upset the balance of the game in any way or provide any unfair advantage. This package does not modify any game files or game code in any way.

本软件开源、免费，仅供学习交流使用，禁止用于商业用途。开发者团队拥有本项目的最终解释权。使用本软件产生的所有问题与本项目与开发者团队无关。若您遇到商家使用本软件进行代练并收费，可能是设备与时间等费用，产生的问题及后果与本软件无关。