
MineChatGPT
Communicate with ChatGPT in Minecraft
Автор: ddaodan1,4 тыс.3обновлён 13 февр. 2026 г.
Общение
Описание
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
- Download the plugin and place it in the plugins folder
- 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.
- Edit
config.yml:
# ======================================================
# 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"
- Run
/chatgpt reloadin 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.
Statistics
Последние версии
Все версии →release
MineChatGPT 2.8
2.813 февр. 2026 г.466Minecraft: 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 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.11bukkit, folia, paper, purpur, spigot
Что нового
### Highlights
- Added **rate limiting and request queueing**
Better stability under heavy usage and with multiple players online.
- Added **context token budget control**
Long conversations are trimmed safely, with optional auto-summarization.
- Added **token usage stats**
View usage with `/chatgpt stats`
Reset usage with `/chatgpt stats reset`
- Added **automatic config file update**
Missing new config entries are auto-filled after updates, while keeping your existing settings.
- Added **automatic language file update**
Missing keys in `lang/en.yml` and `lang/zh.yml` are auto-filled automatically.
### Improvements
- Better API request threading and timeout handling.
- Clearer command feedback and error messages.
- More detailed config comments for easier server admin tuning.
### Upgrade Notes
- Auto-update creates `.bak` backup files for safe rollback.
- Legacy single-key config is still supported, but `api.keys` is recommended.
**Full Changelog**: https://github.com/ddaodan-minecraft/minechatgpt/compare/2.7...2.8
release
MineChatGPT 2.7
2.717 мар. 2025 г.552Minecraft: 1.12, 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7bukkit, folia, paper, purpur, spigot
Что нового
**Important: This update has made several adjustments to the configuration file. It is recommended to back up the existing configuration file before upgrading the plugin, and then delete it to regenerate the configuration file.**
- Multi-language support
- Added bilingual comments in configuration files
- New load balancing with round-robin/random API key selection
- Optimized build configuration (reduced plugin size)
- Project standardization
Special thanks to Trae for making these features possible!
**Full Changelog**: https://github.com/ddaodan/minechatgpt/compare/2.6...2.7
release
MineChatGPT 2.6
2.627 авг. 2024 г.250Minecraft: 1.12.1, 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4bukkit, folia, paper, purpur, spigot
Что нового
**Important: This update has made several adjustments to the configuration file. It is recommended to back up the existing configuration file before upgrading the plugin, and then delete it to regenerate the configuration file.**
- Added role functionality
- Removed prompt functionality
**Full Changelog**: https://github.com/ddaodan/minechatgpt/compare/2.5...2.6
release
MineChatGPT 2.5
2.516 авг. 2024 г.137Minecraft: 1.12.2, 1.13, 1.13.1, 1.13.2, 1.14, 1.14.1, 1.14.2, 1.14.3, 1.14.4, 1.15, 1.15.1, 1.15.2, 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1bukkit, folia, paper, purpur, spigot