Usage

Usage Guide

This guide covers how to set up your emulator and start using the RoK-Tracker scanners. For detailed information on the specific settings and capabilities of each scanner, please refer to the Scanner Options page.

Emulator Setup (Bluestacks 5)

For the most reliable experience, we strongly recommend Bluestacks 5. You must configure your emulator with specific settings for the OCR to read the screen correctly.

1. Display Settings:
   • Resolution: 1600 x 900
   • DPI: Custom (450)
2. Advanced Settings:
   • Android Debug Bridge (ADB): Turned On

Connecting to the Emulator

In the RoK-Tracker app, go to the Settings page:

1. Set the Bluestacks config path to your bluestacks.conf file (usually C:\ProgramData\BlueStacks_nxt\bluestacks.conf).
2. Ensure the Bluestacks instance name in the settings matches your emulator instance exactly.

---

How to Scan

Before starting any scan, please read these Important Rules:

• Language: Your game language must be set to English.
• Location: Your character must be in the HOME KINGDOM to get only your kingdom's ranks.
• Interference: Do not interact with the emulator while scanning is in progress. Avoid copying to the clipboard as it may interfere with the data capture.

1. Kingdom Scanner

The Kingdom Scanner captures detailed governor data.

• Preparation: Open the game and go to the top of the Power Rankings or Kill Points Rankings.
• Important: Your own account must rank lower than the number of players you want to scan!

2. Alliance & Honor Scanners

These scanners are faster and save governor names and scores.

• Preparation: Open the game and go to the top of the desired Alliance Leaderboard or Personal Honor Rankings.

3. Seed Scanner

A lightweight scanner for quickly capturing only kill points or power from the kingdom rankings. Works similarly to the Alliance scanner.

---

Output Formats

Scan results are saved to corresponding folders (e.g., scans_kingdom/, scans_alliance/). You can configure the output format in the app Settings:

• Excel (.xlsx): Full spreadsheet with all data.
• CSV (.csv): Comma-separated values for easy import into other tools.
• JSONL (.jsonl): One JSON object per line.