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.
Free accounts include one chat. To start a separate plugin in a new chat, unlock another chat from the prompt that appears when you try to create one — each unlock also includes its own set of messages.
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 prompt templates and 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 selector at the top shows the current target (e.g. 1.21.11). Click it to expand and choose from all supported 1.21.x versions.
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.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
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
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. Use Prompt Templates as a starting point for common plugin workflows.
Prompt Templates
The Prompt Templates button in the chat header gives you quick access to reusable prompts for common tasks. Click it to open the panel, then click any template to instantly load it into the message input.
Note: You need an active chat open before you can use a template. If no chat is selected, clicking a template will prompt you to create one first.
System Templates
Pre-built templates provided by genesix Blocks for the most common plugin workflows. They are read-only — you can view and use them but not edit or delete them. Each template includes:
- A prompt with placeholders you fill in before sending
- Instructions explaining how to use the template effectively (click the three-dot menu → View)
Your Templates
Create your own templates for prompts you use repeatedly. Click + Add in the panel to create one. Your templates can be edited, deleted, and optionally include instructions in Markdown.
Available System Templates
- Add Feature to Existing Plugin — extend a plugin you already built in the same chat
- Fix a Bug — describe incorrect behavior and paste a stack trace for fast diagnosis
- Optimize / Refactor Plugin — improve performance, clean up code, add error handling
- Port Plugin to New MC Version — update a plugin to work on a newer Paper version
- Admin & Moderation Tools — generate mute, ban, warn, staff chat, vanish, and other mod tools
- Brainstorm a Plugin Idea — explore a vague concept with the agent before committing to a build
- Improve My Plugin Idea — refine a rough idea into a clear, build-ready prompt
- Explain How This Plugin Works — get a plain-language walkthrough of the generated code
Chat Options
Hover over a chat in the sidebar to see the three-dot menu:
- Minecraft version: Select the target 1.21.x 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.