← Back to Gemhaul

Gemhaul for Rise of Kingdoms, Windows PC

Set up Gemhaul in 10 minutes

This guide takes you from the zip file to your first gem. Do the steps in order and take your time. You do not need to know anything about computers.

Please read this first Bots are against the rules of Rise of Kingdoms, and the game's anti-cheat can catch them. A warning, lost resources or a ban can happen to you. We suspect that long total play time in a day raises the risk, so it is probably safer to run it on days when you have not played much. That is a guess, not a safe rule. We recommend using a spare account.

What you need

A Windows PCWindows 10 or 11
The PC gameRise of Kingdoms for PC, logged in
InternetFor the first setup only
10 minutesThe first time

First-time setup

  1. Unzip the file

    Right-click GemFarmer_tester.zip and choose Extract All. Put the new folder somewhere simple, for example on your Desktop or in C:\Gemhaul.

    Do not run it from inside the zip. Windows will not let it work.

  2. Open the game

    Start Rise of Kingdoms, log in with your spare account and leave the window open on the map. Do not minimize it.

  3. Double-click start_app.bat

    It is in the folder you unzipped. Windows asks for permission, so click Yes. The program needs this to click in the game.

    The first time it installs a few helper programs by itself. This can take 5 minutes. A black window shows what it is doing. Do not close the black window. If it says to close the window and start again, do that.

  4. Wait for the Gemhaul window

    A window opens with the title Gemhaul. Leave the black window running behind it.

  5. Enter your license key

    If you see a License box, paste your key into it and press Save key. If you do not see this box, skip this step.

  6. Check the list called "Before you start"

    Every line should have a green tick. A red cross shows a short help text under it. The two you are most likely to meet:

    • Gem picture: the gem picture comes with Gemhaul, so this is normally green. Only if it is red, go to "Make your gem picture" below.
    • Text reader (Tesseract): close Gemhaul and double-click start_app.bat again. It installs the text reader the second time.

Make your gem picture (only if needed)

Gemhaul comes with a picture of a gem deposit and of the game buttons, so most people can skip this whole section. Do it only if the gem picture has a red cross in the check list, or if the bot never finds gems that are clearly on your screen.

  1. Put a gem on screen

    In the game, move the map until a red crystal pile (a gem deposit) is in the middle of the screen.

  2. Press "Make my gem picture"

    In the Gemhaul window open Tools and press Make my gem picture. A picture of your game opens.

  3. Draw a tight box

    Hold the left mouse button and drag a box around only the red crystals, then press Enter. A tight box works better than a big one.

Choose your search area

The bot only searches inside the area you give it. You tell it with four numbers.

  1. Find the numbers in the game

    The top left of the game shows where you are, like X:1093 Y:887.

  2. Fly to each corner and write the numbers down

    Move the map to the left edge, the right edge, the top and the bottom of the area you want.

    • X min is the smallest X number and X max the biggest.
    • Y min is the smallest Y number and Y max the biggest.

    Check each pair: the min must always be smaller than the max. Start with a small area, about 30 by 30 tiles.

  3. Type them into "Your search area" and press Save settings

    Leave the other settings as they are. The window shows roughly how long one sweep takes.

Start farming

  1. Press "Start farming"

    The bot brings the game to the front by itself and starts after a short countdown. You do not need to click the game.

  2. Let it work, and leave the mouse alone

    The bot uses your mouse. If you move it, the bot gets confused. The window shows live what it is doing and how many marches it sent.

  3. To stop, press "Stop"

    You can also move the mouse into a corner of the screen. When it stops, it writes fast_summary.txt with the result.

For a long run, such as overnight

If something goes wrong

It does not find any gems
  • Check that the game window is open and not minimized.
  • Check that there are gem deposits inside your area.
  • If it still finds nothing, make your own gem picture with a tight box (see "Make your gem picture" above).
The window says the search area is wrong

Look at your four numbers. Each min must be smaller than its max, and none should have an extra digit. You can also leave all four empty and use the area around where you stand.

The map seems stuck or it clicks the wrong thing

Press Stop, then start again. The bot also tries to free itself by pressing Esc and jumping back to a known spot. If it keeps happening, send me the files listed below.

A red cross stays next to "Administrator rights"

Close Gemhaul and start it again with start_app.bat, and answer Yes when Windows asks.

The bot asks me to draw a box around a button

The first time it sees a screen it does not know, it may ask. Drag a tight box around the button and press Enter. It asks only once for each button.

The game updated and it stopped working

Small changes to buttons can need a new picture. Tell me in the Discord and I will help.

When you ask for help, send me:
  • What you did and what you expected.
  • The file fast_log.txt from your Gemhaul folder.
  • The file fast_summary.txt, if it exists.
  • A screenshot of the game and of the Gemhaul window.

Ask in the Gemhaul Discord: discord.gg/8xkGYJRxSN