Skip to content
This repository has been archived by the owner on Jun 3, 2024. It is now read-only.
Kellen Evoy edited this page May 14, 2023 · 17 revisions

What is OS Bot COLOR?

OS Bot COLOR (OSBC) is a desktop application that allows you to organize, control, and monitor color bots for 2007 Scape-style games. Additionally, it is designed to allow for the development of new bots with intuitive syntax using custom libraries.

Why was it created?

OSBC originally started as a small project for managing personal Python scripts for private servers. Later, it became obvious that it had the potential to be a good general-purpose color-based automation tool. While it was designed to work for OSRS-style games, I do not endorse its usage on the official OSRS game. Ultimately, the true purpose of this tool is to provide an avenue for programming practice, and I would recommend against doing so on the live version of the game.

What is a color bot?

A color bot is one of the simplest ways to automate actions in video games. It's an archaic method, but thye're still popular today. They typically function based on static pixel coordinates and their color values. Changes in pixel colors can prompt the bot to perform certain actions.

Pros:

  • They're easy to create. Even novice programmers will find that the creation of color-based scripts is intuitive.
  • They're good programming practice.
  • They can be used with private servers that mirror the OSRS client.

Cons:

  • Color bots are prone to strange behaviour. Without careful design, they can lose their way and look very suspicious to nearby players.
  • They do not have access to the game's code (or RuneLite's core API), meaning they don't have access to the most accurate details of the game's state (E.g., exact location of NPCs, nearby players, items matching IDs, etc.). This makes extracting game information challenging. Luckily, some game state information can be exposed by RuneLite plugins, which is mentioned below.

How OSBC compensates for drawbacks

Luckily, OSRS-Bot-COLOR was designed with the cons of color bots in mind. OSBC uses computer vision to compensate for the lack of access to game information (E.g., image searching, optical character recognition, color isolation, etc.). This means that even though we can't access RuneLite data directly, we can still make use of various plugins by scanning the game client for certain visuals, as we would with our eyes.

Color Isolation

For instance, for a combat bot, we can use NPC Indicators to tag the NPCs we'd like to attack with the blue outline -- then, our bot can identify each enclosed blue outline and decide which one to click.

cowscows_isolated

Optical Character Recognition

OSBC's custom OCR utility operates extremely quickly on the official RuneScape font set. This is useful for all OSRS-based games. For example, you can quickly determine if your mouse is hovering over what you want to click.

mouseover

You can also take advantage of visual RuneLite plugins to extract game state information. The top-left of the game view is home to plugins that monitor current activity (E.g., Opponent Information, resource harvesting plugins, etc.). You can use OCR to extract this information and use it to make decisions.

current_actioncurrent_action_isolated

It's also useful for checking your HP or prayer points.

pre_extract_textextract_text

Image Searching

OSBC has a custom image searching utility that can be used to find images on the screen. This is useful for all OSRS-based games. This is especially useful for locating UI elements, such as bank buttons, or item sprites in your inventory.

img_search

RuneLite API Integration

Some RuneLite-based games host plugins that expose game data via a local API endpoint. These plugins are legal and easily found on the Plugin Hub. OSBC can use this API to extract accurate game state information one way. You can leverage this data to provide a more robust botting experience without the risks associated with modifying the game client's code. See the API utility folder for more.