# BuilderAI-Pro Plugin

<mark style="color:$primary;">**Versions:**</mark> <mark style="color:$primary;">**1.16.x**</mark> - <mark style="color:$primary;">**26.1.x**</mark>\
&#x20;**Is Folia Supported?** \ <mark style="color:$info;">Yes, we support Folia and you can use plugin on paper,bukkit,spigot,pufferfish,purpur versions as well as on Folia!</mark>

<figure><img src="/files/KR5RihyG2K3WPd9ApLFP" alt=""><figcaption></figcaption></figure>

## Installation Guide

{% stepper %}
{% step %}

### Follow this guide to install the BuilderAI-Pro Plugin

{% endstep %}

{% step %}

### Upload JAR File to Your Server

Start by uploading "BuilderAI-Pr&#x6F;**-2.0.0.jar**" file to your Server's > **plugins folder**.![](/files/NjlUqargIidNzEEKOi1F)
{% endstep %}

{% step %}

### Start your Server

When you turn on the server, you will see that the plugin needs a license key, all you have to do is join this [Discord](https://discord.gg/tT6mvrgtw6), open a ticket and ask for BuilderAI-Pro License Key.![](/files/BJS1sd0tSaCf0wLMX7IW)
{% endstep %}

{% step %}

### Setup AI Provider & Model

After activating your **license key**, you must choose your AI provider:

* OpenAI
* Gemini AI
* Claude AI

Then open the selected provider config file, generate your API key from the official provider website, paste the API key into the config, set the provider to `true`, and restart your server.![](/files/v3DEEDPYLGgY3BKzXm3H)\
![](/files/USNpai2bbhVUysz4FSt7)
{% endstep %}

{% step %}

### Restart Server

After configuring your AI provider and API key, restart your Minecraft server to fully load the AI systems, provider settings, and model configuration changes.
{% endstep %}
{% endstepper %}

### **Usage Guide & Edit Help**

<details>

<summary>Admin Commands</summary>

These are the main admin commands you need to know while using BuilderAI-Pro.

#### 🏗️ Build Commands

`/bai generate`

* Type your build description in chat after running the command.

`/bai generate <prompt>`

* Generate a build instantly.
* Example: `/bai generate a medieval house`

`/bai edit`

* Type your edit instruction in chat after running the command.

`/bai edit <prompt>`

* Edit the selected area using AI.
* Example: `/bai edit add a roof`

***

#### 🪄 Selection & Wand

`/bai wand`

* Get the Builder Wand selection tool.

**Wand Left-Click**

* Set Position 1 (Corner 1)

**Wand Right-Click**

* Set Position 2 (Corner 2)
* Green particles will display the selection outline when both positions are set.
* Re-select the area after each completed edit.

***

#### 🧱 Block Palette

`/bai blocks`

* Open the Block Palette GUI.

Inside the GUI:

* Click blocks to select or deselect them
* Use `◄` and `►` arrows to browse 500+ blocks across multiple pages
* Press **Confirm & Save** to save your palette
* AI uses your selected palette when `ai-choose-blocks: false` is enabled in the config.

***

#### 🤖 AI Provider & Model

`/bai provider`

* List all available AI providers, models, and their status.

`/bai provider <id>`

* Switch AI provider.
* Example: `/bai provider gemini`

`/bai provider <id> <model>`

* Switch provider and model.
* Example: `/bai provider gemini gemini-2.5-pro`

`/bai provider reset`

* Reset provider & model to the default config values.

***

#### 🔄 Undo / Redo

`/bai undo`

* Undo the last generated build or edit.

`/bai redo`

* Redo the last undone action.

***

#### ⚙️ Utility Commands

`/bai cancel`

* Cancel the currently active generation or edit task.

`/bai info`

* Show plugin version, server platform, active AI provider, and model.

`/bai reload`

* Reload the plugin configuration without restarting the server. *(Admin only)*

</details>


---

# 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://akiisx-studios.gitbook.io/akiisx-studios-docs/documentation/akiisxstudios/builderai-pro-plugin.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.