Obvra Documentation

The complete guide to building, testing, and deploying intelligent automation workflows using the Obvra client.

I: THE INTERFACE / WORKSPACE OVERVIEW

Saving/Loading Bots

Hover over the bot loaded section and you can access the save and load buttons.

Pro Tip

You can save any number of bots. Some bots may ask you to resize the client to work properly. This is automatic.

I: THE INTERFACE / WORKSPACE OVERVIEW

ACTION HISTORY

This is the action history where your bot’s actions live. Actions run from top to bottom, in order. Access it quickly with Ctrl + H

Pro Tip

You can right-click any action to duplicate it, disable it, move it, or hover it to access other tools.

I: THE INTERFACE / WORKSPACE OVERVIEW

WATCHERS

Watchers are separate logic loops. Each Watcher runs its own set of actions and checks.

Pro Tip

Most bots use multiple Watchers, for example: one for the main task, one for banking, and one for safety.

I: THE INTERFACE / WORKSPACE OVERVIEW

DUPLICATING

You can duplicate watchers and it's actions within a watcher or duplicate them into another watcher.

Pro Tip

Very beneficial to avoid having to remake the same thing twice or more.

I: THE INTERFACE / WORKSPACE OVERVIEW

CLONING ACTIONS

You can create a new watcher from a specific group of actions so they have their own watcher.

Pro Tip

Breaking up watchers is important. You can drag and move a sequence into it's own new watcher.

I: THE INTERFACE / WORKSPACE OVERVIEW

MULTI SELECT

Select specific actions and move them within a watcher, to another, or delete them.

Pro Tip

There are times when you only need a few actions or maybe you made a mistake somewhere.

I: THE INTERFACE / WORKSPACE OVERVIEW

RENAMING

You can rename watchers within the watcher panel.

Pro Tip

Keep all of your watchers organized for quicker building.

I: THE INTERFACE / WORKSPACE OVERVIEW

DISABLE

Mastering when to disable a watcher is important. There are times when you will need to disable watchers and instead rely on them being triggered manually.

Pro Tip

Triggering a disabled watcher allows you to build more complex bots that rely on specific encounters.

I: THE INTERFACE / WORKSPACE OVERVIEW

GROUPING

You can create any number of groups, rename it, and add other watchers into that group.

Pro Tip

You can also right click on a group to delete the group or disable all watchers within that group.

I: THE INTERFACE / WORKSPACE OVERVIEW

Tabs

You can move watchers into a tiny tab that sits below the others. This is great for organization.

Pro Tip

These are typically placed here if you do not want them to take up space. Click them to restore.

I: THE INTERFACE / WORKSPACE OVERVIEW

Quick Insert

Hover over any action in the action history until you see the + sign. Then click to to access the quick menu.

Pro Tip

This will be the fastest way to insert new actions and make new selections.

I: THE INTERFACE / WORKSPACE OVERVIEW

Headers

Insert labeled headers between any action to remind yourself what each part does.

Pro Tip

As watchers become long, it's easy to forget the job of each sequence within one.

I: THE INTERFACE / WORKSPACE OVERVIEW

Drag Sorting

Click and drag any action or watcher header in order to reposition it with another.

Pro Tip

You can also drag any action to new tab which is the + sign and it will automatically create a watcher with it.

I: THE INTERFACE / DEBUGGING & TRACKING

LOGS

Logs show what the bot tried to do and what happened next, in real time. It can jump to the exact part in the bot that is causing the issues.

Pro Tip

If something fails or the bot stops, logs usually explain exactly why.

VisionAI / Vision Features

AI Chat Assistance

Hover over the bot loaded section and you can access the save and load buttons.

Pro Tip

The chatbot understands the context the moment you open it. You can ask it for advice or tips.

VisionAI / Vision Features

Track Hitpoints

Enable AI Vision to analyze the screen. Ask questions, get True/False responses, and track elements purely through text to guide your bot's logic

Pro Tip

You can also set custom regions on these vision actions to look at only specific spots on the screen.

VisionAI / Vision Features

Auto Talker

Create a auto talker that randomly writes out a poem line by line.

Pro Tip

It will automatically write out the poem. You can also have it react based on text seen, etc.

II: TARGETS & IMAGES / SELECTING TARGETS

CAPTURE TARGET

Drag a selection on the screen, then drag again to save it. That image becomes the target this action will look for.

Pro Tip

After saving, the image appears directly inside the action so the bot knows what to search for.

II: TARGETS & IMAGES / VIEWING TARGETS

OBJECT ALBUM

The album shows every image you’ve saved for your bot.

Pro Tip

You can also add new objects from here directly by adding new selections or uploading files.

II: TARGETS & IMAGES / SEARCH AREAS

SEARCH ZONES

Search zones tell the bot where it’s allowed to look on the screen.

Pro Tip

This keeps the bot focused and prevents it from clicking the wrong thing.

II: TARGETS & IMAGES / SEARCH AREAS

EDIT ZONES

You can resize or move zones without recreating the action.

Pro Tip

Useful when the game window moves or the UI shifts slightly.

III: FIND & DETECTION / WAITING & STATES

TARGET FURTHEST OBJECT

When enabled, if there are two or more of the same object visible; it will choose the furthest one from the character dot in center of minimap.

TARGET FURTHEST OBJECT

Pro Tip

Commonly used to track and switch between fishing spots.

III: FIND & DETECTION / WAITING & STATES

IGNORE DELAYS

Enabling this allows the watcher to check for its target and execute actions even if a global delay is currently active.

IGNORE DELAYS

Pro Tip

You can also trigger to cancel any global on-going delays.

III: FIND & DETECTION / WAITING & STATES

TAKE PRIORITY

When enabled, this action interrupts any on-going action and instead instantly executes the watcher it's enabled for.

TAKE PRIORITY

Pro Tip

An example could be when making an agility bot. It should immediately grabs Marks of Grace from the ground.

III: FIND & DETECTION / WAITING & STATES

AUTO DISABLE

Automatically disables the parent watcher after this action completes.

AUTO DISABLE

Pro Tip

Bots are passive by default and will trigger when object is detected. You can stop a watcher completely with this.

IV: ACTION SETTINGS / CLICKING

CLICK TYPE

Choose whether the bot left-clicks, right-clicks, double-clicks, or holds.

Pro Tip

The click happens at the center of the found target unless offsets are applied.

IV: ACTION SETTINGS / CLICKING

RANDOMIZE CLICK

Adds small variation to where the bot clicks.

Pro Tip

This prevents repeated clicks on the exact same pixel.

IV: ACTION SETTINGS / CLICKING

OFFSETS

Shifts the click position relative to the target before clicking.

Pro Tip

Useful when detecting a large object but clicking a specific part of it.

IV: ACTION SETTINGS / KEYBOARD INPUT

Typing

Type keys to build a sequence the bot will press in order.

Pro Tip

Delays can be added between keys to slow things down.

V: CONDITIONAL ACTIONS / DECISION MAKING

SUCCESS & FAILURE

Each action can decide what happens next when it works or fails.

SUCCESS & FAILURE

Pro Tip

This is how bots retry actions, recover from errors, or switch Watchers.

V: CONDITIONAL ACTIONS / DECISION MAKING

RETRIES

You can retry an action a set number of times before moving on.

RETRIES

Pro Tip

Useful when objects appear with delays or load inconsistently.

V: CONDITIONAL ACTIONS / DECISION MAKING

JUMPING & SWITCHING

Actions can jump to another step or start a different Watcher.

JUMPING & SWITCHING

Pro Tip

This is how complex bots change behavior based on what’s happening.

Tutorial: Woodcutting Bot / TREE CUTTER

FIND TREE

Create a Find action that looks for the tree on screen.

Pro Tip

This tells the bot what object it should interact with.

Tutorial: Woodcutting Bot / TREE CUTTER

CLICK TREE

Add a Click action so the bot interacts with the tree.

Pro Tip

Randomization helps prevent repeated identical clicks.

Tutorial: Woodcutting Bot / TREE CUTTER

Add Delay

Add a delay between actions so the bot does not attempt to spam click the tree very quickly.

Pro Tip

Delays are important to avoid spamming of any detections.

Tutorial: Woodcutting Bot / TREE CUTTER

REPEAT

The bot will continue to cut the tree while it is visible on screen. If not, it will wait until the tree respawns and then click the tree again.

Pro Tip

Move to next chapter to learn how to only click when the character is not busy.

Tutorial: Woodcutting Bot / TREE CUTTER [Advanced]

BUSY STATE

In some clients, you will see the 'Not Woodcutting' highlight on screen. We can use this to prevent our player from cutting the tree while they are currently chopping.

BUSY STATE

Pro Tip

This ensures the bot doesn’t click again until it finishes the task.

Tutorial: Woodcutting Bot / TREE CUTTER [Advanced]

Track State

Label your watcher names appropriately and then create a new watcher and name it 'State'. This will be used to trigger our 'Chop' watcher.

Pro Tip

The goal for this step is to prepare and stay organized.

Tutorial: Woodcutting Bot / TREE CUTTER [Advanced]

Disable & Trigger

We will be triggering our 'Chop' watcher only when we are not currently chopping. Disable the 'Chop' watcher and then set a conditional for 'State' watcher to trigger 'Chop' when true.

Pro Tip

The 'Chop' watcher will never start unless it is triggered by the 'State' watcher.

Tutorial: Woodcutting Bot / TREE CUTTER [Advanced]

Save & Start Bot

Make sure 'Not Woodcutting' message is visible. That is the trigger to start. To get it to appear, click the tree first normally if the message disappeared. You can now customize your bot to include more features or start it as is.

Pro Tip

The bot will loop the same checks and steps endlessly. You can lower the 5s delay so it rechecks faster.