Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hanmin0822/raphaelscripthelper
一个用于快速编写游戏脚本的Python框架，适用于诸如明日方舟等各种平台的游戏
https://github.com/hanmin0822/raphaelscripthelper
adb arknights game helper opencv python roguelike-game script simulator
Last synced: about 1 month ago
JSON representation
一个用于快速编写游戏脚本的Python框架，适用于诸如明日方舟等各种平台的游戏
- Host: GitHub
- URL: https://github.com/hanmin0822/raphaelscripthelper
- Owner: hanmin0822
- License: apache-2.0
- Created: 2022-01-18T13:57:11.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2022-02-08T12:48:29.000Z (almost 3 years ago)
- Last Synced: 2024-12-10T04:10:22.824Z (about 1 month ago)
- Topics: adb, arknights, game, helper, opencv, python, roguelike-game, script, simulator
- Language: Python
- Homepage:
- Size: 811 KB
- Stars: 193
- Watchers: 2
- Forks: 44
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
RaphaelScriptHelper 拉斐尔脚本助手
～轻松编写更智能的游戏脚本～
> **警告：本项目仅作学习交流用途，禁止将本项目中的任何脚本、工具用于任何非法用途，如果使用本项目中的任何脚本、工具造成游戏被封号、处罚等一切损失需自行承担后果，本项目对此概不负责！**
> 请注意：使用脚本会在一定程度上影响游戏体验，请根据自身需求使用。
本项目的命名取自轻小说[《关于我转生变成史莱姆这档事》](https://mzh.moegirl.org.cn/%E5%85%B3%E4%BA%8E%E6%88%91%E8%BD%AC%E7%94%9F%E5%8F%98%E6%88%90%E5%8F%B2%E8%8E%B1%E5%A7%86%E8%BF%99%E6%A1%A3%E4%BA%8B)中主角 利姆鲁·特恩佩斯特（リムル・テンペスト） 进化成魔王后持有的究极技能之一 智慧之王（拉斐尔） ，拉斐尔具有接管主角意识并代打的能力，这很像使用本项目来帮助我们完成一些重复繁琐的流程。~~所以说本项目也可以帮助你成为萌王？(误)~~
[演示视频](https://www.bilibili.com/video/BV1RZ4y1f76m/)
## 简介
RaphaelScriptHelper (拉斐尔脚本助手/拉斐尔模块) 是一个基于openCV图像处理、OCR、ADB等技术的Python框架，可以让脚本编写者在短时间内编写出一个实用的游戏脚本，适用于可以支持脚本运行的各种系统及模拟器，支持诸如识图、点击、按键、滑动、文字识别、随机操作等功能。一个实用的例子是几行代码编写一个简单的明日方舟日常刷图脚本（见演示视频）。
## 目前可以直接使用的脚本
* [明日方舟集成战略模式（肉鸽）脚本](https://github.com/hanmin0822/RaphaelScriptHelper/blob/master/Arknights/ArknightsRoguelike.py)
* [明日方舟日常刷图脚本](https://github.com/hanmin0822/RaphaelScriptHelper/blob/master/Arknights/Arknights_default.py)
> 请注意：请仔细阅读各脚本最上方的注释说明再使用。
欢迎大家编写更多好用的脚本并提PR到本项目中来哦～
## 环境配置
Python 3.7
使用到的Python库
```
numpy=1.19.5
opencv-python=4.5.1.48
```
ADB套件请在[这里](https://pan.baidu.com/s/15dpjviyIHezaT56knux2xQ?pwd=mr5p)下载并解压放置到脚本框架根目录
## 快速上手
使用一行代码来引入 RaphaelScriptHelper
```python
import RaphaelScriptHelper as rsh
```
使用一至两行代码来指定脚本运行的设备
```python
rsh.deviceType = 1 #0为PC环境，1为安卓设备
rsh.deviceID = "安卓设备ID" #如使用安卓设备，请填写
```
使用一行代码来模拟点击屏幕，会自动在一定范围内随机偏移、随机时长（防作弊检测）来点击一次
```python
rsh.touch(pos)
```
使用一行代码来模拟点击屏幕上指定区域，先使用[选择工具](https://github.com/hanmin0822/RaphaelScriptHelper/blob/master/FunctionDoc.md#%E6%A0%87%E7%82%B9%E6%88%AA%E5%8F%96%E5%B7%A5%E5%85%B7%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E)来指定区域并保存，方便后续识别，会自动在识别区域内任意点、随机时长（防作弊检测）来点击一次
```python
rsh.find_pic_touch("./test.png")
```
## 详细功能
请参阅[详细功能使用手册](https://github.com/hanmin0822/RaphaelScriptHelper/blob/master/FunctionDoc.md)
## 注意事项
* 本项目仅作学习交流用途，禁止将本项目中的任何脚本、工具用于任何非法用途，如果使用本项目中的工具造成游戏被封号、处罚等概不负责
* 针对识图功能，不会改变欲识别图片的大小，而是直接用这张图片去比对，因此如果存在被查找图片中找不到欲识别图片的情况，请先检查分辨率是否正确，然后再调节可信度阈值以达到效果
## TODO
* 支持PC端截图、键盘鼠标智能模拟
* 支持在线/离线OCR
* 增加GUI界面支持可视化编写流程