# Feature: Plugin Scripting

#### <mark style="color:red;background-color:red;">**THIS BRANCH HAS BEEN RELEASED AND IS PART OF THE REGULAR VERSION OF OPEN BRUSH**</mark>

#### Status: Released

### What does it do?

Unlike the existing [OpenBrush API](/user-guide/open-brush-api.md), plugin scripting is designed to run small scripts that directly modify the behaviour of various features while you are actually using them. For example a script might move the pointer as you are painting or add new strokes in response to your actions.

### What's it good for?

Changing the way Open Brush responds to user actions. Adding new mirror modes or creating a new custom brush tool.

### How do I install it?

This is now part of the regular release of Open Brush

### How do I use it?

See [Using Plugins](/user-guide/using-plugins.md)

### How do I write my own plugin scripts?

See [Writing Plugins](/user-guide/using-plugins/writing-plugins.md)

### Known Issues

Some API commands are untested. Please report bugs on the plugins and scripting channel on Discord. There's lots more I want to do with this including scripted 3d object creation, better UI for parameters (different input widgets etc).

## How do I get help

Come over to the [Open Brush Discord](https://discord.openbrush.app) and chat to me ( @andybak#5425 ). I'm on UK time but I check in fairly regularly.

### Can I see it in action?

{% embed url="<https://www.youtube.com/watch?v=7YxjNvCY8ak>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.openbrush.app/alternate-and-experimental-builds/old-or-completed-feature-builds/runtime-scripting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.