ChromaScape is a low-level, colour-based automation framework designed for game clients like Old School RuneScape. Inspired by Kelltom's OSBC, SRL-dev, Nick Cemenenkoff's RuneDark and SlyAutomation, it focuses on education, prototyping, and safe, human-like interaction using colour and pixel-based logic.
Whether you're just starting with bot development or building advanced automation systems, ChromaScape provides a modular, structured framework to help you prototype fast and learn by doing.
Due to the constraints of remote input, this project currently supports Windows only.
- Install JDK 17.0.12
- Install an IDE (IntelliJ IDEA recommended)
- Clone this repository
- Run
CVTemplates.batto download template dependencies - (Optional) Pat yourself on the back :]
- Please visit the Wiki for detailed guides on writing scripts with this framework.
- Feel free to join the Discord
ChromaScape provides a highly modular botting framework that uses dependency injection where possible to maximize flexibility and reusability across different automation tasks. Due to the separation of domain and core utilities it provides a greater level of control and expansion.
mouse.mp4
ChromaScape uses advanced remote input techniques to function as a virtual second mouse dedicated to the client window. Unlike traditional input methods, this approach never hijacks your physical mouse, so you can continue using your PC without interruption while the bot runs in the background.
This is achieved through KInput, which provides utilities to send mouse and keyboard events directly into a client’s Java Canvas object. By design, it cannot click outside this canvas and requires the Process ID of the target client to operate.
ChromaScape uses the 64-bit supported version of KInput. The original KInput source is also available for reference.
Feel free to browse the code or build from source if you’d like to dive deeper into how it works.
To further reduce bot detection risks, ChromaScape uses humanised mouse movement patterns that mimic real user behavior. Through a combination of multiple bezier paths, easing functions and the ability to overshoot/undershoot then recorrect - this produces surprisingly natural-looking behavior.
The UI is built with Spring Boot and served locally. This gives you a powerful way to view logs, manage scripts, and extend functionality - all from a browser tab. It's fully customizable with HTML/CSS/JS, so power users can tweak or overhaul it without modifying core bot code or needing to worry about tight coupling.
This utility allows you to pick exact pixel colours directly from the screen. It’s useful for identifying precise colour values needed to detect specific game elements or interface components. The picker supports real-time sampling and stores these colours for use in detection routines. Inspired by ThatOneGuy's BCD
Note: You will need all other colours except your desired one to be black. (This is just an example to show colour filtering)
Using the colours obtained from the picker, the framework scans defined screen regions to find matching outlines or clusters of pixels. This process enables the bot to recognise in-game objects, UI elements, or indicators by their unique colour signatures. The detection logic is optimized to handle slight variations in colour due to lighting or graphical effects by allowing for a lower and upper range of colours.
ChromaScape includes functionality for identifying images or sprites by comparing pixel patterns against stored templates. This technique allows robust detection of complex objects like UI elements or Sprites.
ChromaScape utilises template matching for accurate and fast OCR. This solution - as opposed to machine learning - provides for ocr at runtime. This was inspired by SRL and OSBC.
This project downloads specific fonts and UI elements from the OSBC, RuneDark and SRL-dev projects to enable accurate template matching, OCR, and UI consistency. These resources are used solely for educational and research purposes and they are not packaged directly within this repository.