Hysen Labs
Open-source project
Cyrexxis/RokTracker avatar
Cyrexxis

RokTracker

Open Source Rise of Kingdoms Stats Management Tool. Track TOP X Players of kingdom / alliance / honor leaderboard.

100 stars32 forksPythonMIT
01
DEEP OPEN-SOURCE ANALYSIS

RokTracker: scanning Rise of Kingdoms leaderboards

An open source stats scanner for Rise of Kingdoms that follows top players across kingdom, alliance, and honor leaderboards by reading the game through an Android emulator, then writes the results to a spreadsheet.

02
DEEP OPEN-SOURCE ANALYSIS

What it scans

RokTracker is an open source Rise of Kingdoms stats management tool that tracks top players in kingdom, alliance, and honor leaderboards. What ends up in the spreadsheet depends on what is scanned. Kingdom rankings include governor ID, name, power, kill points, kills by tier, dead troops, and resource stats, while honor and seed rankings keep name and score only.

03
DEEP OPEN-SOURCE ANALYSIS

Two install paths

There are two ways to use the scanner. Simple installation downloads the released executable and needs no Python. Advanced installation clones the source and runs with Python. Both routes require tessdata trained data, ADB platform tools, and a configured Bluestacks 5 emulator at a resolution of 1600x900 and DPI 450.

04
DEEP OPEN-SOURCE ANALYSIS

What version 6 changed

Version 6 came with breaking changes. The single config file was replaced with a folder containing multiple files for global settings, scanner presets, and GUI config, and version 5 configs are not compatible. Other changes include a unified scanner, more config options, UI positions moved into config files, and a new GUI with theme support.

05
DEEP OPEN-SOURCE ANALYSIS

Scanner modes

The kingdom scanner does a full kingdom ranking scan and includes wrong kill detection, which validates kills against kill points and saves suspicious items to a manual review folder with a warning logged. A kill reconstruction option is available. The ranking scanner covers full alliance, personal honor, and seed scans, with names noted as approximate due to a game limitation.

06
DEEP OPEN-SOURCE ANALYSIS

Config gotchas and help

Configuration requires setting the Bluestacks config location in the config file, and the instance name must match the Bluestacks instance. The README warns to always use forward slashes in the Bluestacks path fields, since raw backslashes cause a JSON parse error. Help lives on Discord, with rules about including the scanner log file when asking for help.

07
DEEP OPEN-SOURCE ANALYSIS

Editorial conclusion

The tool assumes you will run it against a Bluestacks 5 instance with specific screen settings, and the README is open about the quirks, from JSON-breaking backslashes to names that can only ever be approximate.

08
DEEP OPEN-SOURCE ANALYSIS

Official sources

09
Community notes

Community notes