whatisgithub

What is rocokingdom_s2_box_detector?

greenyice/rocokingdom_s2_box_detector — explained in plain English

Analysis updated 2026-05-18

33PythonAudience · generalComplexity · 2/5Setup · moderate

In one sentence

A screen-watching tool that detects rare creature icons in a Chinese game's surprise boxes using OpenCV template matching.

Mindmap

mindmap
  root((RocoKingdom Box Detector))
    What it does
      Watches a screen region
      Matches template images
      Alerts on a match
    Tech stack
      Python
      OpenCV
      PyQt5
      mss
    Use cases
      Detect rare box icons
      Add custom templates
      Adjust resolution presets
    Audience
      Roco Kingdom players
      Chinese gaming community

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Watch a selected screen region and get alerted when a rare box icon appears.

USE CASE 2

Add your own template screenshots to improve detection for boxes the tool misses.

USE CASE 3

Adjust resolution presets and matching thresholds to match your game window.

USE CASE 4

Run the prebuilt Windows executable without installing Python.

What is it built with?

PythonOpenCVNumPyPyQt5msskeyboard

How does it compare?

greenyice/rocokingdom_s2_box_detector410979729/scope-recallarahim3/mlx-dspark
Stars333333
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity2/53/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

README is in Chinese, requires selecting the correct resolution preset and re-selecting the screen region if the game window changes.

The README does not state a license.

So what is it?

This is a screen-reading detection tool for a Chinese online game called Roco Kingdom (also known as Luoke Wangguo). The README is written in Chinese. The tool was created so that players grinding for rare-color box rewards during the game's Season 2 do not have to stare at the screen constantly waiting for specific creatures to appear inside surprise boxes. The program works by capturing a region of the game screen you draw with your mouse, then continuously comparing that region against a library of stored template images using OpenCV, an open-source image processing library. When a match is found that meets a confidence threshold, the tool alerts the player. The author states the recognition accuracy is roughly 85 percent, and notes the limitation is due to an incomplete template dataset. The README invites other players to contribute code or additional template screenshots. A small floating panel appears on screen with buttons to toggle a debug screenshot mode, show a preview of the detection boxes, overlay the detection area directly on the game window, re-select the game region, open settings, and exit. The settings panel lets you adjust matching thresholds, resolution presets from 720p to 4K, frame rate, and the display style of the history log. Several keyboard shortcuts are also available. Adding new templates is possible by taking a screenshot of the target moment and placing it in the templates folder, then registering it through the settings panel. The tool runs entirely locally with no interaction with the game's memory or controls. Installation requires Python with OpenCV, NumPy, PyQt5, mss, and keyboard. A prebuilt executable is provided for users who do not want to run from source.

Copy-paste prompts

Prompt 1
Explain how OpenCV template matching works for a tool like this that watches a screen region.
Prompt 2
Help me translate this Chinese README's setup and troubleshooting sections into English.
Prompt 3
How would I add a new template image to improve this tool's recognition accuracy?
Prompt 4
Suggest ways to improve the match rate beyond the 85 percent this README reports.

Frequently asked questions

What is rocokingdom_s2_box_detector?

A screen-watching tool that detects rare creature icons in a Chinese game's surprise boxes using OpenCV template matching.

What language is rocokingdom_s2_box_detector written in?

Mainly Python. The stack also includes Python, OpenCV, NumPy.

What license does rocokingdom_s2_box_detector use?

The README does not state a license.

How hard is rocokingdom_s2_box_detector to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is rocokingdom_s2_box_detector for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.