MineChatGPT
Communicate with ChatGPT in Minecraft
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
MineChatGPT
MineChatGPT
Chat with ChatGPT in Minecraft
All code is written by ChatGPT
Features
- OpenAI API format - Custom models - ChatGPT reverse proxy - Load balancing - Command completion - Contextual chat - Multiple characters - Folia support
Installation
1. Download the plugin and place it in the plugins folder 2. Restart the server > For better compatibility across versions, the plugin doesn't specify Bukkit API version. When loading the plugin on newer versions, you may see these warnings in console - this is normal. > ``` > [Server thread/WARN]: Initializing Legacy Material Support. Unless you have legacy plugins and/or data this is a bug! > [Server thread/WARN]: Legacy plugin MineChatGPT v1.0 does not specify an api-version. > ``` 3. Edit `config.yml`: ```yaml
======================================================
API Configuration
======================================================
api:
Your OpenAI API keys for authentication
Get API keys at https://platform.openai.com/account/api-keys
keys: - "sk-your_openai_api_key_1"
Add multiple API keys below
- "sk-your_openai_api_key_2"
- "sk-your_openai_api_key_3"
API key selection method: "round_robin" or "random"
selection_method: "round_robin"
Base URL for OpenAI API
Use proxy service if you cannot access official API
base_url: "https://api.openai.com/v1" ``` 4. Run `/chatgpt reload` in console to reload config
Commands & Permissions
| Command | Permission | Description | |-|-|-| |`/chatgpt`|minechatgpt.use|Show help| |`/chatgpt <text>`|minechatgpt.use|Ask ChatGPT| |`/chatgpt reload`|minechatgpt.reload|Reload config| |`/chatgpt model <model_name>`|minechatgpt.model|Switch model| |`/chatgpt modellist`|minechatgpt.modellist|List available models| |`/chatgpt context`|minechatgpt.context|Toggle context mode| |`/chatgpt clear`|minechatgpt.clear|Clear chat history| |`/chatgpt character [character_name]`|minechatgpt.character|List or switch character|
FAQ
Getting "Failed to contact ChatGPT." error
Check the error message in console.
Console shows "connect timeout" or "connect reset"
Verify connectivity to the `base_url` in `config.yml`. Consider using a reverse proxy if you cannot access OpenAI's official API.
Can I add other models?
Yes, any model supporting OpenAI API format works. Not recommended for inference models due to longer response times.
Can I use without ChatGPT account?
Yes, many proxy services provide access.
Folia support?
The plugin should work on Folia but isn't optimized for it. Use at your own risk.