Skip to content

HSR Scanner v1.0.0
Compare
Choose a tag to compare
@kel-z kel-z released this 27 Mar 05:45
· 7 commits to main since this release
v1.0.0
87c879b
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.

Download HSR Scanner v1.0.0

Notes

  • SPD substats have a hidden decimal place that the scanner cannot directly parse. As a result, reproducing your character's stats (such as on optimizer websites) will most likely have a lower SPD stat than what it displays in-game. This is not an issue with the scanner, but rather a limitation when obtaining substats through OCR.
  • HDR should be off to ensure OCR accuracy.
  • Certain dual monitor configurations can cause screenshots to capture incorrectly. If this is the case, try moving HSR to a different monitor before retrying the scan. In very rare cases, you may need to disconnect all external monitors.
  • Tested on 1920x1080 resolution. I don't have every light cone or character with their traces unlocked to test (in fact, i don't even play the game anymore. i'm just maintaining this for yall), so if something isn't being recorded properly such as a certain character's traces, let me know by creating an issue.

New changes

  • Minimum Character Level: Added a minimum character level filter to stop the character scan when it reaches a specified level.
  • Better Completion Feedback: Scanner window will be brought to front after the screenshotting phase. Once the OCR process is done, the taskbar icon will flash and a notification sound will be played.
  • Sort Substats: After scanning newly upgraded relics in the same session, substats will be sorted accordingly to keep it consistent with the ordering after HSR is relaunched.

Fixes

  • v2.1 UI Changes: Updated scanner coordinates for v2.1 UI changes.
  • 1366x768 Resolution: Allow 1366x768 resolution to proceed with scanning (Untested — there might be issues with navigation or scanning since it's not a true 16:9 resolution).
  • TesseractError: Fixed an error with the TESSDATA_PREFIX env variable if it already exists on the system. #75
  • NoneType Error: Catch rare NoneType error during template matching operations. Cause is still uncertain. #41

For known bugs or errors, please refer to the issues page.

Instructions

  1. Set game text language to English.
  2. Set in-game resolution to one that has an aspect ratio of 16:9 (e.g. 1920x1080, 1280x720).
  3. In Star Rail, look away from any bright colours. Yes, really. The inventory screen is translucent and bright colours can bleed through to make the text harder to accurately detect and recognize. Looking towards the ground usually works in most cases, as long as the right side of the screen is relatively dark. (Double-check by opening the inventory page and see if the item info on the right contrasts well with the background.) You can skip this step if you're only scanning characters.
    Dark background example
  4. Open the cellphone menu (ESC menu).
  5. Configure the necessary scanner settings in HSR Scanner.
  6. Start the scan.
  7. Do not move your mouse during the scan process.
  8. Once the scan is complete, some additional time may be required to process the data before generating the final JSON file output.

As of v0.3.0, the app's database is updated separately from this repo. If the database version doesn't match the latest game version, then the repo hasn't been updated yet and you will need to wait :)

Light cone data includes:

  • Name
  • Level
  • Ascension
  • Superimposition
  • Character that it is currently equipped on
  • Locked

Relic data includes:

  • Set name
  • Slot (Head, hands, body, feet, etc.)
  • Rarity
  • Main stat
  • Substats
  • Character that it is currently equipped on
  • Locked
  • Discarded

Character data includes:

  • Name
  • Level
  • Ascension
  • Eidolon
  • Skill levels
  • Traces unlocked

Example JSON export.

HSR-Scanner is not affiliated with, endorsed, sponsored, or approved by HoYoverse.

Assets 3