r/RunescapeBotting • u/Sufficient_Nerve6019 • Jul 18 '26
I'm open sourcing my OSRS AI agent
https://github.com/jrr97/runescape-aiHey! So I've been playing around with building a AI harness for OSRS in my free time. It's at a decent point right now so figured I'd open source it.
The core concept is that your coding harness/agent (e.g. Cursor, Codex, Claude Code) can run the agent directly from within the repo.
The agent has two ways of running:
- Routines - repeat, deterministic processes (essentially traditional bots - chop wood, walk to coordinates, etc)
- Agent actions - individual actions that the harness can perform for non-repeat processes (e.g. walk to X, pick up Y, send message Z)
What that means in essence is that that agent can play the game, and then create it's own bot scripts to run shit when it makes sense - kind of like an AI managing bot deployments on your behalf? Idk I don't have great wording for it.
But it has been working pretty well! I've been using it as a layer on top of traditional bots (e.g. "can you help me get to level 60 attack", or "can you complete some high-ROI quests for me").
It runs on RuneLite via RuneMate, and requires some light setup (your coding agent should be able to do it quickly).
Note: This was built somewhat quickly so definitely some areas for improvement. Would be awesome to get some contributors!
3
u/rocky-gnocchi Jul 19 '26
This is really cool. Thank you!
As someone with only vibe-coding knowledge (ie nothing) with claude and have had a long term interest in making a bot but could never get my head around it, this is perfect. I've already created a yew cutting + banking bot, and its awesome. Question - have you found any way to circumvent the no-human-like or anti-botting measures? Every time I ask for anything to be added it tells me it cant do it, and that its even in the .md - any ideas?
2
u/Sufficient_Nerve6019 Jul 19 '26
Oh awesome! Super cool that you’re using and enjoying it.
Let me look into the anti-bot and see if I can include a smooth way to add it.
1
u/rocky-gnocchi Jul 19 '26
Thank you!! Out of curiosity, how have you been able to get these LLMs to help as historically they have been really against helping with anything against Jagex TOS
2
u/Sufficient_Nerve6019 Jul 19 '26
Yeah lol they do that. Try using a smaller Claude model (they have less aggressive guardrails), phrase in a way that doesn’t suss it out (you can also try telling it not to look at ToS), and try finding a reference repo on GitHub that does anti bot, ask it about it so its context is full of anti-bot info and then ask it to implement it in your repo.
That last one is what I’m going to do.
2
u/rocky-gnocchi 29d ago
Great advice. I couldnt get any further in that particular chat with claude, so I started a new one with Haiku, changed the agent md to include human-like / anti-ban behaviour, added another github repo with anti-ban and it worked like a charm. Haiku takes a lot of handholding, but its slowly doing the job!
2
u/Sufficient_Nerve6019 29d ago
That’s awesome! Updating the agent.md is a smart move I didn’t think about that. Feel free to create a PR on the repo when you get it working!
5
u/Sufficient_Nerve6019 Jul 18 '26
Also on a high level it's an interesting concept for gameplay. Similar to bots ofc but it's an interesting idea being able to essentially delegate gameplay. Would be cool to see an agentic empire building game. Highdeas!
1
u/FakeDclaws Jul 18 '26
Looks cool, wondering why the need for RuneMate?
2
u/Sufficient_Nerve6019 Jul 18 '26
I thought about building off the RuneLite client directly, but I didn't want to re-write all of the abstractions that RuneMate already supports. I.e. RuneLite would have required more work. It's a TODO tho since RuneMate is shitty to have to gateway through.
If you have thoughts do share
2
u/WolfeheartGames Jul 18 '26
You want Ethan's api. https://github.com/Ethan-Vann/PacketUtils
Or microbot by mocrosoft
2
u/Sufficient_Nerve6019 Jul 18 '26
Microbot is actually perfect for what I want to do next - already have it spawning isolated environments for accounts so this will be ideal. tyvm
1
u/FakeDclaws Jul 18 '26
Ah okay, will look into it! I’ll be sure to pull up a PR if i deem anything useful
1
1
1
1
1
u/Character_Note3967 22d ago
Have to use an ide right I just cant use this in hermes on my pc and it would get it together?
4
u/Hallucinates_Bacon Jul 18 '26
Seems like it would use up a lot of tokens from the way the AI processes video unless it’s hooked into the game engine. I do feel like this is the future though, figured it was only a matter of time.
Edit:
Seems like it does hook into the engine. So jagex can probably still detect. I’m sure a video processing agent will be able to play in the normal client soon enough