GenshinImpact AutoTrack DLL

November 26, 2023 · View on GitHub

这是英文，点击到中文

GenshinImpact AutoTrack DLL

DLL dynamic link library that obtains the character's position on the map from the Genshin Impact client through the image matching algorithm

GitHub version Build status convention platform

Precautions

  • This project uses window screenshots of the game screen to perform image processing algorithms to achieve all functions. It does not read or write the game memory, so there is no risk of account ban, but the effect also has certain limitations.
  • The project has only been tested under limited conditions. If you need to troubleshoot errors, it is strongly recommended to configure the environment as described below.
    • Genshin Impact client > Paimon in the upper right corner > Settings > Anti-aliasing, set to SMAA
    • Genshin Impact client > Paimon in the upper right corner > Settings > Others > Minimap lock, set to Lock direction

introduce

  • [Kong Ying Tavern Genshin Impact Manual Update/Testing Tutorial] (doc/kyjg.md)
  • Contact QQ group 717355752

New version plan 7.x

  • Added angle and field of view recognition in the secret realm
  • Realize field of view recognition without transparent channel
  • Implement log controllable non-output
  • Add inertial acceleration navigation algorithm for positioning (see giAlgorithmVerification library)
  • Add automatic calibration algorithm for positioning
  • Support any map area
  • Supports passing in maps instead of embedding them
  • Optional embedded precomputed results
  • Higher matching accuracy
  • Use binary files instead of xml serialization to track feature points
  • No longer embed precomputed results, the first run will generate cache xml in the run directory
  • Currently supports any resolution and controller mode, but the [Follow Perspective] of the minimap setting is not currently supported and only [Lock Direction] is supported.

how to use

  1. Download the compiled dynamic link library.
  2. After loading the dynamic link library, call or encapsulate the relevant functions according to [Function Directory] (#Function Directory).
  3. For calling some languages, please refer to the calling examples in the impl folder.
  4. Since the default interface outputs the coordinates of [Tianli Coordinate Model] (doc/天理坐标模型_en.md), the user needs to set the world center and scaling coefficient according to the mapping relationship between their own map coordinate system and the Tianli Coordinate Model. Or convert manually later.

How to compile (will switch to cmake build soon)

  1. Environmental requirements, Visual Studio 2019 + 、Opencv 4.5.0 static lib zip

  2. Install Visual Studio 2019+

  3. Create environment variables for the Opencv library. If you do not use environment variables, you need to manually modify the Additional Include Directory and Additional Library Directory of the cvAutoTrack project.

    $OpenCvDir = C:\projects\opencv\

  4. Download Opencv 4.5.0 static lib zip and extract it to any directory

    7z x ./*.zip -y -o%OpenCvDir%

  5. Clone code

    Git Clone https://github.com/GengGode/cvAutoTrack

  6. Enter the project folder and extract the resource files

    cd .\cvAutoTrack | 7z -x resource.zip

  7. Compile the project

    msbuild cvAutoTrack.sln

For developers

Project structure

  • cvAutoTrack, dll project
  • doc, documents and some illustrations
  • impl, calling examples in some languages
    • Cpp/TEST_cvAutoTrack_Cpp C++ call
    • CSharp/TEST_cvAutoTrack_CSharp C# call
    • Python Python call

Function Directory

Tianli coordinate model

Error handling

Special thanks to