Automation scripts for RuneLite interactions, using Python and screen-based inputs. This project uses screenshot detection, hotkeys, and custom mouse/keyboard handling to automate certain game activities such as construction, crafting, fletching, potions, and pickpocketing.
-
Install Python 3.10+
Recommended: Use a virtual environment.
python -m venv venv source venv/bin/activate # or venv\Scripts\activate on Windows
-
Install dependencies
pip install -r requirements.txt
-
(Optional) Set up screen resolution and DPI scaling
The bot is image-dependent. Run at 100% display scaling and in fixed windowed mode at the resolution the screenshots were captured in.
Each .py file in the root directory performs a specific task. Run them individually using:
python construction.pyor
python potions.pyCheck each script for hotkey bindings or controls (e.g., pressing F8 to start).
FUNFUNFUN/
│
├── autoclick.py # General-purpose auto clicker
├── construction.py # Automates Construction training
├── coords_builder.py # Tool to build and debug coordinate mappings
├── custom_keyboard.py # Abstraction for simulating keyboard input
├── custom_mouse.py # Abstraction for mouse actions
├── fletch.py # Automates Fletching tasks
├── pickpocket.py # Automates pickpocketing
├── potions.py # Automates potion-making
├── pray_hotkey.py # Prayer toggling or hotkey helper
├── requirements.txt # Python dependencies
│
├── bank/ # Screenshots for bank UI interactions
├── construction/ # Screenshots needed for Construction script
├── craft/ # Icons used in Crafting context
├── inv/ # Inventory item screenshots (required for all tasks)
│
└── __pycache__/ # Auto-generated cache from Python; safe to ignore
For the scripts to work, you must have matching screenshots in these folders:
bank/– includes buttons like “deposit-all”, “withdraw-14”, “close”, and banker NPCconstruction/– includes building UI (e.g.,build.png,talk.png,dialogue.png)craft/– potion level icons and prayer item iconsinv/– inventory items likefeather.jpg,log.jpg,pouch.png, and potions
If your screen or UI looks different, you’ll need to capture fresh images and replace the ones in these folders.
Use PNG or JPG as appropriate (stick to the existing formats).
- This project does not interact with the game client directly. It uses screen scraping and keyboard/mouse emulation.
- Scripts assume RuneLite is in focus and UI elements are static.
- You may need to tweak coordinates or delays if behavior is inconsistent.