(Mar 26, 2024, 2.1 update: Scanner currently doesn't work since UI elements were moved in the latest HSR update. A new release will be released soon to address these changes.)

Download HSR Scanner beta v0.6.2

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.
• 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

• JSON Output:
  • New metadata dictionary for account UID and variant of Trailblazer.
    • uid: Int of length 9, or null if user chooses not to include it (uid will not by included by default).
    • trailblazer: Either Stelle or Caelus, determined automatically during the scan. Defaults to Stelle if no Trailblazer was parsed during the scan (or previous scans).
  • New build key which contains a string for the version of HSR-Scanner that generated the output (i.e. "v0.6.2").
• Log: Added log levels, force scroll-down during scan, and save log to disk if debug mode is enabled.
• Hotkeys: Allow more possible assignable keys for inventory and character hotkeys (like F-keys). #67

Fixes

• Equipped Location: Fix certain characters being wrongly assigned to relics and light cones on 1600x900 resolution.
• Character Scan: Prevent character scan from parsing the previous character's name if the name field doesn't re-render fast enough when clicking to the next character. #49
• Character Count: Tweaked image processing parameters in Data Bank screen to hopefully parse the total character amount properly. #66
• Substat Parsing: Tweaked substat OCR parameters for better accuracy on lower resolutions.

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.
   
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.