AiGPT Harness the power of AI to execute Minecraft commands using natural language
✨ What is AiGPT? ✨
AiGPT brings the power of AI to your Minecraft server, allowing players to execute commands using natural language instead of memorizing complex command syntax. Just describe what you want to do, and AiGPT will generate the appropriate commands!
Imagine telling your server, "Give me diamond armor with protection IV" instead of typing multiple complex commands. AiGPT makes it possible!
What makes AiGPT truly powerful is that it automatically includes information about all available commands and blocks in your current Minecraft version right in the context sent to the AI. This means the plugin can generate commands that are perfectly compatible with your server version, taking advantage of all available features without you having to specify version details. The AI always knows what blocks, items, and command syntax are available to work with!
For potentially destructive commands, AiGPT will ask for confirmation:
Code (Text):
/ai do Fill this area with TNT in a 10 block radius
I can fill the area with TNT, but this could be destructive. Here are the commands that will be executed:
Code (Text):
/fill ~-5 ~-5 ~-5 ~5 ~5 ~5 tnt
To confirm this action, type /ai confirm or click the [CONFIRM] button
Code (Text):
/ai do <request> - Ask the AI to perform actions using natural language
/ai confirm - Confirm a pending operation
/ai cancel - Cancel a pending operation
/ai help - Show the help menu
/ai reload - Reload the plugin configuration (admin only)
/ai config <option> - View or change configuration settings (admin only)
Command Flags:
Code (Text):
/ai do <request> --sudo - Execute commands as console (requires permission)
/ai do <request> --confirm - Force confirmation dialogue regardless of command type
Code (Text):
aigpt.use - Allow use of the basic AI command
aigpt.sudo - Allow execution of commands as console
aigpt.bypass.cooldown - Bypass the cooldown between requests
aigpt.admin - Access to administrative commands (reload, config)
AiGPT is highly configurable through the config.yml file or in-game commands:
API Configuration:
Code (YAML):
api: # LLM Provider (currently only OpenAI supported) provider: "openai" # API Key for OpenAI key: "your-api-key-here" # Base URL for OpenAI API (leave empty to use the default) base_url: "" # Model to use model: "gpt-3.5-turbo" # Request parameters parameters:
temperature: 1
max_tokens: 1024
top_p: 1.0
# Request timeout in seconds timeout: 30
Security Settings:
Code (YAML):
security: # Command filter mode: "blacklist" (block listed commands) or "whitelist" (allow only listed commands) command_filter_mode: "blacklist" # Commands that are blocked or allowed (depending on filter mode) command_list: -
"op" -
"deop" -
"stop" -
"reload" # Commands that require confirmation before execution confirm_on_commands: -
"fill" -
"clone" -
"setblock" -
"weather" -
"time" # Always require confirmation for all actions confirm_always: false
# Execute commands as console instead of the player execute_as_console: false
# Log all requests to file log_requests: true
Performance Settings:
Code (YAML):
performance: # Cooldown between requests in seconds (per user) cooldown: 10
Interface Settings:
Code (YAML):
interface: # Prefix for plugin messages prefix: "&8[&bAiGPT&8] &7" # Language file to use language: "en"
Context Settings:
Code (YAML):
context: # Include server information in context include_server_info: true
# Include player information in context include_player_info: true
# Include available blocks in context include_blocks_info: true
# Maximum blocks to include in prompt max_blocks: 100
# Include available commands in context include_commands_info: true
# Include command descriptions in the prompt include_command_descriptions: true
AiGPT comes with built-in support for 11 languages:
English (en)
Russian (ru)
Spanish (es)
French (fr)
German (de)
Italian (it)
Portuguese (pt)
Chinese (zh)
Arabic (ar)
Hindi (hi)
Korean (ko)
Japanese (ja)
Change language with:
/ai config language <code>
Yes, you'll need to obtain an API key from OpenAI or (Infer service) to use this plugin. You can get one from the OpenAI website and add it to your config.yml file.
Yes! AiGPT works with any OpenAI-compatible API provider. You can use Cloudflare Workers AI, Together AI, or any other service that offers an OpenAI-compatible endpoint. Just set the base_url in the config to your provider's endpoint.
While AiGPT works with most LLMs, we've found excellent results with deepseek-v3-turbo. This model provides a great balance of performance and cost-effectiveness, with requests costing approximately $0.0006 each (when including all available context information). Small models won't work well.
Absolutely! AiGPT has multiple security features built-in:
- Command blacklist/whitelist system
- Confirmation for potentially destructive commands
- Permission nodes for fine-grained control
- No commands will be executed without player permission
The plugin has safeguards against abuse:
- Cooldown system to prevent spam
- Permissions required for sensitive operations
- Command filtering to prevent dangerous commands
- Logging of all requests for admin review
AiGPT works with Minecraft 1.13 and later versions. It has been extensively tested on versions 1.16, 1.17, 1.18, 1.19, and 1.20.