OSRS Bot COLOR (OSBC) is a desktop client for controlling and monitoring automation scripts (bots) for Old School RuneScape and private server alternatives. This application is paired with a custom library of tools for streamlining the development of new bots. Unlike most botting frameworks that employ code injection into the game client, OSBC uses a combination of color manipulation, image recognition, and optical character recognition to navigate the game. The goal of OSBC is to emulate human eyes and hands, and wrap that complex logic in an easy-to-use framework.
💬 Join the Discord to discuss the project, ask questions, and follow development
📹 Subscribe to Kell's Code on YouTube for updates and tutorials
⭐ If you like this project, please leave a Star :)
- Install Python 3.10 (newer versions are not compatible)
- Clone/download this repository
- Open the project folder in your IDE (VS Code preferred)
- Open the repository folder in a terminal window
- Create a virtual environment
python -m venv envorpy -m venv envif you have multiple versions of Python installed - Activate the newly created virtual environment
.\env\Scripts\activate - Install the depedencies
pip install -r requirements.txt
- Create a virtual environment
- Run
./src/*OSBC.py*(may need to restart IDE for it to recognize installed dependencies)
See the Wiki for tutorials, and software design information.
OSBC offers a clean interface for configuring, running, and monitoring your Python bots. For developers, this means that all you need to do is write a bot's logic loop, and the UI is already built for you.
The Script Log provides a clean and simple way to track your bot's progress. No more command line clutter!
self.log_msg("The bot has started.")OSBC allows developers to create option menus and parse user selections with ease.
def create_options(self):
''' Declare what should appear when the user opens the Options menu '''
self.options_builder.add_slider_option("running_time", "How long to run (minutes)?", 1, 180)
self.options_builder.add_text_edit_option("text_edit_example", "Text Edit Example", "Placeholder text here")
self.options_builder.add_checkbox_option("multi_select_example", "Multi-select Example", ["A", "B", "C"])
self.options_builder.add_dropdown_option("menu_example", "Menu Example", ["A", "B", "C"])
In one click, you can launch RuneLite with pre-configured, legal plugins that allow OSBC to work its magic. This works completely separate from your normal RuneLite installation, so your personal configuration is not affected.
Your scripts will work no matter the size or position of the game client. OSBC locates important UI elements and allows you to access them by name.
OSBC uses Bezier curves to create smooth, human-like mouse movements.
Official RuneLite plugins exist to add quality of life to players. Many plugins offer highlighting/outlining of in-game objects with solid colors, making them easier for players to see them. Using color isolation, OSBC can quickly locate these outlined objects and extract their properties into simple data structures.
There are some RuneLite plugins that expose game data to a localhost API endpoint. 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.
With the help of the OSBC community, we've created a randomization algorithm that distributes clicks in a way that is more human-like. We followed the same principles used by individuals who've beat the system and achieved max levels without lifting a finger.
Sometimes, your bot might need to find a specific image on screen. We've modified OpenCV's template matching algorithm to be more efficient and reliable with RuneScape UI elements and sprites - even supporting images with transparency. That means you can search images directly from the OSRS Wiki.
We've ditched machine learned OCR in favor of a much faster and more reliable custom implementation. OSBC can locate text on screen in as little as 2 milliseconds. That's 0.002 seconds.
