{"id":21391063,"url":"https://github.com/slyautomation/osrs_basic_botting_functions","last_synced_at":"2025-10-14T20:15:59.405Z","repository":{"id":37360935,"uuid":"352047977","full_name":"slyautomation/osrs_basic_botting_functions","owner":"slyautomation","description":"Functions for automating osrs botting using Python. ","archived":false,"fork":false,"pushed_at":"2023-12-15T10:34:47.000Z","size":20162,"stargazers_count":223,"open_issues_count":6,"forks_count":79,"subscribers_count":19,"default_branch":"main","last_synced_at":"2025-09-08T04:46:01.821Z","etag":null,"topics":["automation","botting","color-detection","colorbot","image-recognition","imagebot","ocr","oldschoolrunescape","osrs","pyautogui-automation","python","runescape","template-matching","tesseract-ocr"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/slyautomation.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-03-27T10:50:54.000Z","updated_at":"2025-09-05T16:34:29.000Z","dependencies_parsed_at":"2023-12-15T11:44:34.307Z","dependency_job_id":null,"html_url":"https://github.com/slyautomation/osrs_basic_botting_functions","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/slyautomation/osrs_basic_botting_functions","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slyautomation%2Fosrs_basic_botting_functions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slyautomation%2Fosrs_basic_botting_functions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slyautomation%2Fosrs_basic_botting_functions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slyautomation%2Fosrs_basic_botting_functions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/slyautomation","download_url":"https://codeload.github.com/slyautomation/osrs_basic_botting_functions/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slyautomation%2Fosrs_basic_botting_functions/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279021016,"owners_count":26086947,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","botting","color-detection","colorbot","image-recognition","imagebot","ocr","oldschoolrunescape","osrs","pyautogui-automation","python","runescape","template-matching","tesseract-ocr"],"created_at":"2024-11-22T13:23:30.870Z","updated_at":"2025-10-14T20:15:59.387Z","avatar_url":"https://github.com/slyautomation.png","language":"Python","funding_links":["https://www.buymeacoffee.com/slyautomatG"],"categories":[],"sub_categories":[],"readme":"# Old School Botting Functions\n\nFull tutorial on creating Functions for automation using Python for osrs botting. \nThe example used will be woodcutting, where the script will use colour detection using opencv and use pyautogui to move the mouse, click and use the keyboard to drop items using an image recognition module that will detect the wood icons in the inventory.\n\nConsider donating if you found the project fun and learnt more about python: https://www.buymeacoffee.com/slyautomatG\n\nOther python files will also use tesseract-OCR to detect text within images using tesseract-OCR image to text recognition functions.\n\nNeed help with installing python, pycharm and cloning a repo? read this article for help: https://www.slyautomation.com/blog/install-pycharm-and-python-clone-a-github-project/\n\n## Setup\n\n```diff\nNote: PC Monitor settings - change resolution to 1920x1080 panel and text of apps was set to 100%.\n```\nRight click and select Display Settings\n\n![image](https://user-images.githubusercontent.com/81003470/180430422-181e478b-43ed-4d1e-89ba-93c942af7313.png)\n\nIn the Scale And Layout section - Change size of text to 100% and Set Display Resolution to 1920 x 1080 for best results.\n\n![image](https://user-images.githubusercontent.com/81003470/180430706-dba89331-09b0-4626-9d42-1a07a0885c41.png)\n\n\n### Installing Pycharm\n\u003ca href=\"https://www.jetbrains.com/pycharm/download/#section=windows\"\u003epycharm\u003c/a\u003e \n\n\u003ca href=\"https://www.jetbrains.com/pycharm/download/download-thanks.html?platform=windows\u0026code=PCC\"\u003epycharm windows\u003c/a\u003e\n\n\u003ca href=\"https://github.com/slyautomation/osrs_basic_botting_functions/wiki/How-to-Install-Pycharm\"\u003e How to Install Pycharm\u003c/a\u003e\n\n\u003ca href=\"https://github.com/slyautomation/osrs_basic_botting_functions/wiki/How-to-add-Project-with-Pycharm\"\u003e How to add Project with Pycharm\u003c/a\u003e\n\n\u003ca href=\"https://github.com/slyautomation/osrs_basic_botting_functions/wiki/how-to-ensure-venv-%28virtual-environment%29-is-active\"\u003e Editing how to ensure venv (virtual environment) is active\u003c/a\u003e\n\n## core.py and function.py\nFor the full video tutorial click link: https://www.youtube.com/watch?v=C7ZY4KYpFII\n\nThis video is more about how it was created at the start core.py is how to make the python script focus on the old school runescape application and adjust the window size so all the scripts run as intended. Then functions.py is where all the different kinds of shortcut functions are placed to reference the mini map, or a piece of code to do color detection or open the inventory.\n\n## Quick module install Steps\n\nin terminal type:\n\npip install -r requirements.txt\n\ntesseract-ocr = https://digi.bib.uni-mannheim.de/tesseract/?C=M;O=D  \n\nif that website is down use 5.3: https://drive.google.com/file/d/1acZJSm3BEmCORSB4NDmpaaT5WC1FNu2s/view?usp=sharing \n\nor use original version 3.0.2: https://drive.google.com/file/d/1mCgYueVKRVbPg-ICz8BjrAWH5oOLjp55/view?usp=sharing\n\nTutorial on installing tesseract-OCR: https://youtube.com/watch?v=X3snnwzJfEw\u0026t=25m15s\n\n## Runelite Setup\nTutorial on runelite setup click link: https://youtube.com/watch?v=JO2FvkJwppA\n\nAlso make sure that the transparent side panels and chatbox is unchecked:\n\n![image](https://github.com/slyautomation/osrs_basic_botting_functions/assets/81003470/b6e6b1c8-3672-4564-bee0-ba15e4a0d2a1)\n\nMake sure the tool bar is enabled and showing on the right had side of the client window (press the arrow to enable the toolbar as visable):\n\n![image](https://github.com/slyautomation/osrs_basic_botting_functions/assets/81003470/f94f74f0-3658-49a1-9acf-a70b9f7c6e08)\n\n\n### pybot-config.yaml (configuration file)\n\n![image](https://user-images.githubusercontent.com/81003470/177748290-e8337717-0f06-4aeb-afc9-19056bbebc23.png)\n\nclient_title: Is the title of the application window usually Runelite if you have completed the steps for the Runelite Setup, if not then enter RuneLite - username or OpenOSRS\n\n![image](https://user-images.githubusercontent.com/81003470/177749000-e7b09b9d-26fc-43ab-95cd-2a84ad12fcc3.png)\n\n![image](https://user-images.githubusercontent.com/81003470/177749289-c6b11dfe-1fe0-4d5d-a67f-bf53d62839ce.png)\n\nTo disable the username in the client window using the toolbar search for runelite plugin and in the settings make sure 'Show display name title' is unchecked.\n\n![image](https://github.com/slyautomation/osrs_basic_botting_functions/assets/81003470/5832dee1-13d0-4ecb-a2c5-5ad383b54f69)\n\nenable_on_start: if you don't want the config window to pop up each time, enter as false\n\nfile_path_to_client: the head folder where the OSRS client is stored usually .runelite or .openosrs\n\npc_profile: is the user profile of the pc so it can find runelite or openosrs\n\n![image](https://user-images.githubusercontent.com/81003470/177750475-75e97359-907d-4c2a-b36d-0ada31594fd8.png)\n\ntesseract_path: Is the folder address to tesseract-ocr program\n\n![image](https://user-images.githubusercontent.com/81003470/177748476-6b190ed9-d1b2-4677-96c5-2b47859f2ee6.png)\n\n```diff\n- Note: copy the format below make sure to include the slashes (\\).\n```\n![image](https://user-images.githubusercontent.com/81003470/177748290-e8337717-0f06-4aeb-afc9-19056bbebc23.png)\n\nIn Runescape setting,  set the following:\n\n- Ideally under display, enable hide roofs, camera zoom, screen brightness matching below.\n\n![image](https://user-images.githubusercontent.com/81003470/188833251-0e285e58-541c-4ba2-bf33-065581e9d38e.png)\n\n- Under controls, enable shift click to drop items, and set inventory shortcut to ESC keystroke.\n\n![image](https://user-images.githubusercontent.com/81003470/188833473-7de48c91-dd03-44fd-a7a6-081e18ca0fa5.png)\n\n- Under Interfaces ensure Game Client layout is Resizable - Modern Layout\n- Show data orbs enabled\n\n![image](https://user-images.githubusercontent.com/81003470/188834061-becf3678-9ec3-4115-845a-b11102b3b384.png)\n\nMake sure the info boxes are filled and the standard brown color, use the toolbar and search Runelite. In the settings under overlay section select the 'Overlay color'.\n\nChange Interface font to 'Bold'.\nChange Infobox font to 'Bold'.\nChange opacity to 255 and the hex color to #FF463D32: \n\n![image](https://github.com/slyautomation/osrs_basic_botting_functions/assets/81003470/678cc8a4-1cfd-4a8c-b456-9a6bd134d2d6)\n\n\n## Woodcutting\n\n### features\n\nCuts woods and makes fire\n- Use object marker plugin to highlight trees red, green or yellow.\n- Make sure to have an axe equipped and a tinderbox if firemaking.\n\n- Turn on woodcutting plugin\n- Turn off Show weight in item stats\nTutorial on firemaking code click link: https://youtu.be/bHZCQUChG_k\n\n![image](https://user-images.githubusercontent.com/81003470/172408565-e7bb7126-ede9-41ff-a143-b9257cee6344.png)\n\n- Pick a object marker color, a wood type and how long in hours to run for\n\n![image](https://user-images.githubusercontent.com/81003470/172408690-510ff90b-0197-4959-a7a8-201e1620b79b.png)\n\n## fishing.py\n- Turn on fishing plugin.\n- Make sure to have net for prawn fishing or a rod and bait/feathers for fish.\nTutorial on fishing code click link: https://youtube.com/watch?v=5K-nMy9Pdvg\n\n\n## mining.py\n- Turn on mining plugin.\n- Mark ore spots using the object marker to green. \n\n![image](https://user-images.githubusercontent.com/81003470/177980804-669ebd1d-0f9c-4102-8b86-efef42a7d1de.png)\n\n- Make sure to equip a pick axe.\n\n- enter the ore type, the marker color and how long to run in hours (Change Run_Duration_hours) \n![image](https://user-images.githubusercontent.com/81003470/172346408-c72b05cf-6e23-4846-b5db-e189c6501e60.png)\n\n![image](https://user-images.githubusercontent.com/81003470/172290853-3d98d94c-38c4-41b9-8971-da017776956a.png)\n\nTutorial on mining code click link: https://youtube.com/watch?v=dkD5gXcgQYI\n\n\n## combat.py\n- Turn on NPC Indicators plugin and Opponent Information plugin\n- Change Highlight colour to #ff00ffff\n\n![image](https://user-images.githubusercontent.com/81003470/177981614-830a435a-81f5-4d95-bd07-10cca3008a04.png)\n\n- Hold Shift and Right Click on NPC/Mob and select Tag-All\n\n![image](https://user-images.githubusercontent.com/81003470/177981922-1f356fe0-7aa9-4ac9-9b61-7180025b115e.png)\n\n- In the Combat script change the first value to the NPC/Mob name\n- Change Run_duraction_hours to the number of hours to run script for\n\n![image](https://user-images.githubusercontent.com/81003470/177982195-47de25fa-f300-4362-bea7-0aa1b2cff258.png)\n\n- To add or use a NPC/Mob not on the list add it to the monster_array as ['each iteration captured by the combat_text'] and add to monster_list the name\n\n![image](https://user-images.githubusercontent.com/81003470/177983040-28802f6f-bb57-4120-837b-830464215ee5.png)\n\nTutorial on combat code click link: https://youtube.com/watch?v=llGbhVfU1Bc\n\n## thieving.py\n\n### steal_man() Works with Knights, Goblins and Thieves etc.\n\n- Turn on NPC Indicators plugin\n- Change Highlight colour to #ff00ffff\n- Hold Shift and Right Click on NPC/Mob and select Tag \u003cMan\u003e\u003cKnigt\u003e etc.\n\n![image](https://user-images.githubusercontent.com/81003470/179393733-d8a16835-c051-4399-9614-528f8748afde.png)\n \n- Make sure pickpocket will be actioned on left click (some npcs even on always right click have 'talk to' as left click option)\n  \n![image](https://user-images.githubusercontent.com/81003470/179394074-85e3e1b1-e942-437b-8d01-0d024a5817ee.png)\n \n- To stop script hold down the capslock key\n \n### Improvements to add\n - Stop or eat when health is low (warning this does not stop when health is low)\n\n### steal_tea() \n \n - Hold shift and mark object Tea Stall (Make sure the color is red)\n \n ![image](https://user-images.githubusercontent.com/81003470/179394490-dede3956-f7c5-48b4-9d1d-fc501d25d9a3.png)\n \n ![image](https://user-images.githubusercontent.com/81003470/179394511-cad0e25a-a314-45f4-a957-44952eee55ba.png)\n\n## Clay Money Maker\nThis only works at the Rimmington mine and banks at Port Sarim deposit box.\n- Turn on mining plugin.\n- Make sure to equip a pick axe.\n- The Start location when running the clay_beginner_money_maker.py is at the Rimmington Mine start next to the clay deposits\n \n![image](https://user-images.githubusercontent.com/81003470/188813727-27fb9e27-ad1b-421c-8c0e-7c6c9f87be6e.png)\n```diff\n- IMPORTANT! Set compass directly north, click the on the compass to reset straight. \n Otherwise the walker from deposit box to rimmington mine won't work.\n```\n![image](https://user-images.githubusercontent.com/81003470/188813195-22c0aabc-b7d8-4d08-87db-4045b33486d3.png)\n\n- Mark clay spots next to the east fence line using the object marker to green (optional are red or amber). \n \n![image](https://user-images.githubusercontent.com/81003470/177980804-669ebd1d-0f9c-4102-8b86-efef42a7d1de.png)\n\n![image](https://user-images.githubusercontent.com/81003470/188812536-c27bec72-e463-43e2-82af-322004526e28.png)\n\n- Mark the deposit box at Port Sarim using the object marker to red.\n\n![image](https://user-images.githubusercontent.com/81003470/188812816-541fd87c-e1b0-4fd9-8509-b3b83df67ef3.png)\n\nThis is the path that is takes:\n\n![image](https://user-images.githubusercontent.com/81003470/188812094-800e6793-2827-449b-a090-5bb6d14ebec4.png)\n \nMake sure to select the color that you highlighted the clay ores and set the Run Duration to the number of hours:\n \n![image](https://user-images.githubusercontent.com/81003470/188814212-8131f6fb-b0f4-4a04-af18-0e740462d39d.png)\n\n\n## smithing.py\n\nTutorial on smithing code click link: https://youtube.com/watch?v=YezEeVjoP6o\n\n## magic.py\n\n### features\n\nHigh alching\n\nSuperheat item\n\nTutorial on magic code click link: https://youtube.com/watch?v=Vyhy2CpfK7I\n\n## osrs_walker.py\n\nTutorial: TBA\n\n- Located in jar_files: Add httpplug-1.0.3.jar to C:\\Users\\  \u003cusername\u003e \\.openosrs \\plugins\n- Located in jar_files: Add shortestagility-5.0.2.jar to C:\\Users\\ \u003cusername\u003e \\.openosrs \\plugins\n  \n  ![image](https://user-images.githubusercontent.com/81003470/155945546-695d28b8-5cbd-461a-9342-44d38e6c6b37.png)\n\n### Setup\n- Create txt file on desktop paths.txt, the modified plugin shortestagility-5.0.2.jar saves the coordinates when a path target is made in osrs. \n- ![image](https://user-images.githubusercontent.com/81003470/140734894-c097bde1-4448-4e2c-898b-a6fc4238ca98.png)\n- ![image](https://user-images.githubusercontent.com/81003470/140739938-3f9d4826-8d07-4ddc-bf17-19407ff7beab.png)\n- ![image](https://user-images.githubusercontent.com/81003470/140739552-1633d5db-5d0f-4348-8e71-bb0fa2ec0574.png)\n\n- Use main map and right click then select 'set target', run server.py and then run osrs_walker.py.\n- ![ezgif com-gif-maker (1)](https://user-images.githubusercontent.com/81003470/140738915-4ba2106a-ec4f-4a89-97e9-46eacca6f792.gif)\n\n## Troubleshooting \n\npython venv/Scripts/pywin32_postinstall.py -install\n\n## Wiki\n[Wiki page on function descriptions and purpose](https://github.com/slyautomation/osrs_basic_botting_functions/wiki/Purpose-and-Definition-of-Functions-including-argument-s-usage)\n\n\nUsing the top banner in pycharm under file goto setttings.\n![image](https://user-images.githubusercontent.com/81003470/228144071-2b3d145c-4a5b-4781-9516-c347b37a3cff.png)\n\nThen in settings under the tools section click on terminal. and you'll need to change the shell path to cmd.exe. at the moment your default terminal is powershell\nImage\n![image](https://user-images.githubusercontent.com/81003470/228144090-056bc599-449e-47d6-b742-3df2704b21a1.png)\n\nYou'll now be able to type in the pip command no issues\n\n\n \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslyautomation%2Fosrs_basic_botting_functions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fslyautomation%2Fosrs_basic_botting_functions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslyautomation%2Fosrs_basic_botting_functions/lists"}