Chats

A chat is a dedicated workspace for building one plugin. Create a chat using the "+" button in the sidebar, then describe the plugin you want to build.

Your plan includes unlimited chats — start as many as you like, each its own workspace with its own plugin.

Understanding the Layout

Sidebar (Left)

Shows all your chats. Click any chat to view its history and continue working on it.

Chat Area (Center)

Displays messages and agent responses. This is where you describe your plugin, receive generated code, and download compiled JARs.

Header (Top)

Access your profile menu.

Minecraft Version Selection

Each chat targets a specific Minecraft version. The agent uses this to generate code and compile the JAR against the correct Paper API — so your plugin works on the right server version out of the box.

Per-Chat Version

Open the three-dot menu on any chat in the sidebar. The version badge shows which version the plugin was built for — this is read-only and reflects the version set when the chat was created. To build for a different version, use the version selector in the message input bar before sending.

Default Version

Set your preferred default in your profile. Every new chat you create will inherit this version automatically. The system default is 1.21.11.

Supported versions: 1.20.1, 1.20.2, 1.20.4, 1.20.6, 1.21.1, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11 — and 26.1.1, 26.1.2, 26.2, 26.3 (Minecraft's calendar-based version numbers)

Sending Messages

  • Type your message in the input box at the bottom
  • Press Shift + Enter or click the send button to send
  • Press Enter for new lines
  • Click the stop button to cancel a request in progress

Time Travel

Go back to just before an earlier message. Time Travel takes a chat back to just before one of your earlier messages, as if that message and everything after it had never been sent. Use it when a change went wrong, or to try a different direction from an earlier point.

How to Time-Travel

  • Find the message you want to go back before. A small ⟲ Time Travel pill appears just above your own messages
  • Click it. A confirmation dialog shows the message's time and text and explains what will happen
  • Confirm with Time Travel in the dialog titled "Time travel to before this message?". It takes about a second
  • Time Travel isn't offered while the agent is still working on a reply — wait for it to finish

What Time Travel Does

  • Chat: that message and everything after it are removed
  • Plugin code: goes back exactly to how it was before that message, including its full change history
  • Agent memory: goes back to that point. The agent no longer remembers anything that happened after it, so your next message continues from that earlier state
  • Plugin versions: JARs built after that point are removed from Download, SFTP upload, and Install on server. Plugin Details goes back to the version that was current at that point
  • Next build: gets a new, higher version number — an earlier version's name is never reused or overwritten

Limitations

  • Can't be undone. There's no redo — removed messages and later plugin versions can't be brought back
  • Credits aren't refunded. Credits spent on the removed messages stay spent
  • Not available on the first message of a chat. To start over completely, open a new chat
  • Only on supported chats. Messages without a Time Travel pill can't be time-traveled, for example some messages in older chats
  • Not available while the agent is working on a reply
  • Servers aren't changed. If a later plugin version was already installed on a server (via Install on server or SFTP), time-traveling doesn't uninstall or replace it. Install the earlier version again if needed
  • The chat title stays the same

Tip: If a change went wrong, time-travel back instead of asking the agent to undo it — you get the exact earlier state back. After time-traveling, you can rephrase your request and try again. For a completely fresh start, open a new chat.

Remix a Plugin

Remix turns a plugin you've built into the starting point for a new one. Build a solid base plugin once, then remix it to create variants — a different take, an extra feature set, a version for another server — without ever touching the original.

How to Remix

  • Open the chat's ⋮ menu in the sidebar and choose Remix
  • Pick a name for the new plugin. The dialog checks it as you type
  • Click Remix. It takes a few seconds, then a new chat opens
  • Send your first message there. It builds the new plugin and applies your changes
  • Remix is available on the Iron and Diamond plans, once the chat has built a plugin, and not while a response is in progress

What the New Chat Gets

  • The plugin: its code, plan, plugin.yml and config.yml, all under the new name
  • A fresh start: the new chat starts empty. The agent knows the plugin, not the original conversation: it reads the plugin's Overview first to learn what the plugin does
  • No JAR yet: the remix has no downloadable JAR or Plugin Details until its first build. Your first message builds it
  • A new chat for your quota: a remix counts as a new chat

The Original Stays Untouched

  • The original chat and plugin are unchanged
  • The remix is fully independent. Deleting the original, or time-traveling it back to an earlier message, never affects the remix
  • Remixed from … under the message box of the new chat links back to the original. If the original has been deleted, it shows the original's name without a link
  • You can remix a remix, and build as many variants of one plugin as you like

Choosing a Plugin Name

  • Starts with a capital letter
  • Letters and digits only — no spaces, dashes or underscores
  • 3 to 32 characters
  • Must differ from the original's name

Building the same plugin for another Minecraft version? Tick Keep the plugin name to keep the original's name, so its data folder, config and permissions carry over. Never install both copies on the same server.

Good to Know

  • Running both on one server? Each plugin keeps its own config, but commands and permissions are shared across the server. Ask the agent in the new chat to rename the remix's commands and permissions so they don't clash
  • Time Travel works as in any chat. You can time-travel the remix back to before an earlier message, except its first one. To start the remix over, delete it and remix the original again

Tip: Remix before a big experiment. Your original keeps working exactly as it is, and the remix is free to go in a completely different direction.

File Uploads

You can attach files to your messages to give the agent additional context — screenshots of server errors, configuration files, plugin documentation, or any reference material.

How to Upload

  • Click the 📎 paperclip icon in the message input to open the file selector
  • Paste from clipboard — paste an image (Ctrl+V / Cmd+V) directly into the chat input
  • Large text pastes (over 10 KB) are automatically converted to a file attachment
  • You can attach multiple files in a single message

Supported File Types

Images

PNG, JPEG, GIF, WebP

Documents

PDF, TXT, CSV, HTML, Markdown, DOC, DOCX, XLS, XLSX

Limits

  • Images: up to 20 files, max 3.75 MB each
  • Documents: up to 5 files, max 4.5 MB each

Build Notification Sound

Building a plugin can take a minute or two. Enable the build notification sound in your profile and you'll hear a sound the moment your JAR is ready — so you can step away and come back when it's done.

To enable: Open your profile (top-right avatar) → toggle Build notification sound. The toggle plays a preview so you know what to expect. Sound is off by default.

When Your Request Is Too Vague

If your request is too broad or unclear, the agent will ask for clarification and suggest an improved prompt you can copy-paste. It will offer a few targeted questions to help narrow down exactly what you need — things like specific mechanics, permissions, commands, or config options.

Tip: The more specific your initial request, the better the first result.

Chat Options

Hover over a chat in the sidebar to see the three-dot menu:

  • Minecraft version: Select the target Minecraft version for this chat
  • Rename: Change the chat name
  • Get Plugin JAR: Download or upload the compiled plugin JAR built in this chat
  • Plugin Details: View the plugin overview, permissions, and configuration (see below)
  • Share Feedback: Send feedback about this chat directly to the team
  • Abandon chat: Permanently remove the chat

Plugin Details

After a plugin is built, open Plugin Details from the chat menu to see exactly what was generated. This is especially useful for server admins setting up permissions and configuration.

Overview

The plugin's design document — features, commands, data model, edge cases, and implementation decisions. Rendered as formatted Markdown.

plugin.yml

The standard Bukkit plugin descriptor. Shows all commands with usage syntax, permission nodes with their defaults, and plugin metadata. Use this to set up rank-based access in your permission manager (e.g. LuckPerms).

config.yml

All configurable settings with their default values, plus customizable messages. Edit this file on your server to tune the plugin's behavior without rebuilding.