Skip to content

Latest commit

 

History

History
161 lines (99 loc) · 5.15 KB

README.md

File metadata and controls

161 lines (99 loc) · 5.15 KB
Raw

image

Microbot

Microbot is an opensource oldschool runescape client based on runelite. It uses a plugin system to enable scripting. Here is a youtube channel showing off some of the scripts

Youtube

image

Discord

Discord Banner 1

If you have any questions, please join our Discord server.

☕ Buy Me a Coffee

If you enjoy my open source work and would like to support me, consider buying me a coffee! Your support helps me stay caffeinated and motivated to keep improving and creating awesome projects.

Buy Me a Coffee

image

BTC Address: bc1q4c63nc5jt9wem87cy7llsk2ur5psjnqhltt2kf

LTC Address: ltc1qgk0dkchfd8tf7jvtj5708vheq82k2wyqucrqs7

ETC Address: 0xf8A6d6Fae32319A93341aE45F1ED87DA2Aa04132

DOGE Address: DNHQDHKn7MKdMQRZyoSrJ68Lnd1D9bjbTn

Thank you for your support! 😊

I Want To Play

Non jagex account

Here is a youtube video on how to setup microbot from scratch for NON-JAGEX ACCOUNTS

https://www.youtube.com/watch?v=EbtdZnxq5iw

Jagex Account

Follow the runelite wiki for setting up jagex accounts: https://github.com/runelite/runelite/wiki/Using-Jagex-Accounts

After you've done setting it up follow these two steps:

  1. Simply login with the jagex launcher for the first time. This will create a token for your account. Close everything after succesfully login in through the jagex launcher.
  2. Open the microbot.jar from microbot and this should prompt you with the jagex account to login.

I Want To Develop

First Time Running the project as a Developer?

Make sure to follow this guide if it's your first time running the project

https://github.com/runelite/runelite/wiki/Building-with-IntelliJ-IDEA

Microbot ChatGPT Chatbot

image

Use this AI Chatbot to learn how to write scripts in Microbot GPT

Project Layout

Under the Microbot Plugin you'll find a util folder that has all the utility classes which make it easier to interact with the game

Utility Classes are prefixed with Rs2. So for player it is Rs2Player. Npcs is Rs2Npc and so on...

If you can't find a specific thing in a utility class you can always call the Microbot object which has access to every object runelite exposes. So to get the location of a player you can do

Microbot.getClient().getLocalPlayer().getWorldLocation()

img.png

ExampleScript

There is an example script which you can use to play around with the api.

img_1.png

How does the example script look like?

public class ExampleScript extends Script {
public static double version = 1.0;

    public boolean run(ExampleConfig config) {
        Microbot.enableAutoRunOn = false;
        mainScheduledFuture = scheduledExecutorService.scheduleWithFixedDelay(() -> {
            if (!super.run()) return;
            try {
                /*
                 * Important classes:
                 * Inventory
                 * Rs2GameObject
                 * Rs2GroundObject
                 * Rs2NPC
                 * Rs2Bank
                 * etc...
                 */

                long startTime = System.currentTimeMillis();
                
                //YOUR CODE COMES HERE
                Rs2Npc.attack("guard");
                
                long endTime = System.currentTimeMillis();
                long totalTime = endTime - startTime;
                System.out.println("Total time for loop " + totalTime);

            } catch (Exception ex) {
                System.out.println(ex.getMessage());
            }
        }, 0, 2000, TimeUnit.MILLISECONDS);
        return true;
    }

    @Override
    public void shutdown() {
        super.shutdown();
    }
}

All our scripts exist of Config. This is the settings for a specific script Overlay, this is a visual overlay for a specific script Plugin which handles the code for starting and stopping the script Script which handles all of the code that microbot has to execute.

Inside the startup of a plugin we can call the script code like this:

@Override
protected void startUp() throws AWTException {
if (overlayManager != null) {
overlayManager.add(exampleOverlay);
}
//CALL YOUR SCRIPT.RUN
exampleScript.run(config);
}

Credits to runelite for making all of this possible <3

https://github.com/runelite/runelite

License

RuneLite is licensed under the BSD 2-clause license. See the license header in the respective file to be sure.