diff --git a/README.md b/README.md index f77e5c3..baa2f9f 100644 --- a/README.md +++ b/README.md @@ -15,56 +15,95 @@ > Developers and translators are welcome to join the CubeGPT Team! ## Introduction -> A simple template for CubeGPT projects. +> 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. -CubeAgents is a template for CubeGPT's projects like [BuilderGPT](https://github.com/CubeGPT/BuilderGPT). It provides a simple and clean interface for users to interact with the program. +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. -# Showcase -... +## WebApp +Don't want to prepare the Python & Maven environment? Try our [WebApp](http://cubegpt.org/), designed for non-developers, just enter the plugin name and description, and you can get the plugin jar file. + +*The service is paid since the API key we are using is not free. You can get 1 key for 5 generations for $1 [here](https://buymeacoffee.com/baimoqilin/e/293180) or [here (for Chinese users)](https://afdian.com/item/b839835461e311efbd1252540025c377) ## Partner [![](https://www.bisecthosting.com/partners/custom-banners/c37f58c7-c49b-414d-b53c-1a6e1b1cff71.webp)](https://bisecthosting.com/cubegpt) ## Features -- [x] Feature 1 -- [x] Feature 2 -- [x] Feature 3 -- [ ] Feature 4 +### Core +- Automatically generate code +- Automatically fix bugs +- AI `Better Description` + +### GUI +- Creating projects +- Projects management + +## Plans and TODOs + +Moved to [Projects Tab](https://github.com/orgs/CubeGPT/projects/4). ### Other projects of CubeGPT Team -- [x] Bukkit plugin generator. {*.jar} ([BukkitGPT](https://github.com/CubeGPT/BukkitGPT)) -- [x] Structure generator. {*.schem} ([BuilderGPT](https://github.com/CubeGPT/BuilderGPT)) +- [x] Bukkit plugin generator. {*.jar} ([BukkitGPT-v3](https://github.com/CubeGPT/BukkitGPT-v3)) +- [ ] Structure generator. {*.schem} (BuilderGPT, or something?) - [ ] Serverpack generator. {*.zip} (ServerpackGPT or ServerGPT, or..?) - [ ] Have ideas or want to join our team? Send [us](mailto:admin@baimoqilin.top) 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](https://www.azul.com/downloads/), [Maven](https://maven.apache.org/), [Python 3+](https://www.python.org/). -### Plan A. Windows/Linux (executable edition) - -Nothing. Just download the executable file and run it. - -### Plan B. Python (Any operating systems; Recommend if possible) - -You can use BukkitGPT on any device with [Python 3+](https://www.python.org/). - -And you need to install the depencies with this command: +And you need to install this package: ``` -python -m pip install -U -r requirements.txt +pip install openai ``` ## Quick Start *(Make sure you have the [Python](https://www.python.org) environment installed on your computer)* -... + +### Python/UI + +1. Download `Source Code.zip` from [the release page](https://github.com/CubeGPT/BukkitGPT-v3/releases) and unzip it. +2. Edit `config.yaml`, fill in your OpenAI Apikey. If you don't know how, remember that [Google](https://www.google.com/) and [Bing](https://www.bing.com/) are always your best friends. +3. Install dependencies by running `pip install -r requirements.txt`. +4. Run `ui.py` (bash `python console.py`). +5. Enter the artifact name & description & package id as instructed to generate your plugin. +6. Copy your plugin from `projects//target/-.jar` to your server `plugins/` folder. +7. 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](https://hub.spigotmc.org/jenkins/job/BuildTools/lastSuccessfulBuild/artifact/target/BuildTools.jar), 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/`, double-click `build.bat`. You'll find your plugin in `projects//target` folder. ## Contributing -If you like the project, you can give the project a star, or [submit an issue](https://github.com/CubeGPT/CubeAgents/issues) or [pull request](https://github.com/CubeGPT/CubeAgents/pulls) to help make it better. +If you like the project, you can give the project a star, or [submit an issue](https://github.com/CubeGPT/BukkitGPT-v3/issues) or [pull request](https://github.com/CubeGPT/BukkitGPT-v3/pulls) to help make it better. ## License ```