search

akrios-d / AkashaScanner

A Genshin Impact tool to export achievements, characters, artifacts, and weapons.
MIT License
14 stars 0 forks source link

readme

Mantainer Note - Release for genshin 5.0(10/Sep/24)

I will be keeping up this tool doing some bugfix/enhancements, feel free to contribute or report bugs!

This tool use hoyowiki to keep up to date, currently, The endpoints for new characters return some data that are used to parse the characters as empty, therefore, not being able to retrieve this data and scan for it. I'll be looking for a new solution to this and do a new release as soon is possible.

e.g. with Mualani: https://sg-wiki-api-static.hoyolab.com/hoyowiki/wapi/entry_page?entry_page_id=6319 objects inside filter_values is empty and for that reason, not able to parse this date.

Akasha Scanner

A Genshin Impact tool that extracts your account data, including achievements, characters, artifacts, and weapons.

Demo video for achievement scanning

Table of Contents

Features

Note

This project is currently in beta. It is useable right now, but future changes may invalidate your existing scanned data.

Getting Started

Download the latest version of the Akasha Scanner here and unzip its files.

You need Genshin Impact installed on your computer. You will also need to install Microsoft Visual C++ Redistributable (Direct download link)

To launch the program, open AkashaScanner.exe. It will ask for Administrator permissions, which is required to take control of the game.

A few important settings:

  1. Game language must be English
  2. The game window should not be wider than 16:9 and not smaller than 1280x720
  3. During the scan, the entire game screen should remain visible (no off-screen portion, and nothing covers the game window)
  4. Turn off any color filters, such as Reshade, Windows Night Light, F.lux, Nvidia Filters, and Color-blind tools that you may be running

Usage

Select a scanner from the left menu. You can follow the instructions on the page to start scanning.

Do not use your mouse or keyboard while scanning. The scanner uses mouse and keyboard input to automate the scanning.

If you want to interrupt the scan, you may minimize or exit the game using hotkeys like Alt+Tab or Win+D. If you interrupt the scan, keep in mind that all progress will be lost.

FAQ

Why is it called Akasha Scanner?

This project aims to provide a way for players to extract data from the game and share them with other tools, which resembles an in-game device that transfers and shares information.

Will I get banned by the game from using the Akasha Scanner?

Probably not, according to this official article.

In addition, similar software like the Inventory Kamera and AdeptiScanner-GI have been around for a while, and no one has been banned from using these applications.

However, there is no guarantee that HoYoverse will not take any actions against the scanner. Use at your own risk.

How does the Akasha Scanner work?

It uses mouse and keyboard inputs to navigate through your achievements/characters/inventory, and take screenshots of them.

There are a couple of techniques used to analyze the screenshots. The first is known as Optical character recognition (OCR) using Tesseract. It is mainly used to identify text from images. For example, the names and levels of weapons/artifacts/characters are identified this way.

Other things like counting the number of stars of achievements/artifacts use object recognition provided by OpenCV.

How reliable are the scan results?

I would say it is currently pretty accurate, but it is not perfect.

For example, identifying the number 1 is quite tricky for the OCR, particularly in characters' talent levels. Also, random snowflakes covering the character's name and level can mess up the OCR.

Using a higher resolutions would greatly increase the accuracy. I personally uses 1920x1080, and it is working quite well for me.

Can I edit the scan result if it is inaccurate?

I will work on this shortly. Stay tuned for a new release!

For now, you can modify the JSON file under the ScannedData folder. I may consider writing a document about the JSON file schema, though I think they are pretty self-explanatory.

How do I import the scan results to Paimon.moe/Seelie.me?

First, export your scan results to a format compatible with Paimon.moe/Seelie.me using the Akasha Scanner. Then, go to Paimon.moe or Seelie.me. Select "Export & Import Data" and import the file you just exported.

I have other questions

You may want to check this out and search for answers. If you don't find any, please feel free to start a new discussion. :)

Roadmap

The following is just a to-do list for me to follow.

Contributing

All contributions are welcome!

Reporting Bugs

If you run into any weird behavior while using the Akasha Scanner, feel free to open a new issue in this repository. Please run a search before opening a new issue, to make sure that no one has already reported or solved the bug you found.

Please provide as much information as possible, for example log files (under the Logs directory), your system configurations (game window resolution and your monitor resolution) and/or screenshots of your game (make sure you erase your UID in the bottom right corner!)

Submitting Pull Requests

All pull requests are greatly appreciated. You may want to take a look with opened issues if you are looking for somewhere to start.

I am also not very experienced with C# and .NET Core (in fact, this is my first time writing in C#). So if I did anything stupid, please kindly point it out.

(Also I need help fixing my English >.<)

Acknowledgements

Shout out to Inventory Kamera for inspiring the work.

License

License: MIT