Skip to content

mdennis281/OSRS-CV-Bot

Repository files navigation

Old-school RuneScape Computer Vision Bot

A vibe coding experiment that has grown into a pretty impressive botting framework.

I wouldn't recommend using this if you aren't willing to get your hands dirty writing some python.

Updated item database for sailing items!! wohoo (no sailing bots yet though) Big shoutout to DayV-git/osrsreboxed-db for keeping the items database up to date.

Known bugs:

I have not rewritten the bank interface since the UI redesign by Jagex. Any bots interfacing heavily with the bank probably wont work.

Official support for Windows only, sorry

Setup

  • Play using the runelite client, on windows OS
  • Install python >=3.10
  • Clone repo
  • Open powershell, cd into cloned directory
  • Run:
python -m pip install virtualenv
python -m venv venv
./venv/Scripts/Activate.ps1
pip install -r requirements.txt

python main.py

Demos

Item Combiner - item_combiner.py

item_craft_final.mp4

Rooftop Agility - agility.py

rooftop_agility_final.mp4

New UI

Still a bit buggy

Available Bots Running Bot Config UI

Computer Vision Debugger

CV Debug

Install

Full UI experience

python -m pip install -r requirements.txt
python main.py

Direct bot invocation (need this for bots with complex params ie. list of items): Create new file

# update bot script here
from bots.master_mixer import BotConfig, BotExecutor


def main():
    config = BotConfig()
    bot = BotExecutor(config)
    
    bot.start()
    
main()

Bot Hotkeys

  • Page Up: Terminate the bot immediately
  • Page Down: Pause/Resume the bot

NOTE: the bot script architecture is migrating from legacy (scripts defined in base dir) to the new bot architecture defined in ./bots. Invocation of the new architecture can be seen above.

The new architecture has a core bot class defined here Bot(). This Bot() class is used as a way to have all the core components (RuneLiteClient(), ScriptControl(), MovementOrchestrator(), BankInterface(), ItemLookup()) all in one class.

Noteworthy scripts:

About

vibe coded osrs bot framework, leveraging computer vision instead of hooking into the game client

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors