Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wormtql/yas
Blazingly fast Genshin Impact/Honkai: Starrail artifacts scanner
https://github.com/wormtql/yas
genshin-impact genshin-impact-scanner rust
Last synced: 3 months ago
JSON representation
Blazingly fast Genshin Impact/Honkai: Starrail artifacts scanner
- Host: GitHub
- URL: https://github.com/wormtql/yas
- Owner: wormtql
- Created: 2021-10-06T08:10:53.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-03-08T13:38:49.000Z (3 months ago)
- Last Synced: 2024-03-08T14:44:52.019Z (3 months ago)
- Topics: genshin-impact, genshin-impact-scanner, rust
- Language: Rust
- Homepage:
- Size: 50.1 MB
- Stars: 1,184
- Watchers: 12
- Forks: 181
- Open Issues: 40
-
Metadata Files:
- Readme: README.md
Lists
- awesome-genshin-impact - yas
- stars - wormtql/yas
README
# Yas
Yet Another Genshin Impact Scanner
又一个原神圣遗物导出器
## 介绍
基于SVTR（基本上是MobileNetV3_Small + Transformer）字符识别模型，使用原神字体对原神中会出现的字符串进行训练，达到更高的速度和更精确的结果。相比CRNN，SVTR可以达到更小的体积及更好的识别率
导出结果可以导入分析工具（例如 [莫娜占卜铺](https://mona-uranai.com/) ）进行配装或者其他计算
由于使用了 [Rust](https://www.rust-lang.org/) 进行编写，运行效率和文件体积都得到了很大的提升
### 相关资料
- [MobileNetV3](https://arxiv.org/pdf/1905.02244.pdf)
- [CRNN](https://arxiv.org/pdf/1507.05717.pdf)
- [SVTR](https://arxiv.org/pdf/2205.00159.pdf)
- [Transformer](https://proceedings.neurips.cc/paper/2017/file/3f5ee243547dee91fbd053c1c4a845aa-Paper.pdf)
### 识别模型
SVTR原文使用了多个Local/Global Mixing，其中Global Mixing就是Transformer层，而根据*PaddleOCR*的代码，其SVTR识别模型也并未完全遵照SVTR原模型，而是骨干网络 + Transformer的结构
*Yas*同样采用PaddleOCR的做法，即MobileNetV3_Small + Global Mixing，相当于将原RNN替换为Transformer。
## 使用
### Windows
- 打开原神，并切换到背包页面，将背包拉到最上面
- 下载单exe可执行文件，右键管理员运行
- 扫描过程中，鼠标右键终止
### Linux
- 首先请确保自己在x11下或者GNOME/Wayland下（其他wayland de下[会有很坏的性能](https://github.com/poly000/screenshots-rs/blob/d96dff76c5f5cbd849d80451f0df8f415f8e5f4b/src/linux/wayland_screenshot.rs#L109)）
- 用wine窗口化运行原神（或者全屏+虚拟桌面），打开圣遗物界面，拉到最顶
- 启动yas
- Alt+Tab切换到原神窗口，并且在鼠标变为十字后点击一下（还没做窗口聚焦），注意保证原神窗口整体在屏幕内
- 等待扫描结束。右键中止还没做
### 注意
- 默认4星以下圣遗物不扫描
- 不是所有窗口比例都支持，推荐16:9的分辨率（如1600x900, 1920x1080, 3840x2160)
- 扫描过程中不要对鼠标做任何操作
- 当前仅支持中文环境，若默认系统为非中文，请前往游戏设置界面修改Language为“简体中文”，否则无法读取原神窗口
- 当前仅支持键鼠作为控制设备，暂不支持手柄。
### 命令行使用
假设你知道如何使用命令行工具
查看选项
```shell
yas --help
```
只扫描五星圣遗物
```shell
yas --min-star=5
```
只扫描一行
```shell
yas --max-row=1
```
## 编译
在构建前，请确保安装`Git LFS`，并运行`git lfs pull`。否则[yas在运行时会使用错误的模型](https://github.com/wormtql/yas/pull/102#issuecomment-1375503803)。
```shell
# Linux下需要首先安装rustup以及mingw-w64，然后再安装对应的rust target，
# 构建到Linux需要 `libxdo` 和 `libxcb`
rustup default stable
rustup target add x86_64-pc-windows-gnu
cargo build --release --locked --target=x86_64-pc-windows-gnu
```
## 训练
[yas-train](https://github.com/wormtql/yas-train)
## 反馈
- Issue
- QQ群：801106595