https://github.com/rokmonster/ocr

OCR Engine for Rise Of Kingdoms
https://github.com/rokmonster/ocr

game golang-application lilith ocr ocr-recognition rise-of-kingdoms riseofkingdoms

Last synced: 6 months ago
JSON representation

OCR Engine for Rise Of Kingdoms

• Host: GitHub
• URL: https://github.com/rokmonster/ocr
• Owner: rokmonster
• License: gpl-3.0
• Created: 2022-02-13T17:35:15.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2025-11-29T11:22:32.000Z (7 months ago)
• Last Synced: 2025-12-01T12:49:04.939Z (7 months ago)
• Topics: game, golang-application, lilith, ocr, ocr-recognition, rise-of-kingdoms, riseofkingdoms
• Language: Go
• Homepage: https://docs.rokmonster.dev
• Size: 6.68 MB
• Stars: 23
• Watchers: 2
• Forks: 7
• Open Issues: 1
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          
# ROK Monster OCR (GoLang)

[![Discord](https://img.shields.io/discord/768180228710465598?label=Discord&logo=discord&logoColor=%23ffffff)](https://discord.gg/drhxwVQ) 

[![License: GPL-3.0](https://img.shields.io/github/license/rokmonster/ocr)](https://opensource.org/licenses/GPL-3.0)

[![Go Report Card](https://goreportcard.com/badge/github.com/rokmonster/ocr?style=flat-square)](https://goreportcard.com/report/github.com/rokmonster/ocr)

---

👋 An idea for this project came from [ROK Monster OCR Tools](https://github.com/carmelosantana/rok-monster-ocr).

---

👋 Join our [Discord](https://discord.gg/drhxwVQ) for help getting started or show off your results!

---

## Kingdom Statistics

Command line tools to help collect player statistics from [Rise of Kingdoms](https://rok.lilithgames.com/en). By analyzing screenshots we can extract various data points such as governor power, deaths, kills and more. This can help with various kingdom statistics or fairly distributing [KvK](https://rok.guide/the-lost-kingdom-kvk/) rewards.

![Sample](./media/sample.png)

[![asciicast](https://asciinema.org/a/gYerprrrw0DVOXZbitOfHrPqg.svg)](https://asciinema.org/a/gYerprrrw0DVOXZbitOfHrPqg)

## Features

- Character recognition by [Tesseract](https://github.com/tesseract-ocr/tesseract)

- Easy install with package managers `apt-get` / `yum`

- Fast hash based image comparison

- Automated pick of best-match template (based on first image in media directory)

- Easy to use WebUI. Just open [localhost:8080](http://localhost:8080/), upload files, and get results directly in your browser.

- Automatic download/update of Tesseract data files.

## Future Plans

- Ability to use multiple templates in single run

- Discord BOT mode. (Process each image sent to a specific discord channel)

- Automate screnshot collection using ADB & Memu/LDPLay/real android device

## Limitations

- English language is preferred as coordinate information lines up most accurately with English.

- No way to merge user information from different screens.

- Best template is detected automatically, but same template is used for all files in media directory.

- Requires a template defined for proper device (resolution/acpect-ratio/language)

- Limited number of predefined templates

## Getting started

[Read the docs here](https://rokmonster.github.io/ocr/)

## Community

Have a question, an idea, or need help getting started? Checkout our [Discord](https://discord.gg/drhxwVQ)!