colorbot

A Old School Runescape colorbot utility.

Requirements

colorbot only supports Linux. To build and run this utility, your system must meet the following requirements:

• rustc >= 1.82.0
• xdotool

Program Usage

colorbot is a command line utility. Below is the program usage:

A OSRS color bot

Usage: colorbot [OPTIONS] <SCRIPT>

Arguments:
  <SCRIPT>  path to bot script

Options:
  -r, --runtime <RUNTIME>
          script runtime in seconds [default: 3600]
  -d, --mouse-deviation <MOUSE_DEVIATION>
          determines the deviation of the mouse during pathing [default: 30]
  -s, --mouse-speed <MOUSE_SPEED>
          defines the speed of the mouse, lower means faster [default: 3]
  -g, --debug
          enable logging
  -h, --help
          Print help
  -V, --version
          Print version

colorbot has one required argument which is the path to a JSON file containing mouse events. The event script must have the following format:

{
  "events": [
    {
      "id": "event1",
      "color": [1, 2, 3],
      "delay_rng": [10, 20]
    }
  ]
}

The event script contains a top-level events array with one or more mouse events. Each mouse event has three fields:

• id: A string describing the event.
• color: A three element array containing the RGB color of the pixel to click on.
• delay_rng: A two element array containing the minimum and maximum delay in milliseconds the script will insert after the click is performed.

Checkout the scripts/ directory for example scripts. Note, this utility is meant to be used in conjunction with the RuneLite plugins Inventory Tags, NPC Indicators, Object Markers, and Menu Entry Swapper. Checkout this blog post for more information.