Skip to content

HSR Scanner beta v0.5.2
Compare
Choose a tag to compare
@kel-z kel-z released this 07 Jan 03:44
· 79 commits to main since this release
v0.5.2
799ad41
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.

Download HSR Scanner beta v0.5.2

New changes

  • Future Trailblazer Support: Refactor Trailblazer key logic to auto-update for future Trailblazer variants.
  • More Logging: Added more log outputs.
  • (Developer) SRO Export Format: Updated substat value percentage format from "xx.y" to "0.xxy".
    • For Star Rail Optimizer (SRO) dev purposes. Otherwise, this format is currently unused as SRO is still in development.

Fixes

  • Default item level: Fix scan ending early if item level fails to parse (since it defaults to the lowest level, which would've immediately failed any minimum level filters).

Known issues with this release

  • On some combination of graphic setting and game resolution, the scanner will fail to template match Trailblazer which will crash the parser with a KeyError (since instead it would use the normal scan logic and scan the Trailblazer's name which would be the account name—which is not an in-game character name). #49
  • Welt's icon incorrectly matches to Caelus (Preservation) consistently. #51 Patched 1/18/2024
  • Relic levels can sometimes get scanned without the leading 1. #52
  • Character scan fails on databank screen on lower resolutions. #55

Instructions

  1. Set in-game resolution to one that has an aspect ratio of 16:9 (e.g. 1920x1080, 1280x720).
  2. 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
  3. Open the cellphone menu (ESC menu).
  4. Configure the necessary scanner settings in HSR Scanner.
  5. Start the scan.
  6. Do not move your mouse during the scan process.
  7. 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 :)

Notes

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

Light cone data includes:

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

Relic data includes:

  • Set name
  • Slot (Head, hands, body, feet, etc.)
  • Rarity
  • Main stat
  • Sub-stats
  • Character that it is currently equipped on
  • Locked/unlocked

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
Loading