BukkitGPT

English | 简体中文

Join our discord

Note

Developers and translators are welcome to join the CubeGPT Team!

Note

Generate a house or other structure using our other open source project, BuilderGPT!

Table of Contents

• Introduction
• Advertisement
• Features
  • Core
  • GUI
• Plans
  • Other projects of CubeGPT Team
• How it works
• Requirements
• Quick Start
  • Windows/Linux
  • Python/Console
  • Python/UI
• Troubleshooting
  • The POM for org.spigotmc:spigot:jar:1.13.2-R0.1-SNAPSHOT is missing
• Contributing
• Lisence

Introduction

Give GPT your idea, AI generates customized Minecraft server plugins with one click, which is suitable for Bukkit, Spigot, Paper, Purpur, Arclight, CatServer, Magma, Mohist and other Bukkit-based servers.

BukkitGPT is an open source, free, AI-powered Minecraft Bukkit plugin generator. It was developed for minecraft server owners who are not technically savvy but need to implement all kinds of customized small plugins. From code to build, debug, all done by gpt.

GET YOUR FREE API KEY WITH GPT-4 ACCESS

We are pleased to announce that SEC-API is offering a free apikey for users of programs developed by CubeGPT! This key has access to gpt-4-1106-preview and gpt-3.5-turbo-1106.

Note that this key does not have access to models such as gpt-4-vision and expires at any time.

Get the key from here. You can use it in BuilderGPT.

Partner

Features

Core

• Automatically generate code
• Automatically fix bugs
• AI Better Description

GUI

• Creating projects
• Projects management

Plans and TODOs

Moved to Projects Tab.

Other projects of CubeGPT Team

• Bukkit plugin generator. {*.jar} (BukkitGPT)
• Structure generator. {*.schem} (BuilderGPT, or something?)
• Serverpack generator. {*.zip} (ServerpackGPT or ServerGPT, or..?)
• Have ideas or want to join our team? Send us an email!

How it works

When the user types the plugin description, the program lets gpt-3.5-turbo optimize the prompt, and then gives the optimized prompt to gpt-4-turbo-preview. gpt-4-turbo-preview will return it in json format, for example:

{
    "output": [
        {
            "file": "%WORKING_PATH%/Main.java",
            "code": "package ...;\nimport org.bukkit.Bukkit;\npublic class Main extends JavaPlugin implements CommandExecutor {\n..."
        },
        {
            "file": "src/main/resources/plugin.yml",
            "code": "name: ...\nversion: ...\n..."
        },
        {
            "file\": "src/main/resources/config.yml",
            "code\": "..."
        },
        {
            "file": "pom.xml",
            "code": "..."
        }
    ]
}

The program parses this prompt, copies the entire projects/template folder and names it artifact_name, and puts the code from the prompt into the each file. Finally the program builds the jar using maven.

Requirements

You can use BukkitGPT on any computer with Java, Maven, Python 3+.

And you need to install this package:

pip install openai

Quick Start

(Make sure you have the Python environment installed on your computer)

Windows/Linux

1. Download Source Code.zip from the release page and unzip it.
2. Edit config.py, fill in your OpenAI Apikey. If you don't know how, remember that Google and Bing are always your best friends.
3. Run ui.exe (bash python console.py), enter the artifact name & description & package id as instructed to generate your plugin.
4. Copy your plugin from projects/<artifact_name>/target/<artifact_name>-<version>.jar to your server plugins/ folder.
5. Restart your server and enjoy your AI-powered-plugin.

Python/Console

1. Download Source Code.zip from the release page and unzip it.
2. Edit config.yaml, fill in your OpenAI Apikey. If you don't know how, remember that Google and Bing are always your best friends.
3. Run console.py (bash python console.py), enter the artifact name & description & package id as instructed to generate your plugin.
4. Copy your plugin from projects/<artifact_name>/target/<artifact_name>-<version>.jar to your server plugins/ folder.
5. Restart your server and enjoy your AI-powered-plugin.

Python/UI

1. Download Source Code.zip from the release page and unzip it.
2. Edit config.yaml, fill in your OpenAI Apikey. If you don't know how, remember that Google and Bing are always your best friends.
3. Run ui.py (bash python console.py).
4. Enter the artifact name & description & package id as instructed to generate your plugin.
5. Copy your plugin from projects/<artifact_name>/target/<artifact_name>-<version>.jar to your server plugins/ folder.
6. Restart your server and enjoy your AI-powered-plugin.

Troubleshooting

The POM for org.spigotmc:spigot:jar:1.13.2-R0.1-SNAPSHOT is missing

Solution: Download BuildTools, place it in an empty folder, double-click it, choose "1.13.2" in Settings/Select Version, click Compile in the bottom right corner and let it finish. And then go to your BukkitGPT folder, in projects/<artifact_name_of_your_plugin>, double-click build.bat. You'll find your plugin in projects/<artifact_name_of_your_plugin>/target folder.

Contributing

If you like the project, you can give the project a star, or submit an issue or pull request to help make it better.

License

Copyright [2024] [CubeGPT Team]

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.