Skip to content

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

Notifications You must be signed in to change notification settings

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.

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

Control UI 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

No packages published