Skip to content

Commit

Permalink
Merge pull request #9 from Zhou-Shilin/beta-1.1-dev
Browse files Browse the repository at this point in the history
Update README.md
  • Loading branch information
Zhou-Shilin authored Sep 6, 2024
2 parents d0c264d + bd2490b commit 2449748
Showing 1 changed file with 63 additions and 24 deletions.
87 changes: 63 additions & 24 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:[email protected]) 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/<artifact_name>/target/<artifact_name>-<version>.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/<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](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
```
Expand Down

0 comments on commit 2449748

Please sign in to comment.