Releases: kel-z/HSR-Scanner
HSR Scanner beta v0.5.1-pre1
This is a pre-release build. Click here for the latest release instead.
Currently testing:
- Export in SRO format (enable in Configure tab).
- Adjust substat value image coordinates (1280x720 is the bane of my existence).
HSR Scanner beta v0.5.0
Download HSR Scanner beta v0.5.0
New changes
- Substat Validation: Added a rudimentary substat validator.
- Checks if the substat value is a known possible value. Otherwise, log a warning.
- Checks if the number of substats makes sense given the relic rarity and level (e.g. it will give a warning if a +15 relic got parsed with zero substats).
- Faster Interrupt: Added more interrupt checks to stop scans faster during the beginning of a scan.
Fixes
- Substats Parsing: Redo OCR process for substats to address
5
getting parsed asS
. #39
Known issues with this release
- Welt equipped icon gets matched as Trailblazer. #43
- Some incorrect entries in substat lookup table. #42
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.
- For
Dan Heng • Imbibitor Lunae
, the character•
will appear as\u2022
in the JSON output. This is the Unicode representation of the character and is a normal behaviour when special characters are included in JSON. Most modern environments will automatically render\u2022
as•
when displaying or processing the JSON.
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/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
HSR-Scanner is not affiliated with, endorsed, sponsored, or approved by HoYoverse.
HSR Scanner beta v0.4.1
Download HSR Scanner beta v0.4.1
New changes
- [!!!] Erudition trace order: Swapped Erudition
stat_3
+stat_4
andstat_6
+stat_7
to make it consistent with trace order found in datamines.- As a result, incremented
version
in JSON output from2
to3
. - Also updated
source
in JSON output fromHSR_Scanner
toHSR-Scanner
to make it consistent with repo name.
- As a result, incremented
Fixes
- Light Cone Min Level/Rarity: Fixed outdated Light Cone sort options coordinates. #35
- Jingliu Traces: Adjusted Destruction
stat_3
andability_3
pixel coordinates. #36 - Relics (hotfix): Fix some relics failing to scan substats on resolutions lower than 1920x1080. #38
Known issues with this release
- Substat OCR is prone to reading "5" as "S" on resolutions lower than 1080p. Use 1920x1080 if possible, or change where you're standing in-game before starting the scan. Will try to improve consistency in the next release. #39
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.
- For
Dan Heng • Imbibitor Lunae
, the character•
will appear as\u2022
in the JSON output. This is the Unicode representation of the character and is a normal behaviour when special characters are included in JSON. Most modern environments will automatically render\u2022
as•
when displaying or processing the JSON. - Data validation is currently WIP. At the moment, it's possible for sub-stat values to be recorded that aren't possible in Star Rail. Mitigate this by following step two of instructions.
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/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
HSR Scanner beta v0.4.0
Download HSR Scanner beta v0.4.0
New changes
- Save Settings: Save settings between scanner instances #29.
Fixes
- Relic Level Output: Made adjustments to relic level coordinates to not include the plus symbol (remnant from early testing) which can cause anomalies.
Known issues with this release
- Outdated light cone sort coordinates #35.
- Jingliu's
stat_3
andability_3
trace might not get read #36.
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.
- For
Dan Heng • Imbibitor Lunae
, the character•
will appear as\u2022
in the JSON output. This is the Unicode representation of the character and is a normal behaviour when special characters are included in JSON. Most modern environments will automatically render\u2022
as•
when displaying or processing the JSON. - Data validation is currently WIP. At the moment, it's possible for sub-stat values to be recorded that aren't possible in Star Rail. Mitigate this by following step two of instructions.
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/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
HSR Scanner beta v0.3.2
Download HSR Scanner beta v0.3.2
New Changes
- Faster Scrolling Method: Reimplemented scrolling method for inventory scan. Instead of dragging up with the mouse, the scanner now uses scroll inputs.
- I don't have 1500/1500 relics or light cones to test if this edge case is handled correctly. If the new scrolling method fails in any way, create an issue.
- Chinese Server Compatibility: Scanner now detects Chinese game window name #24 (The scanner will still only work with English text).
Fixes
- Equipped Icon Recognition: Made adjustments to the equipped icon coordinates to fix an issue where some characters were being incorrectly identified (For example, Silver Wolf was being recognized as Lynx on lower resolutions).
- Character Level: Made adjustments to the character level coordinates to fix level 1 being scanned as level 17.
Known Issues
- 11/27/2023: Level 5 relics might get scanned as level 45 (the plus sign next to the relic level gets mistaken as a 4). Will be fixed next release.
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.
- For
Dan Heng • Imbibitor Lunae
, the character•
will appear as\u2022
in the JSON output. This is the Unicode representation of the character and is a normal behaviour when special characters are included in JSON. Most modern environments will automatically render\u2022
as•
when displaying or processing the JSON. - Data validation is currently WIP. At the moment, it's possible for sub-stat values to be recorded that aren't possible in Star Rail. Mitigate this by following step two of instructions.
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/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
- Eidelon
- Skill levels
- Traces unlocked
HSR Scanner beta v0.3.1
Download HSR Scanner beta v0.3.1
New Changes
- Image Pre-Processing: Fine-tuned image pre-processing overall to further reduce likelihood of OCR errors, especially at lower resolutions.
- Scanner Delay Adjustment: Scanner delay time has been adjusted for a noticeably faster scan.
Fixes
- 1280x720 Resolution: Fixed an issue with OCR failing on the resolution of 1280x720. Note that setting the game to a resolution lower than this is not recommended.
Known Issues
- Link Rope and Planar Sphere values swapped incorrectly #25. Patched 11/08/2023.
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.
- For
Dan Heng • Imbibitor Lunae
, the character•
will appear as\u2022
in the JSON output. This is the Unicode representation of the character and is a normal behaviour when special characters are included in JSON. Most modern environments will automatically render\u2022
as•
when displaying or processing the JSON. - Data validation is currently WIP. At the moment, it's possible for sub-stat values to be recorded that aren't possible in Star Rail. Mitigate this by following step two of instructions.
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/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
- Eidelon
- Skill levels
- Traces unlocked
HSR Scanner beta v0.3.0
Download HSR Scanner beta v0.3.0
New Changes
- Optimized OCR Model: Now uses an OCR model trained on
DIN Alternate Bold
for improved recognition. - Remote Game Data Pulling: Game data is now pulled remotely on app launch, so app no longer has to be re-downloaded after each patch.
- JSON Output Changes:
- Raised
version
value to2
. - Revised relic keys to not include "Key" suffix. (e.g.,
setKey
→set
,mainStatKey
→mainstat
). - Changed value
Imbibitor Lunae
→Dan Heng • Imbibitor Lunae
.- Note: The character
•
will appear as\u2022
in the JSON output. This is a Unicode representation of the character and is a normal behaviour when special characters are included in JSON. Most modern environments will automatically render\u2022
as•
when displaying or processing the JSON.
- Note: The character
- Changed slot value
Hand
→Hands
.
- Raised
- Hotkey Configuration: Added a configure tab to customize hotkeys for inventory/character screen.
- Codebase Refactoring: Improved code structure and readability.
Fixes
- Interrupt Scan: Stop "Enter" key listener in the processing stage.
- Eidolons: Fixed unactivated eidolons being considered as activated.
Known issues
- 1280x720 Resolution: Relic main stat doesn't get processed on smaller resolutions (defaults to
HP
). Fix will come out soon after I check if this happens to other stats as well.
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.
- Data validation is currently WIP. At the moment, it's possible for sub-stat values to be recorded that aren't possible in Star Rail. Mitigate this by following step two of instructions.
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/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
- Eidelon
- Skill levels
- Traces unlocked
HSR Scanner beta v0.2.3
New changes
-
Fix typo
eidelon
->eidolon
(can't believe I didn't notice until now). - Update game data for v1.3 (and 1.4).
- Dan Heng • Imbibitor Lunae will have the key
Imbibitor Lunae
.
- Dan Heng • Imbibitor Lunae will have the key
- Fix character scan failing to start due to battle pass ending which moves the Data Bank button.
- Character scanner now drags to next page instead of using (now defunct) toggle list method.
- Fix buggy output for E3 Kafka.
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.
- Data validation is currently WIP. At the moment, it's possible for sub-stat values to be recorded that aren't possible in Star Rail. Mitigate this by following step two of instructions.
Exports light cone, relic, and character data up to Honkai: Star Rail v1.2
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
- Eidelon
- Skill levels
- Traces unlocked
HSR Scanner beta v.0.2.2
New changes
- Fix incorrect body and feet slotKey for Hunter of Glacial Forest set
Notes
- EDIT (8/27/2023): character scan currently fails because menu UI suddenly changed (probably because of battle pass ending).
- 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.
- Trace level OCR is not as perfect as I want it to be (it sucks at reading basic attack level "1/6"), but otherwise it should be in a very usable state.
- Data validation is currently WIP. At the moment, it's possible for sub-stat values to be recorded that aren't possible in Star Rail. Mitigate this by following step two of instructions.
Exports light cone, relic, and character data up to Honkai: Star Rail v1.2
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
- Eidelon
- Skill levels
- Traces unlocked
HSR Scanner beta v0.2.1
New changes
-
***!!! Fixed typo in traces output (skill_# -> stat_#) to match intended output in README.
- Added
source
andversion
key to root of JSON output. - Added Kafka to character list.
- Added missing 1.2 relic 4-sets.
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.
- Trace level OCR is not as perfect as I want it to be (it sucks at reading basic attack level "1/6"), but otherwise it should be in a very usable state.
- Data validation is currently WIP. At the moment, it's possible for sub-stat values to be recorded that aren't possible in Star Rail. Mitigate this by following step two of instructions.
Exports light cone, relic, and character data up to Honkai: Star Rail v1.2
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
- Eidelon
- Skill levels
- Traces unlocked